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 ITemplate vom ChangePassword -Steuerelement verwendete Objekt an. Weitere Informationen finden Sie unter Vorgehensweise: Dynamisches Erstellen ASP.NET Webserversteuerelementvorlagen.

Eine Vorlage ist eine Gruppe 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 die Vorlage für ein Steuerelement auch in Ihrer .aspx-Datei erstellen oder ändern. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen ASP.NET Websteuerelementvorlagen deklarativ und Vorgehensweise: Dynamisches Erstellen ASP.NET Webserversteuerelementvorlagen. Für die Prozeduren in diesen Themen müssen Sie die ChangePasswordTemplate Eigenschaft nicht 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 zu Ereignisbubbling führt (das Ereignis in der Serversteuerelementhierarchie übergibt), z. B. die ButtonSteuerelemente , LinkButtonund ImageButton . Der Name des Schaltflächenbefehls muss auf die Steuerelement-ID festgelegt werden. Optional
ChangePassword Jedes Steuerelement, das zu Ereignisbubbling führt (das Ereignis in der Serversteuerelementhierarchie übergibt), 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 zu Ereignisbubbling führt (das Ereignis in der Serversteuerelementhierarchie übergibt), 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 DisplayUserNametrue ist. 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