ChangePassword.ChangePasswordTemplate 属性

定义

获取或设置用于显示 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 对象,其中包含用于在“更改密码”视图中显示 ChangePassword 控件的模板。 默认值为 null

属性

注解

属性 ChangePasswordTemplate 指定 ITemplate 控件使用 ChangePassword 的对象。 有关详细信息,请参阅 如何:动态创建 ASP.NET Web 服务器控件模板

模板是一组 HTML 元素和控件,这些元素和控件构成控件的特定部分的布局。 模板不同于样式:

  • 模板定义控件的节的内容。

  • 样式指定控件中元素的外观。

有关详细信息,请参阅 Web 服务器控件模板ASP.NET 主题和外观

下表列出了控件支持的 ChangePassword 模板和相应的控件视图。

模板名称 控件视图
ChangePasswordTemplate 更改密码
SuccessTemplate Success

还可以在 .aspx 文件中为控件创建或修改模板。 有关详细信息,请参阅 如何:以声明方式创建 ASP.NET Web 控件模板如何:动态创建 ASP.NET Web 服务器控件模板。 这些主题中的过程不需要配置 ChangePasswordTemplate 属性。 如果确实配置了模板,下表列出了模板的必需控件和可选控件。

控制 ID 控件类型 必需/可选
Cancel 导致事件浮升的任何控件 (将事件向上传递到服务器控件层次结构) ,例如 ButtonLinkButtonImageButton 控件。 按钮命令名称必须设置为控件 ID。 可选
ChangePassword 导致事件浮升的任何控件 (将事件向上传递到服务器控件层次结构) ,例如 ButtonLinkButtonImageButton 控件。 按钮命令名称必须设置为控件 ID。 可选
ConfirmNewPassword 支持 接口的任何类型, IEditableTextControl 例如 TextBox 类。 可选
Continue 导致事件浮升的任何控件 (将事件向上传递到服务器控件层次结构) ,例如 ButtonLinkButtonImageButton 控件。 按钮命令名称必须设置为控件 ID。 此控件显示在“成功”模板上。 可选
CurrentPassword 支持 接口的任何类型, IEditableTextControl 例如 TextBox 类。 必需
FailureText 支持 接口的任何 ITextControl 类型。 可选
NewPassword 支持 接口的任何类型, IEditableTextControl 例如 TextBox 类。 必需
UserName 支持 接口的任何 IEditableTextControl 类型。 如果 DisplayUserNametrue,则是必需的。 如果 DisplayUserName 为 , false则必须不存在。

如果模板不包含所需的控件,控件 ChangePasswordHttpException 引发异常。 如果将可选控件 ID 提供给错误类型的控件,则不会引发异常;但是,控件随后会忽略该 ChangePassword 控件。

适用于

另请参阅