Gets or sets the System.Web.UI.ITemplate object used to display the Change Password view of the System.Web.UI.WebControls.ChangePassword control.
Syntax
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ITemplate ChangePasswordTemplate { set; get; }
Value
Documentation for this section has not yet been entered.
Remarks
The ChangePassword.ChangePasswordTemplate property specifies the System.Web.UI.ITemplate object used by the System.Web.UI.WebControls.ChangePassword control. For more information, see Creating Web Server Control Templates Dynamically.
A template is a set of HTML elements and controls that make up the layout for a particular portion of a control. Templates differ from styles:
Templates define the content of a section of a control.
Styles specify the appearance of elements in the control.
For more information, see ASP.NET Web Server Controls Templates and Introduction to ASP.NET Themes.
The following table lists the templates and the corresponding control view that are supported by the System.Web.UI.WebControls.ChangePassword control.
| ChangePassword.ChangePasswordTemplate |
Change Password |
| ChangePassword.SuccessTemplate |
Success |
You can also create or modify the template for a control in your .aspx file. For more information, see How to: Create Web Server Control Templates Using ASP.NET Syntax and Creating Web Server Control Templates Dynamically. The procedures in those topics do not require you to configure the ChangePassword.ChangePasswordTemplate property. If you do configure the template, the following table lists the required and optional controls for the template.
| Cancel |
Any control that causes event bubbling (passing the event up the server control hierarchy), such as the System.Web.UI.WebControls.Button, System.Web.UI.WebControls.LinkButton, and System.Web.UI.WebControls.ImageButton controls. The button command name must be set to the control ID. |
Optional |
| ChangePassword |
Any control that causes event bubbling (passing the event up the server control hierarchy), such as the System.Web.UI.WebControls.Button, System.Web.UI.WebControls.LinkButton, and System.Web.UI.WebControls.ImageButton controls. The button command name must be set to the control ID. |
Optional |
| ConfirmNewPassword |
Any type that supports the System.Web.UI.IEditableTextControl interface, such as the System.Web.UI.WebControls.TextBox class. |
Optional |
| Continue |
Any control that causes event bubbling (passing the event up the server control hierarchy), such as the System.Web.UI.WebControls.Button, System.Web.UI.WebControls.LinkButton, and System.Web.UI.WebControls.ImageButton controls. The button command name must be set to the control ID. This control appears on the Success template. |
Optional |
| CurrentPassword |
Any type that supports the System.Web.UI.IEditableTextControl interface, such as the System.Web.UI.WebControls.TextBox class. |
Required |
| FailureText |
Any type that supports the System.Web.UI.ITextControl interface. |
Optional |
| NewPassword |
Any type that supports the System.Web.UI.IEditableTextControl interface, such as the System.Web.UI.WebControls.TextBox class. |
Required |
| UserName |
Any type that supports the System.Web.UI.IEditableTextControl interface. |
Required if ChangePassword.DisplayUserName is true. Must be absent if ChangePassword.DisplayUserName is false. |
The System.Web.UI.WebControls.ChangePassword control throws an System.Web.HttpException exception if the template does not contain the required controls. No exception is thrown if you give an optional control ID to a control of the wrong type; however, the control is subsequently ignored by the System.Web.UI.WebControls.ChangePassword control.
Requirements
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0