ChangePassword.ChangePasswordTemplate Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o ITemplate objeto usado para mostrar a vista de Alteração de Palavra-passe do ChangePassword controlo.

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 Propriedade

ITemplate

Um ITemplate objeto que contém o modelo para mostrar o ChangePassword controlo na vista de Alterar Palavra-passe. A predefinição é null.

Atributos
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

Observações

A ChangePasswordTemplate propriedade especifica o ITemplate objeto usado pelo ChangePassword controlo. Para mais informações, veja Como Criar: Criar Modelos de Controlo de Servidores Web ASP.NET Dinamicamente.

Um modelo é um conjunto de elementos HTML e controlos que compõem o layout de uma determinada parte de um controlo. Os modelos diferem dos estilos:

  • Os templates definem o conteúdo de uma secção de um controlo.

  • Os estilos especificam a aparência dos elementos no controlo.

Para mais informações, consulte Modelos de Controlo de Servidor Web e ASP.NET Temas e Skins.

A tabela seguinte lista os modelos e a respetiva vista de controlo suportados pelo ChangePassword controlo.

Nome do modelo Vista de controlo
ChangePasswordTemplate Alterar Palavra-passe
SuccessTemplate Sucesso

Também pode criar ou modificar o modelo de um controlo no seu ficheiro .aspx. Para mais informações, consulte Como: Criar Modelos de Controlo Web ASP.NET Declarativamente e Como: Criar Modelos de Controlo de Servidores Web ASP.NET Dinamicamente. Os procedimentos nesses tópicos não exigem que configure a propriedade ChangePasswordTemplate . Se configurar o modelo, a tabela seguinte lista os controlos necessários e opcionais para o modelo.

ID de controlo Tipo de controlo Required/optional
Cancel Qualquer controlo que cause o bubbling de eventos (passando o evento para cima na hierarquia de controlo do servidor), como o Button, LinkButton, e ImageButton controlos. O nome do comando do botão deve ser definido como o ID de controlo. Opcional
ChangePassword Qualquer controlo que cause o bubbling de eventos (passando o evento para cima na hierarquia de controlo do servidor), como o Button, LinkButton, e ImageButton controlos. O nome do comando do botão deve ser definido como o ID de controlo. Opcional
ConfirmNewPassword Qualquer tipo que suporte a IEditableTextControl interface, como a TextBox classe. Opcional
Continue Qualquer controlo que cause o bubbling de eventos (passando o evento para cima na hierarquia de controlo do servidor), como o Button, LinkButton, e ImageButton controlos. O nome do comando do botão deve ser definido como o ID de controlo. Este controlo aparece no modelo Sucesso. Opcional
CurrentPassword Qualquer tipo que suporte a IEditableTextControl interface, como a TextBox classe. Obrigatório
FailureText Qualquer tipo que suporte a interface ITextControl . Opcional
NewPassword Qualquer tipo que suporte a IEditableTextControl interface, como a TextBox classe. Obrigatório
UserName Qualquer tipo que suporte a interface IEditableTextControl . Obrigatório se DisplayUserName for true. Deve estar ausente se DisplayUserName for false.

O ChangePassword controlo lança uma HttpException exceção se o template não contiver os controlos necessários. Não há exceção se deres um ID de controlo opcional a um controlo do tipo errado; no entanto, o controlo é subsequentemente ignorado pelo controlo ChangePassword .

Aplica-se a

Ver também