Export (0) Print
Expand All
Expand Minimize

ChangePassword.ChangePasswordTemplate Property

Gets or sets the ITemplate object used to display the Change Password view of the ChangePassword control.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[BrowsableAttribute(false)]
[TemplateContainerAttribute(typeof(ChangePassword))]
public virtual ITemplate ChangePasswordTemplate { get; set; }
<asp:ChangePassword>
	<ChangePasswordTemplate>ITemplate</ChangePasswordTemplate>
</asp:ChangePassword>

Property Value

Type: System.Web.UI.ITemplate
An ITemplate object that contains the template for displaying the ChangePassword control in the Change Password view. The default is null.

The ChangePasswordTemplate property specifies the ITemplate object used by the ChangePassword control. For more information, see How To: Create ASP.NET 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 ASP.NET Themes and Skins.

The following table lists the templates and the corresponding control view that are supported by the ChangePassword control.

Template name

Control view

ChangePasswordTemplate

Change Password

SuccessTemplate

Success

You can also create or modify the template for a control in your .aspx file. For more information, see How to: Create ASP.NET Web Control Templates Declaratively and How To: Create ASP.NET Web Server Control Templates Dynamically. The procedures in those topics do not require you to configure the ChangePasswordTemplate property. If you do configure the template, the following table lists the required and optional controls for the template.

Control ID

Control type

Required/optional

Cancel

Any control that causes event bubbling (passing the event up the server control hierarchy), such as the Button, LinkButton, and 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 Button, LinkButton, and ImageButton controls. The button command name must be set to the control ID.

Optional

ConfirmNewPassword

Any type that supports the IEditableTextControl interface, such as the TextBox class.

Optional

Continue

Any control that causes event bubbling (passing the event up the server control hierarchy), such as the Button, LinkButton, and 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 IEditableTextControl interface, such as the TextBox class.

Required

FailureText

Any type that supports the ITextControl interface.

Optional

NewPassword

Any type that supports the IEditableTextControl interface, such as the TextBox class.

Required

UserName

Any type that supports the IEditableTextControl interface.

Required if DisplayUserName is true. Must be absent if DisplayUserName is false.

The ChangePassword control throws an 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 ChangePassword control.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft