ChangePassword.ChangePasswordTemplate Eigenschaft

Definition

Ruft das ITemplate-Objekt ab bzw. legt dieses fest, das zum Anzeigen der Ansicht Kennwort ändern des ChangePassword-Steuerelements verwendet wird.

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

Eigenschaftswert

Ein ITemplate-Objekt, das die Vorlage für die Anzeige des ChangePassword-Steuerelements in der Ansicht Kennwort ändern enthält. Der Standardwert ist null.

Attribute

Hinweise

Die ChangePasswordTemplate -Eigenschaft gibt das objekt an, ITemplate das ChangePassword vom Steuerelement verwendet wird. Weitere Informationen finden Sie unter Vorgehensweise: Dynamisches Erstellen ASP.NET Webserversteuerelementvorlagen.

Eine Vorlage ist ein Satz von HTML-Elementen und -Steuerelementen, die das Layout für einen bestimmten Teil eines Steuerelements bilden. Vorlagen unterscheiden sich von Stilen:

  • Vorlagen definieren den Inhalt eines Abschnitts eines Steuerelements.

  • Stile geben die Darstellung von Elementen im Steuerelement an.

Weitere Informationen finden Sie unter Vorlagen für Webserversteuerelemente und ASP.NET Designs und Skins.

In der folgenden Tabelle sind die Vorlagen und die entsprechende Steuerelementansicht aufgeführt, die ChangePassword vom Steuerelement unterstützt werden.

Vorlagenname Steuerelementansicht
ChangePasswordTemplate Ändern des Kennworts
SuccessTemplate Erfolg

Sie können auch die Vorlage für ein Steuerelement in Ihrer ASPX-Datei erstellen oder ändern. Weitere Informationen finden Sie unter Vorgehensweise: Deklaratives Erstellen ASP.NET Websteuerelementvorlagen und Vorgehensweise: Dynamisches Erstellen ASP.NET Webserversteuerelementvorlagen. Die Prozeduren in diesen Themen erfordern nicht, dass Sie die ChangePasswordTemplate -Eigenschaft konfigurieren. Wenn Sie die Vorlage konfigurieren, werden in der folgenden Tabelle die erforderlichen und optionalen Steuerelemente für die Vorlage aufgeführt.

Steuerungs-ID Steuerelementtyp Erforderlich/optional
Cancel Jedes Steuerelement, das das Bubbling von Ereignissen verursacht (das Ereignis wird in der Serversteuerungshierarchie übergeben), z. B. die ButtonSteuerelemente , LinkButtonund ImageButton . Der Name des Schaltflächenbefehls muss auf die Steuerelement-ID festgelegt werden. Optional
ChangePassword Jedes Steuerelement, das das Bubbling von Ereignissen verursacht (das Ereignis wird in der Serversteuerungshierarchie übergeben), z. B. die ButtonSteuerelemente , LinkButtonund ImageButton . Der Name des Schaltflächenbefehls muss auf die Steuerelement-ID festgelegt werden. Optional
ConfirmNewPassword Jeder Typ, der die IEditableTextControl -Schnittstelle unterstützt, z. B. die TextBox -Klasse. Optional
Continue Jedes Steuerelement, das das Bubbling von Ereignissen verursacht (das Ereignis wird in der Serversteuerungshierarchie übergeben), z. B. die ButtonSteuerelemente , LinkButtonund ImageButton . Der Name des Schaltflächenbefehls muss auf die Steuerelement-ID festgelegt werden. Dieses Steuerelement wird in der Vorlage Erfolg angezeigt. Optional
CurrentPassword Jeder Typ, der die IEditableTextControl -Schnittstelle unterstützt, z. B. die TextBox -Klasse. Erforderlich
FailureText Jeder Typ, der die ITextControl -Schnittstelle unterstützt. Optional
NewPassword Jeder Typ, der die IEditableTextControl -Schnittstelle unterstützt, z. B. die TextBox -Klasse. Erforderlich
UserName Jeder Typ, der die IEditableTextControl -Schnittstelle unterstützt. Erforderlich, wenn DisplayUserName ist true. Muss nicht vorhanden sein, wenn DisplayUserName ist false.

Das ChangePassword Steuerelement löst eine Ausnahme aus HttpException , wenn die Vorlage nicht die erforderlichen Steuerelemente enthält. Es wird keine Ausnahme ausgelöst, wenn Sie einem Steuerelement des falschen Typs eine optionale Steuerelement-ID zuordnen. Das Steuerelement wird jedoch anschließend vom ChangePassword -Steuerelement ignoriert.

Gilt für:

Weitere Informationen