共用方式為

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 忽略控制項。

適用於

另請參閱