Share via

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 元素和控件，构成控件特定部分的布局。 模板不同于样式：

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

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

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

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

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

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

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

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

适用于

另请参阅