System.Web
2.0.0.0
System.Web.UI.WebControls.CompositeControl
In this topic:
-
Introduction
-
Sending E-mail Messages
-
Views
-
Styles and Templates
-
Validation Groupings
-
Access Keys and Tab Indexes
-
Accessibility
-
Accessing Controls During Page_Load and Page_Init
-
Applying CSS Styles
-
Declarative Syntax#
Introduction
Use the control on a page to enable your Web site users to change the passwords they use to log on to your Web site.
If you are not familiar with the set of login controls available in ASP.NET, read ASP.NET Login Controls Overview before continuing. For a list of other topics related to login controls and membership, see Managing Users By Using Membership.
Transmitting passwords over HTTP is a potential security threat. HTTP transmissions can be viewed or compromised by malicious users. To improve security when using login controls, you should use HTTPS protocol with secure sockets layer (SSL) encryption to ensure that the user's password cannot be read during postback. For more information, see Securing Login Controls.
The control uses the membership provider defined in the property to change the password stored in the membership provider data store for the Web site. If you do not assign a membership provider, the control uses the default membership provider defined in the membership section of the Web.config file. The control enables users to perform the following actions:
-
Change their password if they are logged on.
-
Change their password if they are not logged on, as long as the page that contains the control allows anonymous access and the property is true.
-
Change the password for a user account, even if they are logged on as a different user. This requires the property to be true.
Setting the property to true displays the User Name text box, which allows the user to type in a user name. If the user is logged on, the control is populated with the name of the logged-on user. After the password for the given user name is changed, the user is logged on to the account associated with the changed password, even if the user was not logged on to that account previously.
Accepting user input is a potential security threat. Malicious users can send data that is intended to expose vulnerabilities or run programs that try generated passwords. To improve security when working with user input, you should use the validation features of your control and secure any data providers that are configured for your control. For more information, see Securing Login Controls, Basic Security Practices for Web Applications, and Securing Membership.
Sending E-mail Messages
The control can be configured to use e-mail services to send the new password to the user. To send e-mail messages to users from any of ASP.NET Web server controls, you must configure an e-mail server in the Web.config file for your application. For more information, see How to: Configure an SMTP Virtual Server.
E-mail messages are configured using the class. You must set the property to instruct ASP.NET to send e-mail.
Sending user account names or passwords in e-mail is a potential security threat. E-mail messages are typically sent in plain text and can be read by special network "sniffing" applications. To improve security, use the mitigations that are described in Securing Login Controls.
It is not possible to guarantee that a user will receive or view an e-mail message. To verify that a user has received a message, provide a confirmation link in the e-mail message that lets the user confirm that the notification was received.
Views
The control has two states, or views:
-
Change Password view Requests the current password, and requires the user to type the new password twice for confirmation. If you allow users who are not logged on to change their passwords, set the property to true to display the control in Change Password view. The control allows the user to provide their registered user name. If there is an error when changing the password, an error message is displayed in the Change Password view, allowing the user to try again.
-
Success view Provides confirmation that the password has been changed.
The functionality for changing passwords and for continue and cancel is attached to any button that has the correct command name, regardless of which view the button is placed on. For example, a button with the value commandname=changepassword in the Success view will attempt to change the password and result in an exception.
Styles and Templates
You can use an extensive set of style properties to customize the appearance of the control. Alternatively, you can apply custom templates to the two views if you need complete control over the appearance of the control. If you define a template for a view, the properties are applied. For a list of the controls that you must set in the view templates, see the and properties. The control examines the content in the template and throws an exception if a required control is not found, is not named correctly, or is of the wrong type. For example, if you use the content in the template and set the property to true, the will throw an exception if a or some other control is not found for the user name.
The following table lists the control style properties and describes which UI element they affect. For a list of the properties to which each style applies, see the individual style property.
-
style property
UI element
-
Cancel button on the Change Password view.
-
Change Password button on the Change Password view.
-
Continue button on the Success view.
-
Error text displayed to the user.
-
Hyperlinks to other pages.
-
Instructional text on the page that describes how to use the control.
-
Labels for all input fields, such as text boxes.
-
Hints for providing an acceptable password for the Web site.
-
Text displayed to the user when the password has been successfully changed.
-
Text entry input fields.
-
Titles for the Change Password and Success views.
Applying CSS Styles
The control lets you specify CSS style rules in markup. If you use templates to customize the appearance of the control, you can specify CSS styles in the markup in the templates. In that case, no extra outer table is required. You can prevent the table from being rendered by setting the property to false.
Validation Groupings
The control uses a validation group so that other fields on the same page as the control can be validated separately. By default, the property of the control is used as the name of the validation group. For example, a control with the ID "ChangePassword1" will use a validation group name of ChangePassword1 as well. To set the validation group that the control is part of, you must create a template with the control, and then change the validation group name.
To show error messages if a user leaves a control empty, add a control to the page. Set the property of the control to the property of the control.
Access Keys and Tab Indexes
For information about how to use the property and the property of a control, see ASP.NET 4 and ASP.NET Controls and Accessibility.
Accessibility
For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio 2010 and ASP.NET 4 and ASP.NET Controls and Accessibility.
Accessing Controls During Page_Load and Page_Init
control properties represented by text boxes, such as and , are accessible during all phases of the page life cycle. In particular, during the Page_Init and Page_Load phases, these properties have the same value they had when the control was rendered. If the user changes the value of the property by modifying the text box, the new value will be available when the changed event is raised, which occurs after the Page_Load phase. Therefore, if you set the value of the property in the Page_Init phase or Page_Load phase and provide a custom handler for a event, any change that the user makes in the text box overrides the value set in the Page_Init or Page_Load phase.
Declarative Syntax
<asp:ChangePassword
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderPadding="integer"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CancelButtonImageUrl="uri"
CancelButtonText="string"
CancelButtonType="Button|Image|Link"
CancelDestinationPageUrl="uri"
ChangePasswordButtonImageUrl="uri"
ChangePasswordButtonText="string"
ChangePasswordButtonType="Button|Image|Link"
ChangePasswordFailureText="string"
ChangePasswordTitleText="string"
ConfirmNewPasswordLabelText="string"
ConfirmPasswordCompareErrorMessage="string"
ConfirmPasswordRequiredErrorMessage="string"
ContinueButtonImageUrl="uri"
ContinueButtonText="string"
ContinueButtonType="Button|Image|Link"
ContinueDestinationPageUrl="uri"
CreateUserIconUrl="uri"
CreateUserText="string"
CreateUserUrl="uri"
CssClass="string"
DisplayUserName="True|False"
EditProfileIconUrl="uri"
EditProfileText="string"
EditProfileUrl="uri"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HelpPageIconUrl="uri"
HelpPageText="string"
HelpPageUrl="uri"
ID="string"
InstructionText="string"
MailDefinition-BodyFileName="uri"
MailDefinition-CC="string"
MailDefinition-From="string"
MailDefinition-IsBodyHtml="True|False"
MailDefinition-Priority="Normal|Low|High"
MailDefinition-Subject="string"
MembershipProvider="string"
NewPasswordLabelText="string"
NewPasswordRegularExpression="string"
NewPasswordRegularExpressionErrorMessage="string"
NewPasswordRequiredErrorMessage="string"
OnCancelButtonClick="CancelButtonClick event handler"
OnChangedPassword="ChangedPassword event handler"
OnChangePasswordError="ChangePasswordError event handler"
OnChangingPassword="ChangingPassword event handler"
OnContinueButtonClick="ContinueButtonClick event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSendingMail="SendingMail event handler"
OnSendMailError="SendMailError event handler"
OnUnload="Unload event handler"
PasswordHintText="string"
PasswordLabelText="string"
PasswordRecoveryIconUrl="uri"
PasswordRecoveryText="string"
PasswordRecoveryUrl="uri"
PasswordRequiredErrorMessage="string"
runat="server"
SkinID="string"
Style="string"
SuccessPageUrl="uri"
SuccessText="string"
SuccessTitleText="string"
TabIndex="integer"
ToolTip="string"
UserName="string"
UserNameLabelText="string"
UserNameRequiredErrorMessage="string"
Visible="True|False"
Width="size"
>
<CancelButtonStyle/>
<ChangePasswordButtonStyle/>
<ChangePasswordTemplate>
<!-- child controls -->
</ChangePasswordTemplate>
<ContinueButtonStyle/>
<FailureTextStyle/>
<HyperLinkStyle/>
<InstructionTextStyle/>
<LabelStyle/>
<MailDefinition
BodyFileName="uri"
CC="string"
From="string"
IsBodyHtml="True|False"
Priority="Normal|Low|High"
Subject="string"
>
<EmbeddedObjects>
<asp:EmbeddedMailObject
Name="string"
Path="uri"
/>
</EmbeddedObjects>
</MailDefinition>
<PasswordHintStyle/>
<SuccessTemplate>
<!-- child controls -->
</SuccessTemplate>
<SuccessTextStyle/>
<TextBoxStyle/>
<TitleTextStyle/>
<ValidatorTextStyle/>
</asp:ChangePassword>
Provides a user interface that enable users to change their Web site password.
Constructor
To be added.
Initializes a new instance of the class.
2.0.0.0
Property
System.ComponentModel.DefaultValue(1)
System.Int32
To be added.
The value of the property is stored in view state.
Gets or sets the amount of padding, in pixels, inside the border and the designated area for the control.
2.0.0.0
Event
System.EventHandler
To be added.
Occurs when the user clicks the Cancel button to cancel changing a password.
2.0.0.0
Field
System.String
Use the field to represent the CommandName value of the Cancel button. This is useful when configuring any button to mimic the functionality of the Cancel button of the control.
To assign cancel functionality to any control contained in the control, set the property of the button to the string that is contained in the field.
The Cancel button can appear on the ChangePassword template or the Success template. Clicking the Cancel button on the Success template will not undo the password change; it will clear the text boxes. To add custom functionality to the Cancel button, create an event handler for the event.
Represents the CommandName value of the Cancel button. This field is read-only.
2.0.0.0
Property
System.ComponentModel.DefaultValue("")
System.String
To be added.
To be added.
Gets or sets the URL of an image to display with the Cancel button, if the Cancel button is configured by the property to be an image button.
2.0.0.0
Property
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.Web.UI.WebControls.Style
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color of the Cancel button. The color can be any of the properties.
-
BorderColor
The color of the border around the Cancel button. The color can be any of the properties.
-
BorderStyle
The style of the border around the Cancel button. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth setting is greater than 2.
-
BorderWidth
The width of the border around the Cancel button.
-
CssClass
The cascading style sheet (CSS) class used to render the Cancel button. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the Cancel button text in bold type.
-
Font-Italic
true to display the Cancel button text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the Cancel button text with a line above it.
-
Font-Size
The size of the text in the Cancel button as a object.
-
Font-Strikeout
true to display the Cancel button text as crossed out.
-
Font-Underline
true to display the Cancel button text with an underline.
-
ForeColor
The color of the text in the Cancel button. The color can be any of the properties.
Gets a reference to a collection of properties that define the appearance of the Cancel button on the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The default for the property is "Cancel".
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text displayed on the Cancel button.
2.0.0.0
Property
System.Web.UI.WebControls.ButtonType
To be added.
The property gets or sets the type (Button, Image, or Link) of Cancel button to use when rendering the control.
Gets or sets the type of button to use for the Cancel button when rendering the control.
2.0.0.0
Property
System.Web.UI.Themeable(false)
System.String
To be added.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets or sets the URL of the page that the user is shown after clicking the Cancel button in the control.
2.0.0.0
Event
System.EventHandler
The event is raised after the password is changed by the membership provider specified in the property. After the event is raised, the following occurs:
-
If the property is set, the control attempts to send an e-mail message to the user.
-
The user is either redirected to the Web site specified in the property or the control template specified in the property is displayed.
The new authorization token for the user is set after the event but before the event.
For more information about handling events, see Handling and Raising Events.
Occurs when the password is changed for a user account.
2.0.0.0
Field
System.String
Use the field to represent the CommandName value of the Change Password button. This is useful when configuring any button to mimic the functionality of the Change Password button of the control. The Change Password button completes the last step in the control.
To assign change-password functionality to any control contained in the control, set the property of the button to the string that is contained in the field.
The Change Password button can appear on the ChangePassword template or the Success template. In both cases, clicking the Change Password button calls the membership provider to change the password. To add custom functionality to the Change Password button, create an event handler for the event.
Represents the CommandName value of the Change Password button. This field is read-only.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of an image displayed next to the Change Password button on the control if the Change Password button is configured by the property to be an image button.
2.0.0.0
Property
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.DefaultValue("")
System.Web.UI.WebControls.Style
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color of the Change Password button. The color can be any of the properties.
-
BorderColor
The color of the border around the Change Password button. The color can be any of the properties.
-
BorderStyle
The style of the border around the Change Password button. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the Change Password button.
-
CssClass
The cascading style sheet (CSS) class used to render the Change Password button. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the Change Password button text in bold type.
-
Font-Italic
true to display the Change Password button text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the Change Password button text with a line above it.
-
Font-Size
The size of the text in the Change Password button as a object.
-
Font-Strikeout
true to display the Change Password button text as crossed out.
-
Font-Underline
true to display the Change Password button text with an underline.
-
ForeColor
The color of the text in the Change Password button. The color can be any of the properties.
-
Height
A that represents the height of the Change Password button.
-
Width
A that represents the width of the Change Password button.
Gets a reference to a collection of properties that define the appearance of the Change Password button on the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text displayed on the Change Password button.
2.0.0.0
Property
System.Web.UI.WebControls.ButtonType
To be added.
The property gets or sets the type (Button, Image, or Link) of the Change Password button to use when rendering the control.
Gets or sets the type of button to use when rendering the Change Password button of the control.
2.0.0.0
Event
System.EventHandler
The event is raised when the membership provider specified in the property encounters an error while attempting to change the password for a user account. This can occur if the user enters an incorrect current password or an invalid new password. The specified object does not indicate the reason why changing the password failed, only that the password was not changed.
Use the event to perform custom actions when the password is not changed.
Occurs when there is an error changing the password for the user account.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The property is displayed when the membership provider rejects the password entered by the user.
The object does not return a reason for rejecting the new password. Use the event to examine the rejected password if you want to provide the user with a tip on how to enter an acceptable password (for example, to indicate that a strong password must be provided).
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the message that is shown when the user's password is not changed.
2.0.0.0
Property
System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ChangePassword))
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.Browsable(false)
System.Web.UI.ITemplate
To be added.
The property specifies the object used by the 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 control.
-
Template name
Control view
-
Change Password
-
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 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 , , and 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 , , and controls. The button command name must be set to the control ID.
Optional
-
ConfirmNewPassword
Any type that supports the interface, such as the class.
Optional
-
Continue
Any control that causes event bubbling (passing the event up the server control hierarchy), such as the , , and 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 interface, such as the class.
Required
-
FailureText
Any type that supports the interface.
Optional
-
NewPassword
Any type that supports the interface, such as the class.
Required
-
UserName
Any type that supports the interface.
Required if is true. Must be absent if is false.
The control throws an 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 control.
Gets or sets the object used to display the Change Password view of the control.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Web.UI.Control
To be added.
To be added.
Gets the container that a control uses to create an instance of the template. This provides programmatic access to child controls.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text displayed at the top of the control in Change Password view.
2.0.0.0
Event
System.Web.UI.WebControls.LoginCancelEventHandler
The event is raised before the membership provider specified in the property is called to change the password for a user account.
Use the event to perform any processing that is necessary before changing the password, such as checking the new password to make sure it is not in a list of common passwords. The new authorization token for the user is set after the event but before the event.
The event can be canceled by setting the property of the object to true if the event handler determines that the membership provider should not be called.
For more information about handling events, see Handling and Raising Events.
Occurs before the password for a user account is changed by the membership provider.
2.0.0.0
Property
System.Web.UI.Filterable(false)
System.Web.UI.Themeable(false)
System.ComponentModel.Browsable(false)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.String
To be added.
The property contains the duplicate new password entered by the user.
You can use the property to define the requirements for the new password. This regular expression is used to enforce password rules on the client side.
The is not related to the password enforcement that can be configured at the data store level and enforced on the server side. The password must meet the minimum requirements set by the membership provider in the , , and properties. If the password does not meet these requirements, the event is raised.
Transmitting passwords over HTTP is a potential security threat. HTTP transmissions can be viewed or compromised by malicious users. To improve security when using login controls, you should use the HTTPS protocol with secure sockets layer (SSL) encryption to ensure that the user's password cannot be read during postback. For more information, see Securing Login Controls.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets the duplicate password entered by the user.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the label text for the text box.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The control requires the user to enter the new password twice because the password characters are masked on the screen as the user types them. If the user does not enter the same password in both the New Password text box and the Confirm New Password text box, the message in the property is displayed.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the message that is displayed when the new password and the duplicate password entered by the user are not identical.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the error message that is displayed when the Confirm New Password text box is left empty.
2.0.0.0
Event
System.EventHandler
To be added.
Raises the event when the user clicks the Continue button.
2.0.0.0
Field
System.String
Use the field to represent the CommandName value of the Continue button. This is useful when configuring any button to mimic the functionality of the Continue button of the control.
To assign continue functionality to any control contained in the control, set the property of the button to the string that is contained in the field.
The Continue button can appear on the ChangePassword template or the Success template. Clicking the Continue button redirects the user to the URL stored in the property. To add custom functionality to the Continue button, create an event handler for the event.
Represents CommandName value of the Continue button. This field is read-only.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of an image to use for the Continue button on the Success view of the control if the Continue button is configured by the property to be an image button.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.WebControls.Style
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color of the Continue button. The color can be any of the properties.
-
BorderColor
The color of the border around the Continue button. The color can be any of the properties.
-
BorderStyle
The style of the border around the Continue button. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the Continue button.
-
CssClass
The cascading style sheet (CSS) class used to render the Continue button. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the Continue button text in bold type.
-
Font-Italic
true to display the Continue button text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the Continue button text with a line above it.
-
Font-Size
The size of the text in the Continue button as a object.
-
Font-Strikeout
true to display the Continue button text as crossed out.
-
Font-Underline
true to display the Continue button text with an underline.
-
ForeColor
The color of the text in the Continue button. The color can be any of the properties.
-
Height
A that represents the height of the Continue button.
-
Width
A that represents the width of the Continue button.
Gets a reference to a collection of properties that define the appearance of the Continue button on the Success view of the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text that is displayed on the Continue button on the Success view of the control.
2.0.0.0
Property
System.Web.UI.WebControls.ButtonType
To be added.
The property gets or sets the type (Button, Image, or Link) of the change password button to use when rendering the control.
Gets or sets the type of button to use when rendering the Continue button for the control.
2.0.0.0
Property
System.Web.UI.Themeable(false)
System.String
To be added.
The property contains the URL of the Web page that users will see after successfully changing their password. By setting the , you can control the first page that users see after changing their password.
If the property is the default, an field, when the user clicks the Continue button, the page is refreshed and any values on the form are cleared.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets or sets the URL of the page that the user will see after clicking the Continue button on the Success view.
2.0.0.0
Method
2.0.0.0
System.Void
The method creates instances of the controls that make up the control and creates default event handlers for their events.
Creates the individual controls that make up the control in preparation for posting back or rendering.
Property
System.String
To be added.
To be added.
Gets or sets the URL of an image to display next to the link to the Web page that contains a control for the Web site.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text of the link to the Web page that contains a control for the Web site.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of the Web page that contains a control for the Web site.
2.0.0.0
Property
System.Web.UI.Themeable(false)
System.ComponentModel.Browsable(false)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.String
To be added.
The property contains the current password entered by the user.
Transmitting passwords over HTTP is a potential security threat. HTTP transmissions can be viewed or compromised by malicious users. To improve security when using login controls, you should use HTTPS protocol with secure sockets layer (SSL) encryption to ensure that the user's password cannot be read during postback. For more information, see Securing Login Controls.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets the current password for the user.
2.0.0.0
Property
System.ComponentModel.DefaultValue(false)
System.Boolean
To be added.
In order to change their password, users must be authenticated by the membership provider. To allow users who are not logged on to change their password, or to be authenticated by the membership provider with a different user account and then change the password for that account, the control can display a control to accept the user name.
You must set the property to true if the control will be displayed to users who are not logged on; otherwise, the user will not be able to specify a user name.
Gets or sets a value indicating whether the control should display the control and label.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of an image to display next to the link to the user profile editing page for the Web site.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text of the link to the user profile editing page for the Web site.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of the user profile editing page for the Web site.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color that appears behind the error message text. The color can be any of the properties.
-
BorderColor
The color of the border around the error message text. The color can be any of the properties.
-
BorderStyle
The style of the border around the error message text. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the error message text.
-
CssClass
The cascading style sheet (CSS) class used to render the error message text. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the error message text in bold type.
-
Font-Italic
true to display the error message text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the error message text with a line above it.
-
Font-Size
The size of the text in the error message as a object.
-
Font-Strikeout
true to display the error message text as crossed out.
-
Font-Underline
true to display the error message text with an underline.
-
ForeColor
The color of the text in the error message text. The color can be any of the properties.
-
Height
A that represents the height of the error message text.
-
Width
A that represents the width of the error message text.
Gets a reference to a collection of properties that define the appearance of error messages on the control.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of an image to display next to the Change Password help page for the Web site.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the link text to the Change Password help page for the Web site.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of the Change Password help page for the Web site.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the hyperlink text. The color can be any of the properties.
-
BorderColor
The color of the border around the hyperlinks. The color can be any of the properties.
-
BorderStyle
The style of the border around the hyperlinks. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the hyperlinks.
-
CssClass
The cascading style sheet (CSS) class used to render the hyperlinks. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the hyperlinks text in bold type.
-
Font-Italic
true to display the hyperlinks text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the hyperlinks text with a line above it.
-
Font-Size
The size of the text in the hyperlinks as a object.
-
Font-Strikeout
true to display the hyperlinks text as crossed out.
-
Font-Underline
true to display the hyperlinks text with an underline.
-
ForeColor
The color of the text in the hyperlinks. The color can be any of the properties.
-
Height
A that represents the height of the hyperlinks.
-
Width
A that represents the width of the hyperlinks.
Gets a reference to a collection of properties that define the appearance of hyperlinks on the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The property gets or sets informational text that appears on the control. The default is .
Use this property to display general information about your control. You can also use the property to display instructions about password requirements specified in the membership provider or in the property.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets informational text that appears on the control between the and the input boxes.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the instructional text. The color can be any of the properties.
-
BorderColor
The color of the border around the instructional text. The color can be any of the properties.
-
BorderStyle
The style of the border around the instructional text. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the instructional text.
-
CssClass
The cascading style sheet (CSS) class used to render the instructional text. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the instructional text in bold type.
-
Font-Italic
true to display the instructional text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the instructional text with a line above it.
-
Font-Size
The size of the text in the instructional text as a object.
-
Font-Strikeout
true to display the instructional text as crossed out.
-
Font-Underline
true to display the instructional text with an underline.
-
ForeColor
The color of the text in the instructional text. The color can be any of the properties.
-
Height
A that represents the height of the instructional text.
-
Width
A that represents the width of the instructional text.
Gets a reference to a collection of properties that define the appearance of the instructional text on the control.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the text box labels. The color can be any of the properties.
-
BorderColor
The color of the border around the text box labels. The color can be any of the properties.
-
BorderStyle
The style of the border around the text box labels. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the text box labels.
-
CssClass
The cascading style sheet (CSS) class used to render the text box labels. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the text box labels text in bold type.
-
Font-Italic
true to display the text box labels text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the text box labels text with a line above it.
-
Font-Size
The size of the text in the text box labels as a object.
-
Font-Strikeout
true to display the text box labels text as crossed out.
-
Font-Underline
true to display the text box labels text with an underline.
-
ForeColor
The color of the text in the text box labels. The color can be any of the properties.
-
Height
A that represents the height of the text box labels.
-
Width
A that represents the width of the text box labels.
Gets a reference to a collection of objects that define the appearance of text box labels on the control.
2.0.0.0
Method
2.0.0.0
System.Void
Override the method when you need to specify how a custom server control restores its control state. For more information, see Server Control Custom State Management.
Restores control state information from a previous page request that was saved by the method.
An that represents the control state to restore.
Method
System.Void
Override the method when you need to specify how a custom server control restores its view state. For more information, see Server Control Custom State Management.
Restores view state information from a previous page request that was saved by the method.
An that represents the control state to restore.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.Themeable(false)
System.Web.UI.WebControls.MailDefinition
To be added.
The property returns a reference to a group of properties that you use to define the format and content of the e-mail message sent to users after they have changed their password. Common settings include the subject line and the sender's return address. For a complete list of properties, see .
The property is read-only; however, you can set the properties of the object it returns. You can set these properties in the form property-subproperty, where subproperty represents a property of the class (for example, MailDefinition-Subject). You can also set the properties programmatically in the form Property.Subproperty (for example,MailDefinition.Subject).
An e-mail message is sent only if the user has an e-mail address registered with the membership provider and if the property of the property points to a valid file. If the property is set, the property must be set to an e-mail address; otherwise, an exception is thrown.
If the e-mail message is created from the object, it will make the substitutions shown in the following table. The substitution text is case-insensitive.
-
Substitution text
Replaced with
-
<%
%>
The Web site user name of the user.
-
<%
Password
%>
The new password for the user.
If the property of the object is true, the contents of the mail message will be HTML-encoded to guard against cross-site scripting security vulnerabilities for the message recipient.
You can use the event to modify the object that is created by the object.
Sending user account names or passwords in e-mail is a potential security threat. E-mail messages are typically sent in plain text and can be read by special network "sniffing" applications. To improve security, use the mitigations that are described in Securing Login Controls.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets a reference to a collection of properties that define the e-mail message that is sent to users after they have changed their password.
2.0.0.0
Property
System.ComponentModel.DefaultValue("")
System.Web.UI.Themeable(false)
System.String
To be added.
The property gets or sets the membership provider that is used to look up member information. If the property is null or empty, the default membership provider, AspNetSqlMembershipProvider, is used. For more information about the membership providers available to ASP.NET applications, see Membership Providers.
The new password must meet the minimum requirements set by the membership provider in the , , and properties. If the password does not meet these requirements, the event is raised.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets or sets the membership provider that is used to manage member information.
2.0.0.0
Property
System.Web.UI.Themeable(false)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.String
To be added.
The property contains the new password entered by the user.
You can use the property to define the requirements for the new password. This regular expression is used to enforce password rules on the client side. The is not related to the password enforcement that can be configured at the data store level. The password must meet the minimum requirements set by the membership provider in the , , and properties. If the password does not meet these requirements, the event is raised.
Transmitting passwords over HTTP is a potential security threat. HTTP transmissions can be viewed or compromised by malicious users. To improve security when using login controls, you should use HTTPS protocol with secure sockets layer (SSL) encryption to ensure that the user's password cannot be read during postback. For more information, see Securing Login Controls.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets the new password entered by the user.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the label text for the New Password text box.
2.0.0.0
Property
System.String
To be added.
Use the property to define the requirements for passwords that are used to validate user accounts on your Web site. This regular expression is used to enforce password rules on the client side. The is not related to the password enforcement that can be configured at the data store level. The password must meet the minimum requirements set by the membership provider in the , , and properties. If the password does not meet these requirements, the event is raised.
To display requirements to the user, set the property.
If the password entered does not pass the regular expression contained in the property, the text contained in the property is displayed to the user.
If the password is rejected by the membership provider, the text contained in the property is displayed.
A common use of password standards is to force users to select strong passwords. As a best practice, enforce password rules at the data level in the membership provider. The property allows for the convenience of checking the password on the client side, but does not lock out users who make repeated attempts to log on. To improve security, configure your membership provider to restrict the number of attempts a user may make to log on. For more information, see Securing Membership.
Gets or sets the regular expression that is used to validate the password provided by the user.
2.0.0.0
Property
System.String
To be added.
Use the property to inform the user that the password entered does not pass the regular expression defined in the property.
The is not related to the password enforcement that can be configured at the data store level. The new password must meet the minimum requirements set by the membership provider in the , , and properties. If the password does not meet these requirements, the event is raised.
Gets or sets the error message that is shown when the password entered does not pass the regular expression criteria defined in the property.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the error message that is displayed when the user leaves the New Password text box empty.
2.0.0.0
Method
System.Boolean
The control contains child controls for the Change Password and Success views. Rather than each button raising an event individually, events from the nested controls are bubbled (that is, they are sent to the naming container). The naming container in turn raises a generic event called ItemCommand with parameter values that allow you to determine which individual control raised the original event. By responding to this single event, you can avoid writing event-handling methods for individual child controls.
Determines whether the event for the control is passed up the Web server control hierarchy for the page.
true if the event has been canceled; otherwise, false. The default is false.
The source of the event.
An object that contains the event data.
2.0.0.0
Method
System.Void
To be added.
Raises the event when a user clicks the Cancel button.
An object that contains the event data.
2.0.0.0
Method
System.Void
The method is called after the password is changed by the membership provider specified in the property. After the method is called, the following occurs:
-
If the property is set, the control attempts to send an e-mail message to the user.
-
The user is either redirected to the Web site specified in the property or the control template specified in the property is displayed.
Raising an event invokes the event handler through a delegate. For more information, see Server Event Handling in ASP.NET Web Pages.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event after the password is changed.
An object that contains the event data.
2.0.0.0
Method
System.Void
The method is called when the membership provider specified in the property encounters an error while attempting to change the user's password. The specified object does not indicate the reason why changing the password failed, only that the password was not changed.
Use the method to perform a custom action when the user's password is not changed.
Raising an event invokes the event handler through a delegate. For more information, see Server Event Handling in ASP.NET Web Pages.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event when the user's password is not changed.
An object that contains the event data.
2.0.0.0
Method
System.Void
The method is called before the membership provider specified in the property is called to change the user's password.
Use the method to perform any processing that is necessary before changing the password, such as checking the new password to make sure it is not in a list of common passwords.
The method can cancel the event by setting the property of the object passed as the e parameter to true.
Raising an event invokes the event handler through a delegate. For more information, see Server Event Handling in ASP.NET Web Pages.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event before the user's password is changed by the membership provider.
A object containing the event data.
2.0.0.0
Method
System.Void
To be added.
Raises the event when a user clicks the Continue button.
An object that contains the event data.
2.0.0.0
Method
2.0.0.0
System.Void
Web server controls should perform any initialization steps that are required to create and set up an instance. You cannot use view state information within this event; it is not populated yet. You should not access another Web server control during the method, regardless of whether it is a child or parent to the control. Other Web server controls are not certain to be created and ready for access.
Raises the event for the control to allow the control to register itself with the page.
An object containing the event data.
Method
2.0.0.0
System.Void
To be added.
Raises the event.
An object containing the event data.
Method
System.Void
Use the method to modify the e-mail message that is sent to users after they change their password. The property of the object will be sent to the SMTP server for processing. Modify the properties of the object to modify the e-mail message.
E-mail messages are created only when the property of the object specified by the property points to a valid file name.
Sending user account names or passwords in e-mail is a potential security threat. E-mail messages are typically sent in plain text and can be read by special network "sniffing" applications. To improve security, use the mitigations that are described in Securing Login Controls.
Raising an event invokes the event handler through a delegate. For more information, see Server Event Handling in ASP.NET Web Pages.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event before an e-mail message is sent to the SMTP server for processing. The SMTP server then sends the e-mail message to the user.
A object containing the event data.
2.0.0.0
Method
System.Void
The method is called when the SMTP mail system raises an exception while attempting to send an e-mail message after a user has changed a password.
Examine the property of the object passed as the parameter to determine the actual cause of the exception. The most common reason is a configuration error in the smtp section of the Web.config file.
You must set the property of the object passed as the parameter to true to signal that the exception has been taken care of; otherwise, the exception is thrown again.
Raising an event invokes the event handler through a delegate. For more information, see Server Event Handling in ASP.NET Web Pages.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event when an e-mail message cannot be sent to the user.
A object containing the event data.
2.0.0.0
Property
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the hint text. The color can be any of the properties.
-
BorderColor
The color of the border around the hint text. The color can be any of the properties.
-
BorderStyle
The style of the border around the hint text. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the hint text.
-
CssClass
The cascading style sheet (CSS) class used to render the hint text. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the hint text in bold type.
-
Font-Italic
true to display the hint text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the hint text with a line above it.
-
Font-Size
The size of the text in the hint text as a object.
-
Font-Strikeout
true to display the hint text as crossed out.
-
Font-Underline
true to display the hint text with an underline.
-
ForeColor
The color of the text in the hint text. The color can be any of the properties.
-
Height
A that represents the height of the hint text.
-
Width
A that represents the width of the hint text.
Gets a reference to a collection of properties that define the appearance of hint text that appears on the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The property gets or sets informational text about the requirements for creating a password for the Web site. Use this property to describe the requirements for the new password that are specified in the property.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets informational text about the requirements for creating a password for the Web site.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the label text for the Current Password text box.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of an image to display next to a link to the Web page that contains the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text of the link to the Web page that contains the control.
2.0.0.0
Property
System.String
To be added.
To be added.
Gets or sets the URL of the Web page that contains the control.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The property gets or sets the error message that is displayed when the user leaves the Current Password text box empty.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the error message that is displayed when the user leaves the Current Password text box empty.
2.0.0.0
Method
2.0.0.0
System.Void
To be added.
Writes the control content to the specified object, for display on the client.
The object that represents the output stream used to write content to a Web page.
Method
2.0.0.0
System.Object
Use the method to save state information required for the operation of the control. This control state data is stored separately from the view state data for the control.
Custom controls using control state must call the method on the object before saving control state.
Saves any server control state changes that have occurred since the time the page was posted back to the server.
The server control's current state; otherwise, null.
Method
System.Object
View state is the accumulation of the values of the properties for the control. These values are automatically placed in the property for the control, which is an instance of the class. The value for the property is then persisted to a string object after the save state stage of the control life cycle. For more information, see Control Execution Lifecycle.
When view state is saved, this string object is returned to the client as a variable that is stored in an HTML <input type="hidden" /> element. When you author custom server controls, you can improve efficiency by overriding the method and modifying the property for the control.
Saves any server control view state changes that have occurred since the time the page was posted back to the server.
The server control's current view state; otherwise, null.
2.0.0.0
Event
System.Web.UI.WebControls.MailMessageEventHandler
The control will send an e-mail message confirming that the password has been changed when the property defines an e-mail message to send.
The e-mail message contains automatic replacement fields for the user name and password. You can use the event to modify the e-mail message before it is sent to the user.
Sending user account names or passwords in e-mail is a potential security threat. E-mail messages are typically sent in plain text and can be read by special network "sniffing" applications. To improve security, use the mitigations that are described in Securing Login Controls.
For more information about handling events, see Handling and Raising Events.
Occurs before the user is sent an e-mail confirmation that the password has been changed.
2.0.0.0
Event
System.Web.UI.WebControls.SendMailErrorEventHandler
The event is raised when the SMTP mail provider throws an exception when trying to send an e-mail message after users have changed their password. The most common reason that this event is raised is that the smtp section of the Web.config file is incorrect. For more information about the smtp section, see <smtp>.
The default event handler does not catch or handle the SMTP error from the mail system. Your event handler must set the property of the object to true in order to stop the error from being displayed to users.
For more information about handling events, see Handling and Raising Events.
Occurs when there is an SMTP error sending an e-mail message to the user.
2.0.0.0
Method
System.Void
To be added.
Sets design-time data for a control.
An containing the design-time data for the control.
2.0.0.0
Property
System.Web.UI.Themeable(false)
System.String
To be added.
Set the property when you want users to be redirected to a specific page of your Web site after successfully changing their passwords. If the property is not set (set is the default), the page containing the control is refreshed and the property is displayed. If the property is set, the Success view is not displayed.
This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview.
Gets or sets the URL of the page that is shown to users after they have changed their password successfully.
2.0.0.0
Property
System.ComponentModel.Browsable(false)
System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ChangePassword))
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.Web.UI.ITemplate
To be added.
The property specifies the object that is used by the control. The property is accessible only when using a code-behind file. 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 control supports the following templates, which are applied to the corresponding control view.
-
Template name
Control view
-
Change Password view
-
Success view
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.
Gets or sets the object that is used to display the Success and Change Password views of the control.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Web.UI.Control
To be added.
To be added.
Gets the container that a control used to create an instance of the template. This provides programmatic access to child controls.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The property gets or sets the text that is displayed on the Success view. The default is "Your password has been changed!".
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the text that is displayed on the Success view between the and the Continue button.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the Success view text. The color can be any of the properties.
-
BorderColor
The color of the border around the Success view text. The color can be any of the properties.
-
BorderStyle
The style of the border around the Success view text. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the Success view text.
-
CssClass
The cascading style sheet (CSS) class used to render the Success view text. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the Success view text in bold type.
-
Font-Italic
true to display the Success view text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the Success view text with a line above it.
-
Font-Size
The size of the text in the Success view text as a object.
-
Font-Strikeout
true to display the Success view text as crossed out.
-
Font-Underline
true to display the Success view text with an underline.
-
ForeColor
The color of the text in the Success view text. The color can be any of the properties.
-
Height
A that represents the height of the Success view text.
-
Width
A that represents the width of the Success view text.
Gets a collection of properties that define the appearance of text on the Success view.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The property gets or sets the title of the Success view. The default is "Change Password Complete".
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the title of the Success view.
2.0.0.0
Property
System.Web.UI.HtmlTextWriterTag
To be added.
Use the property to determine the value that is associated with a control.
The property allows the output stream to write the appropriate HTML markup for the control.
This property is used primarily by control developers.
Gets the value that corresponds to a control. This property is used primarily by control developers.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.Web.UI.WebControls.Style
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The background color of text boxes. The color can be any of the properties.
-
BorderColor
The color of the border around the text boxes. The color can be any of the properties.
-
BorderStyle
The style of the border around the text boxes. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the text boxes.
-
CssClass
The cascading style sheet (CSS) class used to render the text boxes. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the text boxes text in bold type.
-
Font-Italic
true to display the text boxes text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the text boxes text with a line above it.
-
Font-Size
The size of the text in the text boxes as a object.
-
Font-Strikeout
true to display the text boxes text as crossed out.
-
Font-Underline
true to display the text boxes text with an underline.
-
ForeColor
The color of the text in the text boxes. The color can be any of the properties.
-
Height
A that represents the height of the text boxes.
-
Width
A that represents the width of the text boxes.
Gets a reference to a collection of properties that define the appearance of text box controls on the control.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.Web.UI.WebControls.TableItemStyle
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the titles. The color can be any of the properties.
-
BorderColor
The color of the border around the titles. The color can be any of the properties.
-
BorderStyle
The style of the border around the titles. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the titles.
-
CssClass
The cascading style sheet (CSS) class used to render the titles. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the titles text in bold type.
-
Font-Italic
true to display the titles text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the titles text with a line above it.
-
Font-Size
The size of the text in the titles as a object.
-
Font-Strikeout
true to display the titles text as crossed out.
-
Font-Underline
true to display the titles text with an underline.
-
ForeColor
The color of the text in the titles. The color can be any of the properties.
-
Height
A that represents the height of the titles.
-
Width
A that represents the width of the titles.
Gets a reference to a collection of properties that define the appearance of titles on the control.
2.0.0.0
Method
System.Void
To be added.
Causes tracking of view-state changes to the server control so that they can be stored in the server control's object. This object is accessible through the property.
2.0.0.0
Property
System.ComponentModel.DefaultValue("")
System.String
To be added.
The property gets the Web site user name for which to change the password. You can also use the property just to get the user name from within the control, without changing the password. Additionally, the property can be used from within an e-mail message that has been created to send e-mail from the control by using the string "<%UserName%>" in the body of the e-mail message.
To allow the user to type in a user name, set the property to true. If a user is already authenticated, he or she does not need to enter a user name.
Gets or sets the Web site user name for which to change the password.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the label for the User Name text box.
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.String
To be added.
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization.
Gets or sets the error message that is displayed when the user leaves the User Name text box empty.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)
System.ComponentModel.NotifyParentProperty(true)
System.Web.UI.WebControls.Style
To be added.
The following table lists the style settings that are available for customization with the property.
-
Setting
Description
-
BackColor
The color behind the error messages. The color can be any of the properties.
-
BorderColor
The color of the border around the error messages. The color can be any of the properties.
-
BorderStyle
The style of the border around the error messages. The style can be "None", "Dotted", "Dashed", "Solid", "Double", "Groove", "Ridge", "Inset", or "Outset". The default is "NotSet". Some styles do not show up clearly unless the BorderWidth value is greater than 2.
-
BorderWidth
The width of the border around the error messages.
-
CssClass
The cascading style sheet (CSS) class used to render the error messages. If other settings are specified, they will override a style sheet setting.
-
Font-Bold
true to display the error messages text in bold type.
-
Font-Italic
true to display the error messages text in italic type.
-
Font-Names
The name of the font face.
-
Font-Overline
true to display the error messages text with a line above it.
-
Font-Size
The size of the text in the error messages as a object.
-
Font-Strikeout
true to display the error messages text as crossed out.
-
Font-Underline
true to display the error messages text with an underline.
-
ForeColor
The color of the text in the error messages. The color can be any of the properties.
-
Height
A that represents the height of the error messages.
-
Width
A that represents the width of the error messages.
Gets a reference to a collection of properties that define the appearance of error messages that are associated with any input validation used by the control.
2.0.0.0