ChangePassword.ChangePasswordTemplate Свойство

Определение

Возвращает или задает объект ITemplate, который используется для отображения представления "Смена пароля" элемента управления ChangePassword.Gets or sets the ITemplate object used to display the Change Password view of the ChangePassword control.

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; }
member this.ChangePasswordTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property ChangePasswordTemplate As ITemplate

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

Объект ITemplate, содержащий шаблон для отображения элемента управления ChangePassword в представлении "Смена пароля".An ITemplate object that contains the template for displaying the ChangePassword control in the Change Password view. Значение по умолчанию: null.The default is null.

Атрибуты

Комментарии

Свойство ChangePasswordTemplate указывает объект ITemplate, используемый элементом управления ChangePassword.The ChangePasswordTemplate property specifies the ITemplate object used by the ChangePassword control. Дополнительные сведения см. в разделе как динамически создавать шаблоны элементов управления веб-сервера ASP.NET.For more information, see How To: Create ASP.NET Web Server Control Templates Dynamically.

Шаблон — это набор элементов HTML и элементов управления, образующих макет для определенной части элемента управления.A template is a set of HTML elements and controls that make up the layout for a particular portion of a control. Шаблоны отличаются от стилей:Templates differ from styles:

  • Шаблоны определяют содержимое раздела элемента управления.Templates define the content of a section of a control.

  • Стили определяют внешний вид элементов в элементе управления.Styles specify the appearance of elements in the control.

Дополнительные сведения см. в разделе шаблоны элементов управления веб-сервера и темы ASP.NET и обложки.For more information, see Web Server Controls Templates and ASP.NET Themes and Skins.

В следующей таблице перечислены шаблоны и соответствующие представления элементов управления, поддерживаемые элементом управления ChangePassword.The following table lists the templates and the corresponding control view that are supported by the ChangePassword control.

Имя шаблонаTemplate name Представление элемента управленияControl view
ChangePasswordTemplate Изменить парольChange Password
SuccessTemplate ВыполненоSuccess

Также можно создать или изменить шаблон для элемента управления в файле. aspx.You can also create or modify the template for a control in your .aspx file. Дополнительные сведения см. в статьях как декларативно создавать шаблоны веб-элементов управления ASP.NET и как создавать шаблоны серверных веб-элементов управления ASP.NET динамически.For more information, see How to: Create ASP.NET Web Control Templates Declaratively and How To: Create ASP.NET Web Server Control Templates Dynamically. В процедурах, описанных в этих разделах, не требуется настраивать свойство ChangePasswordTemplate.The procedures in those topics do not require you to configure the ChangePasswordTemplate property. Если вы настраиваете шаблон, в следующей таблице перечислены обязательные и необязательные элементы управления для шаблона.If you do configure the template, the following table lists the required and optional controls for the template.

Идентификатор элемента управленияControl ID Тип элемента управленияControl type Обязательный или необязательныйRequired/optional
Cancel Любой элемент управления, вызывающий восходящую маршрутизацию событий (передавая событие вверх по иерархии серверных элементов управления), например Button, LinkButtonи элементы управления ImageButton.Any control that causes event bubbling (passing the event up the server control hierarchy), such as the Button, LinkButton, and ImageButton controls. Имя команды кнопки должно быть равно ИДЕНТИФИКАТОРу элемента управления.The button command name must be set to the control ID. НеобязательноOptional
ChangePassword Любой элемент управления, вызывающий восходящую маршрутизацию событий (передавая событие вверх по иерархии серверных элементов управления), например Button, LinkButtonи элементы управления ImageButton.Any control that causes event bubbling (passing the event up the server control hierarchy), such as the Button, LinkButton, and ImageButton controls. Имя команды кнопки должно быть равно ИДЕНТИФИКАТОРу элемента управления.The button command name must be set to the control ID. НеобязательноOptional
ConfirmNewPassword Любой тип, поддерживающий интерфейс IEditableTextControl, например класс TextBox.Any type that supports the IEditableTextControl interface, such as the TextBox class. НеобязательноOptional
Continue Любой элемент управления, вызывающий восходящую маршрутизацию событий (передавая событие вверх по иерархии серверных элементов управления), например Button, LinkButtonи элементы управления ImageButton.Any control that causes event bubbling (passing the event up the server control hierarchy), such as the Button, LinkButton, and ImageButton controls. Имя команды кнопки должно быть равно ИДЕНТИФИКАТОРу элемента управления.The button command name must be set to the control ID. Этот элемент управления отображается в шаблоне успешного выполнения.This control appears on the Success template. НеобязательноOptional
CurrentPassword Любой тип, поддерживающий интерфейс IEditableTextControl, например класс TextBox.Any type that supports the IEditableTextControl interface, such as the TextBox class. ОбязательноRequired
FailureText Любой тип, поддерживающий интерфейс ITextControl.Any type that supports the ITextControl interface. НеобязательноOptional
NewPassword Любой тип, поддерживающий интерфейс IEditableTextControl, например класс TextBox.Any type that supports the IEditableTextControl interface, such as the TextBox class. ОбязательноRequired
UserName Любой тип, поддерживающий интерфейс IEditableTextControl.Any type that supports the IEditableTextControl interface. Требуется, если DisplayUserName true.Required if DisplayUserName is true. Должен отсутствовать, если DisplayUserName false.Must be absent if DisplayUserName is false.

Элемент управления ChangePassword создает исключение HttpException, если шаблон не содержит обязательных элементов управления.The ChangePassword control throws an HttpException exception if the template does not contain the required controls. Исключение не возникает, если идентификатор необязательного элемента управления присваивается элементу управления неправильного типа; Однако элемент управления в дальнейшем игнорируется элементом управления ChangePassword.No exception is thrown if you give an optional control ID to a control of the wrong type; however, the control is subsequently ignored by the ChangePassword control.

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

Дополнительно