ChangePassword.ChangePasswordTemplate Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает объект, используемый ITemplate для отображения представления ChangePassword "Изменить пароль" элемента управления.

public:
 virtual property System::Web::UI::ITemplate ^ ChangePasswordTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ChangePassword))]
public virtual System.Web.UI.ITemplate ChangePasswordTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ChangePassword))>]
member this.ChangePasswordTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property ChangePasswordTemplate As ITemplate

Значение свойства

ITemplate

Объект ITemplate , содержащий шаблон для отображения ChangePassword элемента управления в представлении "Изменить пароль". Значение по умолчанию — null.

Атрибуты
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

Комментарии

Свойство ChangePasswordTemplate задает объект, используемый ITemplate элементом ChangePassword управления. Дополнительные сведения см. в статье "Практическое руководство. Создание динамически ASP.NET шаблонов управления веб-серверами".

Шаблон — это набор элементов HTML и элементов управления, составляющих макет для определенной части элемента управления. Шаблоны отличаются от стилей:

  • Шаблоны определяют содержимое раздела элемента управления.

  • Стили указывают внешний вид элементов в элементе управления.

Дополнительные сведения см. в разделе "Шаблоны веб-серверных элементов управления " и ASP.NET темы и кожи.

В следующей таблице перечислены шаблоны и соответствующее представление элемента управления, поддерживаемые элементом ChangePassword управления.

Имя шаблона Просмотр элемента управления
ChangePasswordTemplate Изменить пароль
SuccessTemplate Success

Вы также можете создать или изменить шаблон для элемента управления в файле .aspx. Дополнительные сведения см. в статье "Практическое руководство. Создание шаблонов веб-элементов управления ASP.NET декларативно и практическое руководство. Создание динамических шаблоновуправления веб-серверами ASP.NET". Процедуры, описанные в этих разделах, не требуют настройки ChangePasswordTemplate свойства. Если вы настроите шаблон, в следующей таблице перечислены необходимые и необязательные элементы управления для шаблона.

Идентификатор элемента управления Тип элемента управления Обязательный/необязательный
Cancel Любой элемент управления, вызывающий бубение событий (передача события в иерархию элементов управления сервера), таких как Button, LinkButtonи ImageButton элементы управления. Имя команды кнопки должно иметь идентификатор элемента управления. Необязательно
ChangePassword Любой элемент управления, вызывающий бубение событий (передача события в иерархию элементов управления сервера), таких как Button, LinkButtonи ImageButton элементы управления. Имя команды кнопки должно иметь идентификатор элемента управления. Необязательно
ConfirmNewPassword Любой IEditableTextControl тип, поддерживающий интерфейс, например TextBox класс. Необязательно
Continue Любой элемент управления, вызывающий бубение событий (передача события в иерархию элементов управления сервера), таких как Button, LinkButtonи ImageButton элементы управления. Имя команды кнопки должно иметь идентификатор элемента управления. Этот элемент управления отображается в шаблоне success. Необязательно
CurrentPassword Любой IEditableTextControl тип, поддерживающий интерфейс, например TextBox класс. Обязательный
FailureText Любой ITextControl тип, поддерживающий интерфейс. Необязательно
NewPassword Любой IEditableTextControl тип, поддерживающий интерфейс, например TextBox класс. Обязательный
UserName Любой IEditableTextControl тип, поддерживающий интерфейс. Обязательный параметр, если DisplayUserName имеет значение true. Должен быть отсутствует, если DisplayUserName имеет значение false.

Элемент ChangePassword управления создает исключение, HttpException если шаблон не содержит необходимые элементы управления. Исключение не возникает, если вы предоставляете необязательный идентификатор элемента управления для элемента управления неправильным типом; однако элемент управления впоследствии игнорируется элементом ChangePassword управления.

Применяется к

См. также раздел