ChangePassword.ChangePasswordTemplate Propiedad

Definición

Obtiene o establece el objeto ITemplate que se utiliza para mostrar la vista Cambiar contraseña del control 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

Valor de propiedad

Objeto ITemplate que contiene la plantilla para mostrar el control ChangePassword en la vista Cambiar contraseña. De manera predeterminada, es null.

Atributos

Comentarios

La ChangePasswordTemplate propiedad especifica el ITemplate objeto utilizado por el ChangePassword control . Para obtener más información, vea How To: Create ASP.NET Web Server Control Templates Dynamically.

Una plantilla es un conjunto de elementos y controles HTML que componen el diseño de una parte determinada de un control. Las plantillas difieren de los estilos:

  • Las plantillas definen el contenido de una sección de un control.

  • Los estilos especifican la apariencia de los elementos en el control .

Para obtener más información, vea Plantillas de controles de servidor web y temas y máscaras de ASP.NET.

En la tabla siguiente se enumeran las plantillas y la vista de control correspondiente que admite el ChangePassword control.

Nombre de plantilla Vista de control
ChangePasswordTemplate Cambio de contraseñas
SuccessTemplate Correcto

También puede crear o modificar la plantilla para un control en el archivo .aspx. Para obtener más información, vea How to: Create ASP.NET Web Control Templates declaratively and How To: Create ASP.NET Web Server Control Templates Dynamically. Los procedimientos de esos temas no requieren que configure la ChangePasswordTemplate propiedad . Si configura la plantilla, en la tabla siguiente se enumeran los controles obligatorios y opcionales de la plantilla.

Id. de control Tipo de control Obligatorio/opcional
Cancel Cualquier control que provoque la propagación de eventos (pasando el evento a la jerarquía de controles de servidor), como los Buttoncontroles , LinkButtony ImageButton . El nombre del comando del botón debe establecerse en el identificador de control. Opcionales
ChangePassword Cualquier control que provoque la propagación de eventos (pasando el evento a la jerarquía de controles de servidor), como los Buttoncontroles , LinkButtony ImageButton . El nombre del comando del botón debe establecerse en el identificador de control. Opcionales
ConfirmNewPassword Cualquier tipo que admita la IEditableTextControl interfaz, como la TextBox clase . Opcionales
Continue Cualquier control que provoque la propagación de eventos (pasando el evento a la jerarquía de controles de servidor), como los Buttoncontroles , LinkButtony ImageButton . El nombre del comando del botón debe establecerse en el identificador de control. Este control aparece en la plantilla Correcto. Opcionales
CurrentPassword Cualquier tipo que admita la IEditableTextControl interfaz, como la TextBox clase . Requerido
FailureText Cualquier tipo que admita la ITextControl interfaz. Opcionales
NewPassword Cualquier tipo que admita la IEditableTextControl interfaz, como la TextBox clase . Requerido
UserName Cualquier tipo que admita la IEditableTextControl interfaz. Obligatorio si DisplayUserName es true. Debe estar ausente si DisplayUserName es false.

El ChangePassword control produce una HttpException excepción si la plantilla no contiene los controles necesarios. No se produce ninguna excepción si se proporciona un identificador de control opcional a un control del tipo incorrecto; sin embargo, el ChangePassword control lo omite posteriormente.

Se aplica a

Consulte también