共用方式為

ChangePassword.ChangePasswordTemplate 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定用來顯示 ITemplate 控制項之 [變更密碼] 檢視的 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

屬性值

ITemplate

ITemplate 物件，包含用來在 [變更密碼] 檢視中顯示 ChangePassword 控制項的樣板。 預設為 null。

屬性
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

備註

屬性 ChangePasswordTemplate 會 ITemplate 指定控制項所使用的 ChangePassword 物件。 如需詳細資訊，請參閱 如何：動態建立 ASP.NET Web 伺服器控件範本。

範本是一組 HTML 元素和控件，組成控件特定部分的配置。 範本與樣式不同：

  • 範本會定義 控件區段的內容。

  • 樣式會指定 控制項中的項目外觀。

如需詳細資訊，請參閱 網頁伺服器控件範本 和 ASP.NET 主題和外觀。

下表列出控件支援的 ChangePassword 範本和對應的控件檢視。

範本名稱 控制項檢視
ChangePasswordTemplate 變更密碼
SuccessTemplate Success

您也可以在.aspx檔案中建立或修改控件的範本。 如需詳細資訊，請參閱 如何：以宣告方式建立 ASP.NET Web控件範本 和 如何：動態建立 ASP.NET 網頁伺服器控件範本。 這些主題中的程式不需要您設定 ChangePasswordTemplate 屬性。 如果您設定範本，下表列出範本的必要和選擇性控件。

控制識別碼 控制項類型 必要條件/選擇性
Cancel 造成事件反升的任何控件 (將事件向上傳遞伺服器控件階層) ，例如 Button、 LinkButton和 ImageButton 控制項。 按鈕命令名稱必須設定為控件識別碼。 選擇性
ChangePassword 造成事件反升的任何控件 (將事件向上傳遞伺服器控件階層) ，例如 Button、 LinkButton和 ImageButton 控制項。 按鈕命令名稱必須設定為控件識別碼。 選擇性
ConfirmNewPassword 任何支援 IEditableTextControl 介面的類型，例如 TextBox 類別。 選擇性
Continue 造成事件反升的任何控件 (將事件向上傳遞伺服器控件階層) ，例如 Button、 LinkButton和 ImageButton 控制項。 按鈕命令名稱必須設定為控件識別碼。 此控件會出現在 [成功] 範本上。 選擇性
CurrentPassword 任何支援 IEditableTextControl 介面的類型，例如 TextBox 類別。 必要
FailureText 任何支援介面的類型 ITextControl 。 選擇性
NewPassword 任何支援 IEditableTextControl 介面的類型，例如 TextBox 類別。 必要
UserName 任何支援介面的類型 IEditableTextControl 。 如果 DisplayUserName 為 true，則為必要項。 如果 DisplayUserName 為 false，則必須不存在。

如果範本不包含必要的控件，控件 ChangePassword 會擲回 HttpException 例外狀況。 如果您為錯誤類型的控件提供選擇性控件標識符，則不會擲回例外狀況;不過，控件後續會 ChangePassword 忽略控件。

適用於

另請參閱