1<?xml version="1.0" encoding="utf-8"?> 2<Type Name="ChangePassword" FullName="System.Web.UI.WebControls.ChangePassword"> 3 <TypeSignature Language="C#" Value="public class ChangePassword : System.Web.UI.WebControls.CompositeControl" /> 4 <AssemblyInfo> 5 <AssemblyName>System.Web</AssemblyName> 6 <AssemblyVersion>2.0.0.0</AssemblyVersion> 7 </AssemblyInfo> 8 <Base> 9 <BaseTypeName>System.Web.UI.WebControls.CompositeControl</BaseTypeName> 10 </Base> 11 <Interfaces /> 12 <Docs> 13 <since version=".NET 2.0" /> 14 <remarks> 15 <attribution license="cc4" from="Microsoft" modified="false" /> 16 <para>In this topic:</para> 17 <list type="bullet"> 18 <item> 19 <para> <format type="text/html"><a href="#Introduction">Introduction</a></format> 20 </para> 21 </item> 22 <item> 23 <para> <format type="text/html"><a href="#sending_email_messages">Sending E-mail Messages</a></format> 24 </para> 25 </item> 26 <item> 27 <para> <format type="text/html"><a href="#views">Views</a></format> 28 </para> 29 </item> 30 <item> 31 <para> <format type="text/html"><a href="#styles_and_templates">Styles and Templates</a></format> 32 </para> 33 </item> 34 <item> 35 <para> <format type="text/html"><a href="#validation_groupings">Validation Groupings</a></format> 36 </para> 37 </item> 38 <item> 39 <para> <format type="text/html"><a href="#access_keys_and_tab_indexes">Access Keys and Tab Indexes</a></format> 40 </para> 41 </item> 42 <item> 43 <para> <format type="text/html"><a href="#accessibility">Accessibility</a></format> 44 </para> 45 </item> 46 <item> 47 <para> <format type="text/html"><a href="#accessing_controls_during_page_load_and_page_init">Accessing Controls During Page_Load and Page_Init</a></format> 48 </para> 49 </item> 50 <item> 51 <para> <format type="text/html"><a href="#applying_styles">Applying CSS Styles</a></format> 52 </para> 53 </item> 54 <item> 55 <para> <format type="text/html"><a href="#DeclarativeSyntax">Declarative Syntax#</a></format> 56 </para> 57 </item> 58 </list> 59 <format type="text/html"> 60 <a href="#Introduction" /> 61 </format> 62 <format type="text/html"> 63 <h2>Introduction</h2> 64 </format> 65 <para>Use the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control on a page to enable your Web site users to change the passwords they use to log on to your Web site. </para> 66 <block subset="none" type="note"> 67 <para>If you are not familiar with the set of login controls available in ASP.NET, read <format type="text/html"><a href="ac032230-6469-4b03-b68d-03ef2643a24d">ASP.NET Login Controls Overview</a></format> before continuing. For a list of other topics related to login controls and membership, see <format type="text/html"><a href="824c3a24-f0af-427c-a652-0d2d1e9397cd">Managing Users By Using Membership</a></format>.</para> 68 </block> 69 <block subset="none" type="note"> 70 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 71 </block> 72 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control uses the membership provider defined in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> 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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control uses the default membership provider defined in the <format type="text/html"><a href="b9c1ee8f-33ca-4361-8666-b42a0fe86049">membership</a></format> section of the Web.config file. The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control enables users to perform the following actions:</para> 73 <list type="bullet"> 74 <item> 75 <para>Change their password if they are logged on.</para> 76 </item> 77 <item> 78 <para>Change their password if they are not logged on, as long as the page that contains the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control allows anonymous access and the <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> property is true.</para> 79 </item> 80 <item> 81 <para>Change the password for a user account, even if they are logged on as a different user. This requires the <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> property to be true. </para> 82 </item> 83 </list> 84 <para>Setting the <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> 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. </para> 85 <block subset="none" type="note"> 86 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>, <format type="text/html"><a href="3eeeee9e-b09f-4c7f-8ce5-d9ca1f9322ad">Basic Security Practices for Web Applications</a></format>, and <format type="text/html"><a href="2dab2012-c278-426a-bb0d-93b260c428a7">Securing Membership</a></format>.</para> 87 </block> 88 <format type="text/html"> 89 <a href="#sending_email_messages" /> 90 </format> 91 <format type="text/html"> 92 <h2>Sending E-mail Messages</h2> 93 </format> 94 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> 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 <format type="text/html"><a href="ed204b58-24af-47d0-9687-60e5df5f17f8">How to: Configure an SMTP Virtual Server</a></format>. </para> 95 <para>E-mail messages are configured using the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> class. You must set the <see cref="P:System.Web.UI.WebControls.MailDefinition.BodyFileName" /> property to instruct ASP.NET to send e-mail. </para> 96 <block subset="none" type="note"> 97 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 98 </block> 99 <block subset="none" type="note"> 100 <para>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.</para> 101 </block> 102 <format type="text/html"> 103 <a href="#views" /> 104 </format> 105 <format type="text/html"> 106 <h2>Views</h2> 107 </format> 108 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control has two states, or views:</para> 109 <list type="bullet"> 110 <item> 111 <para>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 <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> property to true to display the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> control in Change Password view. The <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> 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.</para> 112 </item> 113 <item> 114 <para>Success view Provides confirmation that the password has been changed.</para> 115 <block subset="none" type="note"> 116 <para>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.</para> 117 </block> 118 </item> 119 </list> 120 <format type="text/html"> 121 <a href="#styles_and_templates" /> 122 </format> 123 <format type="text/html"> 124 <h2>Styles and Templates</h2> 125 </format> 126 <para>You can use an extensive set of style properties to customize the appearance of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. Alternatively, you can apply custom templates to the two views if you need complete control over the appearance of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. If you define a template for a view, the <see cref="P:System.Web.UI.WebControls.WebControl.ControlStyle" /> properties are applied. For a list of the controls that you must set in the view templates, see the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTemplate" /> and <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> properties. The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> property to true, the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> will throw an exception if a <see cref="T:System.Web.UI.WebControls.TextBox" /> or some other <see cref="T:System.Web.UI.IEditableTextControl" /> control is not found for the user name.</para> 127 <para>The following table lists the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> 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.</para> 128 <list type="table"> 129 <listheader> 130 <item> 131 <term> 132 <para> <see cref="T:System.Web.UI.WebControls.ChangePassword" /> style property</para> 133 </term> 134 <description> 135 <para>UI element </para> 136 </description> 137 </item> 138 </listheader> 139 <item> 140 <term> 141 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.CancelButtonStyle" /> 142 </para> 143 </term> 144 <description> 145 <para>Cancel button on the Change Password view.</para> 146 </description> 147 </item> 148 <item> 149 <term> 150 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordButtonStyle" /> 151 </para> 152 </term> 153 <description> 154 <para>Change Password button on the Change Password view.</para> 155 </description> 156 </item> 157 <item> 158 <term> 159 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueButtonStyle" /> 160 </para> 161 </term> 162 <description> 163 <para>Continue button on the Success view.</para> 164 </description> 165 </item> 166 <item> 167 <term> 168 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.FailureTextStyle" /> 169 </para> 170 </term> 171 <description> 172 <para>Error text displayed to the user.</para> 173 </description> 174 </item> 175 <item> 176 <term> 177 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.HyperLinkStyle" /> 178 </para> 179 </term> 180 <description> 181 <para>Hyperlinks to other pages.</para> 182 </description> 183 </item> 184 <item> 185 <term> 186 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.InstructionTextStyle" /> 187 </para> 188 </term> 189 <description> 190 <para>Instructional text on the page that describes how to use the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 191 </description> 192 </item> 193 <item> 194 <term> 195 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.LabelStyle" /> 196 </para> 197 </term> 198 <description> 199 <para>Labels for all input fields, such as text boxes.</para> 200 </description> 201 </item> 202 <item> 203 <term> 204 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.PasswordHintStyle" /> 205 </para> 206 </term> 207 <description> 208 <para>Hints for providing an acceptable password for the Web site.</para> 209 </description> 210 </item> 211 <item> 212 <term> 213 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTextStyle" /> 214 </para> 215 </term> 216 <description> 217 <para>Text displayed to the user when the password has been successfully changed.</para> 218 </description> 219 </item> 220 <item> 221 <term> 222 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.TextBoxStyle" /> 223 </para> 224 </term> 225 <description> 226 <para>Text entry input fields.</para> 227 </description> 228 </item> 229 <item> 230 <term> 231 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.TitleTextStyle" /> 232 </para> 233 </term> 234 <description> 235 <para>Titles for the Change Password and Success views.</para> 236 </description> 237 </item> 238 </list> 239 <format type="text/html"> 240 <a href="#applying_styles" /> 241 </format> 242 <format type="text/html"> 243 <h2>Applying CSS Styles</h2> 244 </format> 245 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control lets you specify CSS style rules in markup. If you use templates to customize the appearance of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.RenderOuterTable" /> property to false.</para> 246 <format type="text/html"> 247 <a href="#validation_groupings" /> 248 </format> 249 <format type="text/html"> 250 <h2>Validation Groupings</h2> 251 </format> 252 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control uses a validation group so that other fields on the same page as the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control can be validated separately. By default, the <see cref="P:System.Web.UI.Control.ID" /> property of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control is used as the name of the validation group. For example, a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control with the ID "ChangePassword1" will use a validation group name of ChangePassword1 as well. To set the validation group that the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control is part of, you must create a template with the control, and then change the validation group name.</para> 253 <para>To show error messages if a user leaves a <see cref="T:System.Web.UI.WebControls.TextBox" /> control empty, add a <see cref="T:System.Web.UI.WebControls.ValidationSummary" /> control to the page. Set the <see cref="P:System.Web.UI.WebControls.ValidationSummary.ValidationGroup" /> property of the <see cref="T:System.Web.UI.WebControls.ValidationSummary" /> control to the <see cref="P:System.Web.UI.Control.ID" /> property of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 254 <format type="text/html"> 255 <a href="#access_keys_and_tab_indexes" /> 256 </format> 257 <format type="text/html"> 258 <h2>Access Keys and Tab Indexes</h2> 259 </format> 260 <para>For information about how to use the <see cref="P:System.Web.UI.WebControls.WebControl.AccessKey" /> property and the <see cref="P:System.Web.UI.WebControls.WebControl.TabIndex" /> property of a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control, see <format type="text/html"><a href="7e3ce9c4-6b7d-4fb1-94b5-72cf2a44fe13">ASP.NET 4</a></format> and <format type="text/html"><a href="847a37e3-ce20-41da-b0d3-7dfb0fdae9a0">ASP.NET Controls and Accessibility</a></format>. </para> 261 <format type="text/html"> 262 <a href="#accessibility" /> 263 </format> 264 <format type="text/html"> 265 <h2>Accessibility</h2> 266 </format> 267 <para>For information about how to configure this control so that it generates markup that conforms to accessibility standards, see <format type="text/html"><a href="7e3ce9c4-6b7d-4fb1-94b5-72cf2a44fe13">Accessibility in Visual Studio 2010 and ASP.NET 4</a></format> and <format type="text/html"><a href="847a37e3-ce20-41da-b0d3-7dfb0fdae9a0">ASP.NET Controls and Accessibility</a></format>. </para> 268 <format type="text/html"> 269 <a href="#accessing_controls_during_page_load_and_page_init" /> 270 </format> 271 <format type="text/html"> 272 <h2>Accessing Controls During Page_Load and Page_Init</h2> 273 </format> 274 <para> <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control properties represented by text boxes, such as <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> and <see cref="P:System.Web.UI.WebControls.ChangePassword.CurrentPassword" />, 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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control was rendered. If the user changes the value of the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> property by modifying the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> property in the Page_Init phase or Page_Load phase and provide a custom handler for a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> event, any change that the user makes in the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> text box overrides the value set in the Page_Init or Page_Load phase.</para> 275 <format type="text/html"> 276 <a href="#DeclarativeSyntax" /> 277 </format> 278 <format type="text/html"> 279 <h2>Declarative Syntax</h2> 280 </format> 281 <code><asp:ChangePassword 282 AccessKey="string" 283 BackColor="color name|#dddddd" 284 BorderColor="color name|#dddddd" 285 BorderPadding="integer" 286 BorderStyle="<codeFeaturedElement>NotSet</codeFeaturedElement>|None|Dotted|Dashed|Solid|Double|Groove|Ridge| 287 Inset|Outset" 288 BorderWidth="size" 289 CancelButtonImageUrl="uri" 290 CancelButtonText="string" 291 CancelButtonType="<codeFeaturedElement>Button</codeFeaturedElement>|Image|Link" 292 CancelDestinationPageUrl="uri" 293 ChangePasswordButtonImageUrl="uri" 294 ChangePasswordButtonText="string" 295 ChangePasswordButtonType="<codeFeaturedElement>Button</codeFeaturedElement>|Image|Link" 296 ChangePasswordFailureText="string" 297 ChangePasswordTitleText="string" 298 ConfirmNewPasswordLabelText="string" 299 ConfirmPasswordCompareErrorMessage="string" 300 ConfirmPasswordRequiredErrorMessage="string" 301 ContinueButtonImageUrl="uri" 302 ContinueButtonText="string" 303 ContinueButtonType="<codeFeaturedElement>Button</codeFeaturedElement>|Image|Link" 304 ContinueDestinationPageUrl="uri" 305 CreateUserIconUrl="uri" 306 CreateUserText="string" 307 CreateUserUrl="uri" 308 CssClass="string" 309 DisplayUserName="True|<codeFeaturedElement>False</codeFeaturedElement>" 310 EditProfileIconUrl="uri" 311 EditProfileText="string" 312 EditProfileUrl="uri" 313 Enabled="<codeFeaturedElement>True</codeFeaturedElement>|False" 314 EnableTheming="<codeFeaturedElement>True</codeFeaturedElement>|False" 315 EnableViewState="<codeFeaturedElement>True</codeFeaturedElement>|False" 316 Font-Bold="True|<codeFeaturedElement>False</codeFeaturedElement>" 317 Font-Italic="True|<codeFeaturedElement>False</codeFeaturedElement>" 318 Font-Names="string" 319 Font-Overline="True|<codeFeaturedElement>False</codeFeaturedElement>" 320 Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium| 321 Large|X-Large|XX-Large" 322 Font-Strikeout="True|<codeFeaturedElement>False</codeFeaturedElement>" 323 Font-Underline="True|<codeFeaturedElement>False</codeFeaturedElement>" 324 ForeColor="color name|#dddddd" 325 Height="size" 326 HelpPageIconUrl="uri" 327 HelpPageText="string" 328 HelpPageUrl="uri" 329 ID="string" 330 InstructionText="string" 331 MailDefinition-BodyFileName="uri" 332 MailDefinition-CC="string" 333 MailDefinition-From="string" 334 MailDefinition-IsBodyHtml="True|<codeFeaturedElement>False</codeFeaturedElement>" 335 MailDefinition-Priority="<codeFeaturedElement>Normal</codeFeaturedElement>|Low|High" 336 MailDefinition-Subject="string" 337 MembershipProvider="string" 338 NewPasswordLabelText="string" 339 NewPasswordRegularExpression="string" 340 NewPasswordRegularExpressionErrorMessage="string" 341 NewPasswordRequiredErrorMessage="string" 342 OnCancelButtonClick="CancelButtonClick event handler" 343 OnChangedPassword="ChangedPassword event handler" 344 OnChangePasswordError="ChangePasswordError event handler" 345 OnChangingPassword="ChangingPassword event handler" 346 OnContinueButtonClick="ContinueButtonClick event handler" 347 OnDataBinding="DataBinding event handler" 348 OnDisposed="Disposed event handler" 349 OnInit="Init event handler" 350 OnLoad="Load event handler" 351 OnPreRender="PreRender event handler" 352 OnSendingMail="SendingMail event handler" 353 OnSendMailError="SendMailError event handler" 354 OnUnload="Unload event handler" 355 PasswordHintText="string" 356 PasswordLabelText="string" 357 PasswordRecoveryIconUrl="uri" 358 PasswordRecoveryText="string" 359 PasswordRecoveryUrl="uri" 360 PasswordRequiredErrorMessage="string" 361 runat="server" 362 SkinID="string" 363 Style="string" 364 SuccessPageUrl="uri" 365 SuccessText="string" 366 SuccessTitleText="string" 367 TabIndex="integer" 368 ToolTip="string" 369 UserName="string" 370 UserNameLabelText="string" 371 UserNameRequiredErrorMessage="string" 372 Visible="<codeFeaturedElement>True</codeFeaturedElement>|False" 373 Width="size" 374> 375 <CancelButtonStyle/> 376 <ChangePasswordButtonStyle/> 377 <ChangePasswordTemplate> 378 <!-- child controls --> 379 </ChangePasswordTemplate> 380 <ContinueButtonStyle/> 381 <FailureTextStyle/> 382 <HyperLinkStyle/> 383 <InstructionTextStyle/> 384 <LabelStyle/> 385 <MailDefinition 386 BodyFileName="uri" 387 CC="string" 388 From="string" 389 IsBodyHtml="True|<codeFeaturedElement>False</codeFeaturedElement>" 390 Priority="<codeFeaturedElement>Normal</codeFeaturedElement>|Low|High" 391 Subject="string" 392> 393 <EmbeddedObjects> 394 <asp:EmbeddedMailObject 395 Name="string" 396 Path="uri" 397 /> 398 </EmbeddedObjects> 399 </MailDefinition> 400 <PasswordHintStyle/> 401 <SuccessTemplate> 402 <!-- child controls --> 403 </SuccessTemplate> 404 <SuccessTextStyle/> 405 <TextBoxStyle/> 406 <TitleTextStyle/> 407 <ValidatorTextStyle/> 408</asp:ChangePassword></code> 409 </remarks> 410 <summary> 411 <attribution license="cc4" from="Microsoft" modified="false" /> 412 <para>Provides a user interface that enable users to change their Web site password.</para> 413 </summary> 414 </Docs> 415 <Members> 416 <Member MemberName=".ctor"> 417 <MemberSignature Language="C#" Value="public ChangePassword ();" /> 418 <MemberType>Constructor</MemberType> 419 <Parameters /> 420 <Docs> 421 <remarks>To be added.</remarks> 422 <since version=".NET 2.0" /> 423 <summary> 424 <attribution license="cc4" from="Microsoft" modified="false" /> 425 <para>Initializes a new instance of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> class. </para> 426 </summary> 427 </Docs> 428 <AssemblyInfo> 429 <AssemblyVersion>2.0.0.0</AssemblyVersion> 430 </AssemblyInfo> 431 </Member> 432 <Member MemberName="BorderPadding"> 433 <MemberSignature Language="C#" Value="public virtual int BorderPadding { set; get; }" /> 434 <MemberType>Property</MemberType> 435 <Attributes> 436 <Attribute> 437 <AttributeName>System.ComponentModel.DefaultValue(1)</AttributeName> 438 </Attribute> 439 </Attributes> 440 <ReturnValue> 441 <ReturnType>System.Int32</ReturnType> 442 </ReturnValue> 443 <Docs> 444 <value>To be added.</value> 445 <since version=".NET 2.0" /> 446 <remarks> 447 <attribution license="cc4" from="Microsoft" modified="false" /> 448 <para>The value of the <see cref="P:System.Web.UI.WebControls.ChangePassword.BorderPadding" /> property is stored in view state.</para> 449 </remarks> 450 <summary> 451 <attribution license="cc4" from="Microsoft" modified="false" /> 452 <para>Gets or sets the amount of padding, in pixels, inside the border and the designated area for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 453 </summary> 454 </Docs> 455 <AssemblyInfo> 456 <AssemblyVersion>2.0.0.0</AssemblyVersion> 457 </AssemblyInfo> 458 </Member> 459 <Member MemberName="CancelButtonClick"> 460 <MemberSignature Language="C#" Value="public event EventHandler CancelButtonClick;" /> 461 <MemberType>Event</MemberType> 462 <ReturnValue> 463 <ReturnType>System.EventHandler</ReturnType> 464 </ReturnValue> 465 <Docs> 466 <remarks>To be added.</remarks> 467 <since version=".NET 2.0" /> 468 <summary> 469 <attribution license="cc4" from="Microsoft" modified="false" /> 470 <para>Occurs when the user clicks the Cancel button to cancel changing a password.</para> 471 </summary> 472 </Docs> 473 <AssemblyInfo> 474 <AssemblyVersion>2.0.0.0</AssemblyVersion> 475 </AssemblyInfo> 476 </Member> 477 <Member MemberName="CancelButtonCommandName"> 478 <MemberSignature Language="C#" Value="public static readonly string CancelButtonCommandName;" /> 479 <MemberType>Field</MemberType> 480 <ReturnValue> 481 <ReturnType>System.String</ReturnType> 482 </ReturnValue> 483 <Docs> 484 <since version=".NET 2.0" /> 485 <remarks> 486 <attribution license="cc4" from="Microsoft" modified="false" /> 487 <para>Use the <see cref="F:System.Web.UI.WebControls.ChangePassword.CancelButtonCommandName" /> 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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 488 <para>To assign cancel functionality to any <see cref="T:System.Web.UI.WebControls.Button" /> control contained in the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control, set the <see cref="P:System.Web.UI.WebControls.Button.CommandName" /> property of the button to the string that is contained in the <see cref="F:System.Web.UI.WebControls.ChangePassword.CancelButtonCommandName" /> field. </para> 489 <para>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 <see cref="E:System.Web.UI.WebControls.ChangePassword.CancelButtonClick" /> event.</para> 490 </remarks> 491 <summary> 492 <attribution license="cc4" from="Microsoft" modified="false" /> 493 <para>Represents the CommandName value of the Cancel button. This field is read-only.</para> 494 </summary> 495 </Docs> 496 <AssemblyInfo> 497 <AssemblyVersion>2.0.0.0</AssemblyVersion> 498 </AssemblyInfo> 499 </Member> 500 <Member MemberName="CancelButtonImageUrl"> 501 <MemberSignature Language="C#" Value="public virtual string CancelButtonImageUrl { set; get; }" /> 502 <MemberType>Property</MemberType> 503 <Attributes> 504 <Attribute> 505 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 506 </Attribute> 507 </Attributes> 508 <ReturnValue> 509 <ReturnType>System.String</ReturnType> 510 </ReturnValue> 511 <Docs> 512 <value>To be added.</value> 513 <remarks>To be added.</remarks> 514 <since version=".NET 2.0" /> 515 <summary> 516 <attribution license="cc4" from="Microsoft" modified="false" /> 517 <para>Gets or sets the URL of an image to display with the Cancel button, if the Cancel button is configured by the <see cref="P:System.Web.UI.WebControls.ChangePassword.CancelButtonType" /> property to be an image button.</para> 518 </summary> 519 </Docs> 520 <AssemblyInfo> 521 <AssemblyVersion>2.0.0.0</AssemblyVersion> 522 </AssemblyInfo> 523 </Member> 524 <Member MemberName="CancelButtonStyle"> 525 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.Style CancelButtonStyle { get; }" /> 526 <MemberType>Property</MemberType> 527 <Attributes> 528 <Attribute> 529 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 530 </Attribute> 531 <Attribute> 532 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 533 </Attribute> 534 <Attribute> 535 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 536 </Attribute> 537 </Attributes> 538 <ReturnValue> 539 <ReturnType>System.Web.UI.WebControls.Style</ReturnType> 540 </ReturnValue> 541 <Docs> 542 <value>To be added.</value> 543 <since version=".NET 2.0" /> 544 <remarks> 545 <attribution license="cc4" from="Microsoft" modified="false" /> 546 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.CancelButtonStyle" /> property.</para> 547 <list type="table"> 548 <listheader> 549 <item> 550 <term> 551 <para>Setting</para> 552 </term> 553 <description> 554 <para>Description</para> 555 </description> 556 </item> 557 </listheader> 558 <item> 559 <term> 560 <para> BackColor 561 </para> 562 </term> 563 <description> 564 <para>The color of the Cancel button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 565 </description> 566 </item> 567 <item> 568 <term> 569 <para> BorderColor 570 </para> 571 </term> 572 <description> 573 <para>The color of the border around the Cancel button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties. </para> 574 </description> 575 </item> 576 <item> 577 <term> 578 <para> BorderStyle 579 </para> 580 </term> 581 <description> 582 <para>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.</para> 583 </description> 584 </item> 585 <item> 586 <term> 587 <para> BorderWidth 588 </para> 589 </term> 590 <description> 591 <para>The width of the border around the Cancel button.</para> 592 </description> 593 </item> 594 <item> 595 <term> 596 <para> CssClass 597 </para> 598 </term> 599 <description> 600 <para>The cascading style sheet (CSS) class used to render the Cancel button. If other settings are specified, they will override a style sheet setting.</para> 601 </description> 602 </item> 603 <item> 604 <term> 605 <para> Font-Bold 606 </para> 607 </term> 608 <description> 609 <para> true to display the Cancel button text in bold type.</para> 610 </description> 611 </item> 612 <item> 613 <term> 614 <para> Font-Italic 615 </para> 616 </term> 617 <description> 618 <para> true to display the Cancel button text in italic type.</para> 619 </description> 620 </item> 621 <item> 622 <term> 623 <para> Font-Names 624 </para> 625 </term> 626 <description> 627 <para>The name of the font face.</para> 628 </description> 629 </item> 630 <item> 631 <term> 632 <para> Font-Overline 633 </para> 634 </term> 635 <description> 636 <para> true to display the Cancel button text with a line above it.</para> 637 </description> 638 </item> 639 <item> 640 <term> 641 <para> Font-Size 642 </para> 643 </term> 644 <description> 645 <para>The size of the text in the Cancel button as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 646 </description> 647 </item> 648 <item> 649 <term> 650 <para> Font-Strikeout 651 </para> 652 </term> 653 <description> 654 <para> true to display the Cancel button text as crossed out.</para> 655 </description> 656 </item> 657 <item> 658 <term> 659 <para> Font-Underline 660 </para> 661 </term> 662 <description> 663 <para> true to display the Cancel button text with an underline.</para> 664 </description> 665 </item> 666 <item> 667 <term> 668 <para> ForeColor 669 </para> 670 </term> 671 <description> 672 <para>The color of the text in the Cancel button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 673 </description> 674 </item> 675 </list> 676 </remarks> 677 <summary> 678 <attribution license="cc4" from="Microsoft" modified="false" /> 679 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of the Cancel button on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 680 </summary> 681 </Docs> 682 <AssemblyInfo> 683 <AssemblyVersion>2.0.0.0</AssemblyVersion> 684 </AssemblyInfo> 685 </Member> 686 <Member MemberName="CancelButtonText"> 687 <MemberSignature Language="C#" Value="public virtual string CancelButtonText { set; get; }" /> 688 <MemberType>Property</MemberType> 689 <Attributes> 690 <Attribute> 691 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 692 </Attribute> 693 </Attributes> 694 <ReturnValue> 695 <ReturnType>System.String</ReturnType> 696 </ReturnValue> 697 <Docs> 698 <value>To be added.</value> 699 <since version=".NET 2.0" /> 700 <remarks> 701 <attribution license="cc4" from="Microsoft" modified="false" /> 702 <para>The default for the <see cref="P:System.Web.UI.WebControls.ChangePassword.CancelButtonText" /> property is "Cancel".</para> 703 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 704 </remarks> 705 <summary> 706 <attribution license="cc4" from="Microsoft" modified="false" /> 707 <para>Gets or sets the text displayed on the Cancel button.</para> 708 </summary> 709 </Docs> 710 <AssemblyInfo> 711 <AssemblyVersion>2.0.0.0</AssemblyVersion> 712 </AssemblyInfo> 713 </Member> 714 <Member MemberName="CancelButtonType"> 715 <MemberSignature Language="C#" Value="public virtual System.Web.UI.WebControls.ButtonType CancelButtonType { set; get; }" /> 716 <MemberType>Property</MemberType> 717 <ReturnValue> 718 <ReturnType>System.Web.UI.WebControls.ButtonType</ReturnType> 719 </ReturnValue> 720 <Docs> 721 <value>To be added.</value> 722 <since version=".NET 2.0" /> 723 <remarks> 724 <attribution license="cc4" from="Microsoft" modified="false" /> 725 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.CancelButtonType" /> property gets or sets the type (Button, Image, or Link) of Cancel button to use when rendering the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. </para> 726 </remarks> 727 <summary> 728 <attribution license="cc4" from="Microsoft" modified="false" /> 729 <para>Gets or sets the type of button to use for the Cancel button when rendering the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 730 </summary> 731 </Docs> 732 <AssemblyInfo> 733 <AssemblyVersion>2.0.0.0</AssemblyVersion> 734 </AssemblyInfo> 735 </Member> 736 <Member MemberName="CancelDestinationPageUrl"> 737 <MemberSignature Language="C#" Value="public virtual string CancelDestinationPageUrl { set; get; }" /> 738 <MemberType>Property</MemberType> 739 <Attributes> 740 <Attribute> 741 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 742 </Attribute> 743 </Attributes> 744 <ReturnValue> 745 <ReturnType>System.String</ReturnType> 746 </ReturnValue> 747 <Docs> 748 <value>To be added.</value> 749 <since version=".NET 2.0" /> 750 <remarks> 751 <attribution license="cc4" from="Microsoft" modified="false" /> 752 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 753 </remarks> 754 <summary> 755 <attribution license="cc4" from="Microsoft" modified="false" /> 756 <para>Gets or sets the URL of the page that the user is shown after clicking the Cancel button in the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 757 </summary> 758 </Docs> 759 <AssemblyInfo> 760 <AssemblyVersion>2.0.0.0</AssemblyVersion> 761 </AssemblyInfo> 762 </Member> 763 <Member MemberName="ChangedPassword"> 764 <MemberSignature Language="C#" Value="public event EventHandler ChangedPassword;" /> 765 <MemberType>Event</MemberType> 766 <ReturnValue> 767 <ReturnType>System.EventHandler</ReturnType> 768 </ReturnValue> 769 <Docs> 770 <since version=".NET 2.0" /> 771 <remarks> 772 <attribution license="cc4" from="Microsoft" modified="false" /> 773 <para>The <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangedPassword" /> event is raised after the password is changed by the membership provider specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> property. After the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangedPassword" /> event is raised, the following occurs: </para> 774 <list type="bullet"> 775 <item> 776 <para>If the <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> property is set, the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control attempts to send an e-mail message to the user.</para> 777 </item> 778 <item> 779 <para>The user is either redirected to the Web site specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessPageUrl" /> property or the control template specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> property is displayed.</para> 780 </item> 781 </list> 782 <para>The new authorization token for the user is set after the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> event but before the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangedPassword" /> event.</para> 783 <para>For more information about handling events, see <format type="text/html"><a href="b6f65241-e0ad-4590-a99f-200ce741bb1f">Handling and Raising Events</a></format>. </para> 784 </remarks> 785 <summary> 786 <attribution license="cc4" from="Microsoft" modified="false" /> 787 <para>Occurs when the password is changed for a user account.</para> 788 </summary> 789 </Docs> 790 <AssemblyInfo> 791 <AssemblyVersion>2.0.0.0</AssemblyVersion> 792 </AssemblyInfo> 793 </Member> 794 <Member MemberName="ChangePasswordButtonCommandName"> 795 <MemberSignature Language="C#" Value="public static readonly string ChangePasswordButtonCommandName;" /> 796 <MemberType>Field</MemberType> 797 <ReturnValue> 798 <ReturnType>System.String</ReturnType> 799 </ReturnValue> 800 <Docs> 801 <since version=".NET 2.0" /> 802 <remarks> 803 <attribution license="cc4" from="Microsoft" modified="false" /> 804 <para>Use the <see cref="F:System.Web.UI.WebControls.ChangePassword.ChangePasswordButtonCommandName" /> 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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. The Change Password button completes the last step in the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 805 <para>To assign change-password functionality to any <see cref="T:System.Web.UI.WebControls.Button" /> control contained in the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control, set the <see cref="P:System.Web.UI.WebControls.Button.CommandName" /> property of the button to the string that is contained in the <see cref="F:System.Web.UI.WebControls.ChangePassword.ChangePasswordButtonCommandName" /> field. </para> 806 <para>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 <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangedPassword" /> event.</para> 807 </remarks> 808 <summary> 809 <attribution license="cc4" from="Microsoft" modified="false" /> 810 <para>Represents the CommandName value of the Change Password button. This field is read-only.</para> 811 </summary> 812 </Docs> 813 <AssemblyInfo> 814 <AssemblyVersion>2.0.0.0</AssemblyVersion> 815 </AssemblyInfo> 816 </Member> 817 <Member MemberName="ChangePasswordButtonImageUrl"> 818 <MemberSignature Language="C#" Value="public virtual string ChangePasswordButtonImageUrl { set; get; }" /> 819 <MemberType>Property</MemberType> 820 <ReturnValue> 821 <ReturnType>System.String</ReturnType> 822 </ReturnValue> 823 <Docs> 824 <value>To be added.</value> 825 <remarks>To be added.</remarks> 826 <since version=".NET 2.0" /> 827 <summary> 828 <attribution license="cc4" from="Microsoft" modified="false" /> 829 <para>Gets or sets the URL of an image displayed next to the Change Password button on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control if the Change Password button is configured by the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordButtonType" /> property to be an image button.</para> 830 </summary> 831 </Docs> 832 <AssemblyInfo> 833 <AssemblyVersion>2.0.0.0</AssemblyVersion> 834 </AssemblyInfo> 835 </Member> 836 <Member MemberName="ChangePasswordButtonStyle"> 837 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.Style ChangePasswordButtonStyle { get; }" /> 838 <MemberType>Property</MemberType> 839 <Attributes> 840 <Attribute> 841 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 842 </Attribute> 843 <Attribute> 844 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 845 </Attribute> 846 <Attribute> 847 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 848 </Attribute> 849 <Attribute> 850 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 851 </Attribute> 852 </Attributes> 853 <ReturnValue> 854 <ReturnType>System.Web.UI.WebControls.Style</ReturnType> 855 </ReturnValue> 856 <Docs> 857 <value>To be added.</value> 858 <since version=".NET 2.0" /> 859 <remarks> 860 <attribution license="cc4" from="Microsoft" modified="false" /> 861 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordButtonStyle" /> property.</para> 862 <list type="table"> 863 <listheader> 864 <item> 865 <term> 866 <para>Setting</para> 867 </term> 868 <description> 869 <para>Description</para> 870 </description> 871 </item> 872 </listheader> 873 <item> 874 <term> 875 <para> BackColor 876 </para> 877 </term> 878 <description> 879 <para>The color of the Change Password button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 880 </description> 881 </item> 882 <item> 883 <term> 884 <para> BorderColor 885 </para> 886 </term> 887 <description> 888 <para>The color of the border around the Change Password button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 889 </description> 890 </item> 891 <item> 892 <term> 893 <para> BorderStyle 894 </para> 895 </term> 896 <description> 897 <para>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.</para> 898 </description> 899 </item> 900 <item> 901 <term> 902 <para> BorderWidth 903 </para> 904 </term> 905 <description> 906 <para>The width of the border around the Change Password button.</para> 907 </description> 908 </item> 909 <item> 910 <term> 911 <para> CssClass 912 </para> 913 </term> 914 <description> 915 <para>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.</para> 916 </description> 917 </item> 918 <item> 919 <term> 920 <para> Font-Bold 921 </para> 922 </term> 923 <description> 924 <para> true to display the Change Password button text in bold type.</para> 925 </description> 926 </item> 927 <item> 928 <term> 929 <para> Font-Italic 930 </para> 931 </term> 932 <description> 933 <para> true to display the Change Password button text in italic type.</para> 934 </description> 935 </item> 936 <item> 937 <term> 938 <para> Font-Names 939 </para> 940 </term> 941 <description> 942 <para>The name of the font face.</para> 943 </description> 944 </item> 945 <item> 946 <term> 947 <para> Font-Overline 948 </para> 949 </term> 950 <description> 951 <para> true to display the Change Password button text with a line above it.</para> 952 </description> 953 </item> 954 <item> 955 <term> 956 <para> Font-Size 957 </para> 958 </term> 959 <description> 960 <para>The size of the text in the Change Password button as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 961 </description> 962 </item> 963 <item> 964 <term> 965 <para> Font-Strikeout 966 </para> 967 </term> 968 <description> 969 <para> true to display the Change Password button text as crossed out.</para> 970 </description> 971 </item> 972 <item> 973 <term> 974 <para> Font-Underline 975 </para> 976 </term> 977 <description> 978 <para> true to display the Change Password button text with an underline.</para> 979 </description> 980 </item> 981 <item> 982 <term> 983 <para> ForeColor 984 </para> 985 </term> 986 <description> 987 <para>The color of the text in the Change Password button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 988 </description> 989 </item> 990 <item> 991 <term> 992 <para> Height 993 </para> 994 </term> 995 <description> 996 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the Change Password button.</para> 997 </description> 998 </item> 999 <item> 1000 <term> 1001 <para> Width 1002 </para> 1003 </term> 1004 <description> 1005 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the Change Password button.</para> 1006 </description> 1007 </item> 1008 </list> 1009 </remarks> 1010 <summary> 1011 <attribution license="cc4" from="Microsoft" modified="false" /> 1012 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of the Change Password button on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1013 </summary> 1014 </Docs> 1015 <AssemblyInfo> 1016 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1017 </AssemblyInfo> 1018 </Member> 1019 <Member MemberName="ChangePasswordButtonText"> 1020 <MemberSignature Language="C#" Value="public virtual string ChangePasswordButtonText { set; get; }" /> 1021 <MemberType>Property</MemberType> 1022 <Attributes> 1023 <Attribute> 1024 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1025 </Attribute> 1026 </Attributes> 1027 <ReturnValue> 1028 <ReturnType>System.String</ReturnType> 1029 </ReturnValue> 1030 <Docs> 1031 <value>To be added.</value> 1032 <since version=".NET 2.0" /> 1033 <remarks> 1034 <attribution license="cc4" from="Microsoft" modified="false" /> 1035 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1036 </remarks> 1037 <summary> 1038 <attribution license="cc4" from="Microsoft" modified="false" /> 1039 <para>Gets or sets the text displayed on the Change Password button.</para> 1040 </summary> 1041 </Docs> 1042 <AssemblyInfo> 1043 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1044 </AssemblyInfo> 1045 </Member> 1046 <Member MemberName="ChangePasswordButtonType"> 1047 <MemberSignature Language="C#" Value="public virtual System.Web.UI.WebControls.ButtonType ChangePasswordButtonType { set; get; }" /> 1048 <MemberType>Property</MemberType> 1049 <ReturnValue> 1050 <ReturnType>System.Web.UI.WebControls.ButtonType</ReturnType> 1051 </ReturnValue> 1052 <Docs> 1053 <value>To be added.</value> 1054 <since version=".NET 2.0" /> 1055 <remarks> 1056 <attribution license="cc4" from="Microsoft" modified="false" /> 1057 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordButtonType" /> property gets or sets the type (Button, Image, or Link) of the Change Password button to use when rendering the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. </para> 1058 </remarks> 1059 <summary> 1060 <attribution license="cc4" from="Microsoft" modified="false" /> 1061 <para>Gets or sets the type of button to use when rendering the Change Password button of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1062 </summary> 1063 </Docs> 1064 <AssemblyInfo> 1065 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1066 </AssemblyInfo> 1067 </Member> 1068 <Member MemberName="ChangePasswordError"> 1069 <MemberSignature Language="C#" Value="public event EventHandler ChangePasswordError;" /> 1070 <MemberType>Event</MemberType> 1071 <ReturnValue> 1072 <ReturnType>System.EventHandler</ReturnType> 1073 </ReturnValue> 1074 <Docs> 1075 <since version=".NET 2.0" /> 1076 <remarks> 1077 <attribution license="cc4" from="Microsoft" modified="false" /> 1078 <para>The <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event is raised when the membership provider specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> 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 <see cref="T:System.Web.Security.MembershipProvider" /> object does not indicate the reason why changing the password failed, only that the password was not changed.</para> 1079 <para>Use the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event to perform custom actions when the password is not changed.</para> 1080 </remarks> 1081 <summary> 1082 <attribution license="cc4" from="Microsoft" modified="false" /> 1083 <para>Occurs when there is an error changing the password for the user account.</para> 1084 </summary> 1085 </Docs> 1086 <AssemblyInfo> 1087 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1088 </AssemblyInfo> 1089 </Member> 1090 <Member MemberName="ChangePasswordFailureText"> 1091 <MemberSignature Language="C#" Value="public virtual string ChangePasswordFailureText { set; get; }" /> 1092 <MemberType>Property</MemberType> 1093 <Attributes> 1094 <Attribute> 1095 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1096 </Attribute> 1097 </Attributes> 1098 <ReturnValue> 1099 <ReturnType>System.String</ReturnType> 1100 </ReturnValue> 1101 <Docs> 1102 <value>To be added.</value> 1103 <since version=".NET 2.0" /> 1104 <remarks> 1105 <attribution license="cc4" from="Microsoft" modified="false" /> 1106 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordFailureText" /> property is displayed when the membership provider rejects the password entered by the user. </para> 1107 <para>The <see cref="T:System.Web.Security.MembershipProvider" /> object does not return a reason for rejecting the new password. Use the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> 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).</para> 1108 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1109 </remarks> 1110 <summary> 1111 <attribution license="cc4" from="Microsoft" modified="false" /> 1112 <para>Gets or sets the message that is shown when the user's password is not changed.</para> 1113 </summary> 1114 </Docs> 1115 <AssemblyInfo> 1116 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1117 </AssemblyInfo> 1118 </Member> 1119 <Member MemberName="ChangePasswordTemplate"> 1120 <MemberSignature Language="C#" Value="public virtual System.Web.UI.ITemplate ChangePasswordTemplate { set; get; }" /> 1121 <MemberType>Property</MemberType> 1122 <Attributes> 1123 <Attribute> 1124 <AttributeName>System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ChangePassword))</AttributeName> 1125 </Attribute> 1126 <Attribute> 1127 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 1128 </Attribute> 1129 <Attribute> 1130 <AttributeName>System.ComponentModel.Browsable(false)</AttributeName> 1131 </Attribute> 1132 </Attributes> 1133 <ReturnValue> 1134 <ReturnType>System.Web.UI.ITemplate</ReturnType> 1135 </ReturnValue> 1136 <Docs> 1137 <value>To be added.</value> 1138 <since version=".NET 2.0" /> 1139 <remarks> 1140 <attribution license="cc4" from="Microsoft" modified="false" /> 1141 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTemplate" /> property specifies the <see cref="T:System.Web.UI.ITemplate" /> object used by the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. For more information, see <format type="text/html"><a href="8d7aef0c-d9e3-444b-b3f7-ca0c157eb8b4">Creating Web Server Control Templates Dynamically</a></format>.</para> 1142 <para>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:</para> 1143 <list type="bullet"> 1144 <item> 1145 <para>Templates define the content of a section of a control.</para> 1146 </item> 1147 <item> 1148 <para>Styles specify the appearance of elements in the control.</para> 1149 </item> 1150 </list> 1151 <para>For more information, see <format type="text/html"><a href="f769d290-fd04-4084-85fc-4ea30dd2e8ae">ASP.NET Web Server Controls Templates</a></format> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">Introduction to ASP.NET Themes</a></format>.</para> 1152 <para>The following table lists the templates and the corresponding control view that are supported by the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1153 <list type="table"> 1154 <listheader> 1155 <item> 1156 <term> 1157 <para>Template name</para> 1158 </term> 1159 <description> 1160 <para>Control view</para> 1161 </description> 1162 </item> 1163 </listheader> 1164 <item> 1165 <term> 1166 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTemplate" /> 1167 </para> 1168 </term> 1169 <description> 1170 <para>Change Password</para> 1171 </description> 1172 </item> 1173 <item> 1174 <term> 1175 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> 1176 </para> 1177 </term> 1178 <description> 1179 <para>Success</para> 1180 </description> 1181 </item> 1182 </list> 1183 <para>You can also create or modify the template for a control in your .aspx file. For more information, see <format type="text/html"><a href="4977e1d5-c53a-4908-83be-bba0ad37357a">How to: Create Web Server Control Templates Using ASP.NET Syntax</a></format> and <format type="text/html"><a href="8d7aef0c-d9e3-444b-b3f7-ca0c157eb8b4">Creating Web Server Control Templates Dynamically</a></format>. The procedures in those topics do not require you to configure the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTemplate" /> property. If you do configure the template, the following table lists the required and optional controls for the template.</para> 1184 <list type="table"> 1185 <listheader> 1186 <item> 1187 <term> 1188 <para>Control ID</para> 1189 </term> 1190 <description> 1191 <para>Control type </para> 1192 </description> 1193 <description> 1194 <para>Required/optional </para> 1195 </description> 1196 </item> 1197 </listheader> 1198 <item> 1199 <term> 1200 <para> Cancel 1201 </para> 1202 </term> 1203 <description> 1204 <para>Any control that causes event bubbling (passing the event up the server control hierarchy), such as the <see cref="T:System.Web.UI.WebControls.Button" />, <see cref="T:System.Web.UI.WebControls.LinkButton" />, and <see cref="T:System.Web.UI.WebControls.ImageButton" /> controls. The button command name must be set to the control ID. </para> 1205 </description> 1206 <description> 1207 <para>Optional </para> 1208 </description> 1209 </item> 1210 <item> 1211 <term> 1212 <para> ChangePassword 1213 </para> 1214 </term> 1215 <description> 1216 <para>Any control that causes event bubbling (passing the event up the server control hierarchy), such as the <see cref="T:System.Web.UI.WebControls.Button" />, <see cref="T:System.Web.UI.WebControls.LinkButton" />, and <see cref="T:System.Web.UI.WebControls.ImageButton" /> controls. The button command name must be set to the control ID. </para> 1217 </description> 1218 <description> 1219 <para>Optional </para> 1220 </description> 1221 </item> 1222 <item> 1223 <term> 1224 <para> ConfirmNewPassword 1225 </para> 1226 </term> 1227 <description> 1228 <para>Any type that supports the <see cref="T:System.Web.UI.IEditableTextControl" /> interface, such as the <see cref="T:System.Web.UI.WebControls.TextBox" /> class.</para> 1229 </description> 1230 <description> 1231 <para>Optional</para> 1232 </description> 1233 </item> 1234 <item> 1235 <term> 1236 <para> Continue 1237 </para> 1238 </term> 1239 <description> 1240 <para>Any control that causes event bubbling (passing the event up the server control hierarchy), such as the <see cref="T:System.Web.UI.WebControls.Button" />, <see cref="T:System.Web.UI.WebControls.LinkButton" />, and <see cref="T:System.Web.UI.WebControls.ImageButton" /> controls. The button command name must be set to the control ID. This control appears on the Success template. </para> 1241 </description> 1242 <description> 1243 <para>Optional </para> 1244 </description> 1245 </item> 1246 <item> 1247 <term> 1248 <para> CurrentPassword 1249 </para> 1250 </term> 1251 <description> 1252 <para>Any type that supports the <see cref="T:System.Web.UI.IEditableTextControl" /> interface, such as the <see cref="T:System.Web.UI.WebControls.TextBox" /> class.</para> 1253 </description> 1254 <description> 1255 <para>Required </para> 1256 </description> 1257 </item> 1258 <item> 1259 <term> 1260 <para> FailureText 1261 </para> 1262 </term> 1263 <description> 1264 <para>Any type that supports the <see cref="T:System.Web.UI.ITextControl" /> interface.</para> 1265 </description> 1266 <description> 1267 <para>Optional </para> 1268 </description> 1269 </item> 1270 <item> 1271 <term> 1272 <para> NewPassword 1273 </para> 1274 </term> 1275 <description> 1276 <para>Any type that supports the <see cref="T:System.Web.UI.IEditableTextControl" /> interface, such as the <see cref="T:System.Web.UI.WebControls.TextBox" /> class.</para> 1277 </description> 1278 <description> 1279 <para>Required </para> 1280 </description> 1281 </item> 1282 <item> 1283 <term> 1284 <para> UserName 1285 </para> 1286 </term> 1287 <description> 1288 <para>Any type that supports the <see cref="T:System.Web.UI.IEditableTextControl" /> interface.</para> 1289 </description> 1290 <description> 1291 <para>Required if <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> is true. Must be absent if <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> is false.</para> 1292 </description> 1293 </item> 1294 </list> 1295 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control throws an <see cref="T: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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1296 </remarks> 1297 <summary> 1298 <attribution license="cc4" from="Microsoft" modified="false" /> 1299 <para>Gets or sets the <see cref="T:System.Web.UI.ITemplate" /> object used to display the Change Password view of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1300 </summary> 1301 </Docs> 1302 <AssemblyInfo> 1303 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1304 </AssemblyInfo> 1305 </Member> 1306 <Member MemberName="ChangePasswordTemplateContainer"> 1307 <MemberSignature Language="C#" Value="public System.Web.UI.Control ChangePasswordTemplateContainer { get; }" /> 1308 <MemberType>Property</MemberType> 1309 <Attributes> 1310 <Attribute> 1311 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName> 1312 </Attribute> 1313 <Attribute> 1314 <AttributeName>System.ComponentModel.Browsable(false)</AttributeName> 1315 </Attribute> 1316 </Attributes> 1317 <ReturnValue> 1318 <ReturnType>System.Web.UI.Control</ReturnType> 1319 </ReturnValue> 1320 <Docs> 1321 <value>To be added.</value> 1322 <remarks>To be added.</remarks> 1323 <since version=".NET 2.0" /> 1324 <summary> 1325 <attribution license="cc4" from="Microsoft" modified="false" /> 1326 <para>Gets the container that a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control uses to create an instance of the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTemplate" /> template. This provides programmatic access to child controls.</para> 1327 </summary> 1328 </Docs> 1329 <AssemblyInfo> 1330 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1331 </AssemblyInfo> 1332 </Member> 1333 <Member MemberName="ChangePasswordTitleText"> 1334 <MemberSignature Language="C#" Value="public virtual string ChangePasswordTitleText { set; get; }" /> 1335 <MemberType>Property</MemberType> 1336 <Attributes> 1337 <Attribute> 1338 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1339 </Attribute> 1340 </Attributes> 1341 <ReturnValue> 1342 <ReturnType>System.String</ReturnType> 1343 </ReturnValue> 1344 <Docs> 1345 <value>To be added.</value> 1346 <since version=".NET 2.0" /> 1347 <remarks> 1348 <attribution license="cc4" from="Microsoft" modified="false" /> 1349 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1350 </remarks> 1351 <summary> 1352 <attribution license="cc4" from="Microsoft" modified="false" /> 1353 <para>Gets or sets the text displayed at the top of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control in Change Password view.</para> 1354 </summary> 1355 </Docs> 1356 <AssemblyInfo> 1357 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1358 </AssemblyInfo> 1359 </Member> 1360 <Member MemberName="ChangingPassword"> 1361 <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.LoginCancelEventHandler ChangingPassword;" /> 1362 <MemberType>Event</MemberType> 1363 <ReturnValue> 1364 <ReturnType>System.Web.UI.WebControls.LoginCancelEventHandler</ReturnType> 1365 </ReturnValue> 1366 <Docs> 1367 <since version=".NET 2.0" /> 1368 <remarks> 1369 <attribution license="cc4" from="Microsoft" modified="false" /> 1370 <para>The <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> event is raised before the membership provider specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> property is called to change the password for a user account. </para> 1371 <para>Use the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> 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 <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> event but before the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangedPassword" /> event.</para> 1372 <para>The <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> event can be canceled by setting the <see cref="P:System.Web.UI.WebControls.LoginCancelEventArgs.Cancel" /> property of the <see cref="T:System.Web.UI.WebControls.LoginCancelEventArgs" /> object to true if the event handler determines that the membership provider should not be called.</para> 1373 <para>For more information about handling events, see <format type="text/html"><a href="b6f65241-e0ad-4590-a99f-200ce741bb1f">Handling and Raising Events</a></format>. </para> 1374 </remarks> 1375 <summary> 1376 <attribution license="cc4" from="Microsoft" modified="false" /> 1377 <para>Occurs before the password for a user account is changed by the membership provider.</para> 1378 </summary> 1379 </Docs> 1380 <AssemblyInfo> 1381 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1382 </AssemblyInfo> 1383 </Member> 1384 <Member MemberName="ConfirmNewPassword"> 1385 <MemberSignature Language="C#" Value="public virtual string ConfirmNewPassword { get; }" /> 1386 <MemberType>Property</MemberType> 1387 <Attributes> 1388 <Attribute> 1389 <AttributeName>System.Web.UI.Filterable(false)</AttributeName> 1390 </Attribute> 1391 <Attribute> 1392 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 1393 </Attribute> 1394 <Attribute> 1395 <AttributeName>System.ComponentModel.Browsable(false)</AttributeName> 1396 </Attribute> 1397 <Attribute> 1398 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName> 1399 </Attribute> 1400 </Attributes> 1401 <ReturnValue> 1402 <ReturnType>System.String</ReturnType> 1403 </ReturnValue> 1404 <Docs> 1405 <value>To be added.</value> 1406 <since version=".NET 2.0" /> 1407 <remarks> 1408 <attribution license="cc4" from="Microsoft" modified="false" /> 1409 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.ConfirmNewPassword" /> property contains the duplicate new password entered by the user. </para> 1410 <para>You can use the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property to define the requirements for the new password. This regular expression is used to enforce password rules on the client side. </para> 1411 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> 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 <format type="text/html"><a href="d2c90ff6-aa86-4001-b2c5-e5c99cb7f68f">membership provider</a></format> in the <see cref="P:System.Web.Security.Membership.MinRequiredPasswordLength" />, <see cref="P:System.Web.Security.Membership.MinRequiredNonAlphanumericCharacters" />, and <see cref="P:System.Web.Security.Membership.PasswordStrengthRegularExpression" /> properties. If the password does not meet these requirements, the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event is raised.</para> 1412 <block subset="none" type="note"> 1413 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 1414 </block> 1415 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 1416 </remarks> 1417 <summary> 1418 <attribution license="cc4" from="Microsoft" modified="false" /> 1419 <para>Gets the duplicate password entered by the user.</para> 1420 </summary> 1421 </Docs> 1422 <AssemblyInfo> 1423 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1424 </AssemblyInfo> 1425 </Member> 1426 <Member MemberName="ConfirmNewPasswordLabelText"> 1427 <MemberSignature Language="C#" Value="public virtual string ConfirmNewPasswordLabelText { set; get; }" /> 1428 <MemberType>Property</MemberType> 1429 <Attributes> 1430 <Attribute> 1431 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1432 </Attribute> 1433 </Attributes> 1434 <ReturnValue> 1435 <ReturnType>System.String</ReturnType> 1436 </ReturnValue> 1437 <Docs> 1438 <value>To be added.</value> 1439 <since version=".NET 2.0" /> 1440 <remarks> 1441 <attribution license="cc4" from="Microsoft" modified="false" /> 1442 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1443 </remarks> 1444 <summary> 1445 <attribution license="cc4" from="Microsoft" modified="false" /> 1446 <para>Gets or sets the label text for the <see cref="P:System.Web.UI.WebControls.ChangePassword.ConfirmNewPassword" /> text box.</para> 1447 </summary> 1448 </Docs> 1449 <AssemblyInfo> 1450 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1451 </AssemblyInfo> 1452 </Member> 1453 <Member MemberName="ConfirmPasswordCompareErrorMessage"> 1454 <MemberSignature Language="C#" Value="public virtual string ConfirmPasswordCompareErrorMessage { set; get; }" /> 1455 <MemberType>Property</MemberType> 1456 <Attributes> 1457 <Attribute> 1458 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1459 </Attribute> 1460 </Attributes> 1461 <ReturnValue> 1462 <ReturnType>System.String</ReturnType> 1463 </ReturnValue> 1464 <Docs> 1465 <value>To be added.</value> 1466 <since version=".NET 2.0" /> 1467 <remarks> 1468 <attribution license="cc4" from="Microsoft" modified="false" /> 1469 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.ConfirmPasswordCompareErrorMessage" /> property is displayed.</para> 1470 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1471 </remarks> 1472 <summary> 1473 <attribution license="cc4" from="Microsoft" modified="false" /> 1474 <para>Gets or sets the message that is displayed when the new password and the duplicate password entered by the user are not identical.</para> 1475 </summary> 1476 </Docs> 1477 <AssemblyInfo> 1478 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1479 </AssemblyInfo> 1480 </Member> 1481 <Member MemberName="ConfirmPasswordRequiredErrorMessage"> 1482 <MemberSignature Language="C#" Value="public virtual string ConfirmPasswordRequiredErrorMessage { set; get; }" /> 1483 <MemberType>Property</MemberType> 1484 <Attributes> 1485 <Attribute> 1486 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1487 </Attribute> 1488 </Attributes> 1489 <ReturnValue> 1490 <ReturnType>System.String</ReturnType> 1491 </ReturnValue> 1492 <Docs> 1493 <value>To be added.</value> 1494 <since version=".NET 2.0" /> 1495 <remarks> 1496 <attribution license="cc4" from="Microsoft" modified="false" /> 1497 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1498 </remarks> 1499 <summary> 1500 <attribution license="cc4" from="Microsoft" modified="false" /> 1501 <para>Gets or sets the error message that is displayed when the Confirm New Password text box is left empty.</para> 1502 </summary> 1503 </Docs> 1504 <AssemblyInfo> 1505 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1506 </AssemblyInfo> 1507 </Member> 1508 <Member MemberName="ContinueButtonClick"> 1509 <MemberSignature Language="C#" Value="public event EventHandler ContinueButtonClick;" /> 1510 <MemberType>Event</MemberType> 1511 <ReturnValue> 1512 <ReturnType>System.EventHandler</ReturnType> 1513 </ReturnValue> 1514 <Docs> 1515 <remarks>To be added.</remarks> 1516 <since version=".NET 2.0" /> 1517 <summary> 1518 <attribution license="cc4" from="Microsoft" modified="false" /> 1519 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.ContinueButtonClick" /> event when the user clicks the Continue button.</para> 1520 </summary> 1521 </Docs> 1522 <AssemblyInfo> 1523 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1524 </AssemblyInfo> 1525 </Member> 1526 <Member MemberName="ContinueButtonCommandName"> 1527 <MemberSignature Language="C#" Value="public static readonly string ContinueButtonCommandName;" /> 1528 <MemberType>Field</MemberType> 1529 <ReturnValue> 1530 <ReturnType>System.String</ReturnType> 1531 </ReturnValue> 1532 <Docs> 1533 <since version=".NET 2.0" /> 1534 <remarks> 1535 <attribution license="cc4" from="Microsoft" modified="false" /> 1536 <para>Use the <see cref="F:System.Web.UI.WebControls.ChangePassword.ContinueButtonCommandName" /> 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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1537 <para>To assign continue functionality to any <see cref="T:System.Web.UI.WebControls.Button" /> control contained in the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control, set the <see cref="P:System.Web.UI.WebControls.Button.CommandName" /> property of the button to the string that is contained in the <see cref="F:System.Web.UI.WebControls.ChangePassword.ContinueButtonCommandName" /> field. </para> 1538 <para>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 <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueDestinationPageUrl" /> property. To add custom functionality to the Continue button, create an event handler for the <see cref="E:System.Web.UI.WebControls.ChangePassword.ContinueButtonClick" /> event.</para> 1539 </remarks> 1540 <summary> 1541 <attribution license="cc4" from="Microsoft" modified="false" /> 1542 <para>Represents CommandName value of the Continue button. This field is read-only.</para> 1543 </summary> 1544 </Docs> 1545 <AssemblyInfo> 1546 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1547 </AssemblyInfo> 1548 </Member> 1549 <Member MemberName="ContinueButtonImageUrl"> 1550 <MemberSignature Language="C#" Value="public virtual string ContinueButtonImageUrl { set; get; }" /> 1551 <MemberType>Property</MemberType> 1552 <ReturnValue> 1553 <ReturnType>System.String</ReturnType> 1554 </ReturnValue> 1555 <Docs> 1556 <value>To be added.</value> 1557 <remarks>To be added.</remarks> 1558 <since version=".NET 2.0" /> 1559 <summary> 1560 <attribution license="cc4" from="Microsoft" modified="false" /> 1561 <para>Gets or sets the URL of an image to use for the Continue button on the Success view of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control if the Continue button is configured by the <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueButtonType" /> property to be an image button.</para> 1562 </summary> 1563 </Docs> 1564 <AssemblyInfo> 1565 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1566 </AssemblyInfo> 1567 </Member> 1568 <Member MemberName="ContinueButtonStyle"> 1569 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.Style ContinueButtonStyle { get; }" /> 1570 <MemberType>Property</MemberType> 1571 <Attributes> 1572 <Attribute> 1573 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 1574 </Attribute> 1575 <Attribute> 1576 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 1577 </Attribute> 1578 <Attribute> 1579 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 1580 </Attribute> 1581 </Attributes> 1582 <ReturnValue> 1583 <ReturnType>System.Web.UI.WebControls.Style</ReturnType> 1584 </ReturnValue> 1585 <Docs> 1586 <value>To be added.</value> 1587 <since version=".NET 2.0" /> 1588 <remarks> 1589 <attribution license="cc4" from="Microsoft" modified="false" /> 1590 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueButtonStyle" /> property.</para> 1591 <list type="table"> 1592 <listheader> 1593 <item> 1594 <term> 1595 <para>Setting</para> 1596 </term> 1597 <description> 1598 <para>Description</para> 1599 </description> 1600 </item> 1601 </listheader> 1602 <item> 1603 <term> 1604 <para> BackColor 1605 </para> 1606 </term> 1607 <description> 1608 <para>The color of the Continue button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 1609 </description> 1610 </item> 1611 <item> 1612 <term> 1613 <para> BorderColor 1614 </para> 1615 </term> 1616 <description> 1617 <para>The color of the border around the Continue button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties. </para> 1618 </description> 1619 </item> 1620 <item> 1621 <term> 1622 <para> BorderStyle 1623 </para> 1624 </term> 1625 <description> 1626 <para>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.</para> 1627 </description> 1628 </item> 1629 <item> 1630 <term> 1631 <para> BorderWidth 1632 </para> 1633 </term> 1634 <description> 1635 <para>The width of the border around the Continue button.</para> 1636 </description> 1637 </item> 1638 <item> 1639 <term> 1640 <para> CssClass 1641 </para> 1642 </term> 1643 <description> 1644 <para>The cascading style sheet (CSS) class used to render the Continue button. If other settings are specified, they will override a style sheet setting.</para> 1645 </description> 1646 </item> 1647 <item> 1648 <term> 1649 <para> Font-Bold 1650 </para> 1651 </term> 1652 <description> 1653 <para> true to display the Continue button text in bold type.</para> 1654 </description> 1655 </item> 1656 <item> 1657 <term> 1658 <para> Font-Italic 1659 </para> 1660 </term> 1661 <description> 1662 <para> true to display the Continue button text in italic type.</para> 1663 </description> 1664 </item> 1665 <item> 1666 <term> 1667 <para> Font-Names 1668 </para> 1669 </term> 1670 <description> 1671 <para>The name of the font face.</para> 1672 </description> 1673 </item> 1674 <item> 1675 <term> 1676 <para> Font-Overline 1677 </para> 1678 </term> 1679 <description> 1680 <para> true to display the Continue button text with a line above it.</para> 1681 </description> 1682 </item> 1683 <item> 1684 <term> 1685 <para> Font-Size 1686 </para> 1687 </term> 1688 <description> 1689 <para>The size of the text in the Continue button as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 1690 </description> 1691 </item> 1692 <item> 1693 <term> 1694 <para> Font-Strikeout 1695 </para> 1696 </term> 1697 <description> 1698 <para> true to display the Continue button text as crossed out.</para> 1699 </description> 1700 </item> 1701 <item> 1702 <term> 1703 <para> Font-Underline 1704 </para> 1705 </term> 1706 <description> 1707 <para> true to display the Continue button text with an underline.</para> 1708 </description> 1709 </item> 1710 <item> 1711 <term> 1712 <para> ForeColor 1713 </para> 1714 </term> 1715 <description> 1716 <para>The color of the text in the Continue button. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 1717 </description> 1718 </item> 1719 <item> 1720 <term> 1721 <para> Height 1722 </para> 1723 </term> 1724 <description> 1725 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the Continue button.</para> 1726 </description> 1727 </item> 1728 <item> 1729 <term> 1730 <para> Width 1731 </para> 1732 </term> 1733 <description> 1734 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the Continue button.</para> 1735 </description> 1736 </item> 1737 </list> 1738 </remarks> 1739 <summary> 1740 <attribution license="cc4" from="Microsoft" modified="false" /> 1741 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of the Continue button on the Success view of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1742 </summary> 1743 </Docs> 1744 <AssemblyInfo> 1745 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1746 </AssemblyInfo> 1747 </Member> 1748 <Member MemberName="ContinueButtonText"> 1749 <MemberSignature Language="C#" Value="public virtual string ContinueButtonText { set; get; }" /> 1750 <MemberType>Property</MemberType> 1751 <Attributes> 1752 <Attribute> 1753 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1754 </Attribute> 1755 </Attributes> 1756 <ReturnValue> 1757 <ReturnType>System.String</ReturnType> 1758 </ReturnValue> 1759 <Docs> 1760 <value>To be added.</value> 1761 <since version=".NET 2.0" /> 1762 <remarks> 1763 <attribution license="cc4" from="Microsoft" modified="false" /> 1764 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1765 </remarks> 1766 <summary> 1767 <attribution license="cc4" from="Microsoft" modified="false" /> 1768 <para>Gets or sets the text that is displayed on the Continue button on the Success view of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1769 </summary> 1770 </Docs> 1771 <AssemblyInfo> 1772 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1773 </AssemblyInfo> 1774 </Member> 1775 <Member MemberName="ContinueButtonType"> 1776 <MemberSignature Language="C#" Value="public virtual System.Web.UI.WebControls.ButtonType ContinueButtonType { set; get; }" /> 1777 <MemberType>Property</MemberType> 1778 <ReturnValue> 1779 <ReturnType>System.Web.UI.WebControls.ButtonType</ReturnType> 1780 </ReturnValue> 1781 <Docs> 1782 <value>To be added.</value> 1783 <since version=".NET 2.0" /> 1784 <remarks> 1785 <attribution license="cc4" from="Microsoft" modified="false" /> 1786 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueButtonType" /> property gets or sets the type (Button, Image, or Link) of the change password button to use when rendering the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. </para> 1787 </remarks> 1788 <summary> 1789 <attribution license="cc4" from="Microsoft" modified="false" /> 1790 <para>Gets or sets the type of button to use when rendering the Continue button for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 1791 </summary> 1792 </Docs> 1793 <AssemblyInfo> 1794 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1795 </AssemblyInfo> 1796 </Member> 1797 <Member MemberName="ContinueDestinationPageUrl"> 1798 <MemberSignature Language="C#" Value="public virtual string ContinueDestinationPageUrl { set; get; }" /> 1799 <MemberType>Property</MemberType> 1800 <Attributes> 1801 <Attribute> 1802 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 1803 </Attribute> 1804 </Attributes> 1805 <ReturnValue> 1806 <ReturnType>System.String</ReturnType> 1807 </ReturnValue> 1808 <Docs> 1809 <value>To be added.</value> 1810 <since version=".NET 2.0" /> 1811 <remarks> 1812 <attribution license="cc4" from="Microsoft" modified="false" /> 1813 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueDestinationPageUrl" /> property contains the URL of the Web page that users will see after successfully changing their password. By setting the <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueDestinationPageUrl" />, you can control the first page that users see after changing their password.</para> 1814 <para>If the <see cref="P:System.Web.UI.WebControls.ChangePassword.ContinueDestinationPageUrl" /> property is the default, an <see cref="F:System.String.Empty" /> field, when the user clicks the Continue button, the page is refreshed and any values on the form are cleared.</para> 1815 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 1816 </remarks> 1817 <summary> 1818 <attribution license="cc4" from="Microsoft" modified="false" /> 1819 <para>Gets or sets the URL of the page that the user will see after clicking the Continue button on the Success view.</para> 1820 </summary> 1821 </Docs> 1822 <AssemblyInfo> 1823 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1824 </AssemblyInfo> 1825 </Member> 1826 <Member MemberName="CreateChildControls"> 1827 <MemberSignature Language="C#" Value="protected override void CreateChildControls ();" /> 1828 <MemberType>Method</MemberType> 1829 <AssemblyInfo> 1830 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1831 </AssemblyInfo> 1832 <ReturnValue> 1833 <ReturnType>System.Void</ReturnType> 1834 </ReturnValue> 1835 <Parameters /> 1836 <Docs> 1837 <remarks> 1838 <attribution license="cc4" from="Microsoft" modified="false" /> 1839 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.CreateChildControls" /> method creates instances of the controls that make up the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control and creates default event handlers for their events.</para> 1840 </remarks> 1841 <summary> 1842 <attribution license="cc4" from="Microsoft" modified="false" /> 1843 <para>Creates the individual controls that make up the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control in preparation for posting back or rendering.</para> 1844 </summary> 1845 </Docs> 1846 </Member> 1847 <Member MemberName="CreateUserIconUrl"> 1848 <MemberSignature Language="C#" Value="public virtual string CreateUserIconUrl { set; get; }" /> 1849 <MemberType>Property</MemberType> 1850 <ReturnValue> 1851 <ReturnType>System.String</ReturnType> 1852 </ReturnValue> 1853 <Docs> 1854 <value>To be added.</value> 1855 <remarks>To be added.</remarks> 1856 <since version=".NET 2.0" /> 1857 <summary> 1858 <attribution license="cc4" from="Microsoft" modified="false" /> 1859 <para>Gets or sets the URL of an image to display next to the link to the Web page that contains a <see cref="T:System.Web.UI.WebControls.CreateUserWizard" /> control for the Web site.</para> 1860 </summary> 1861 </Docs> 1862 <AssemblyInfo> 1863 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1864 </AssemblyInfo> 1865 </Member> 1866 <Member MemberName="CreateUserText"> 1867 <MemberSignature Language="C#" Value="public virtual string CreateUserText { set; get; }" /> 1868 <MemberType>Property</MemberType> 1869 <Attributes> 1870 <Attribute> 1871 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 1872 </Attribute> 1873 </Attributes> 1874 <ReturnValue> 1875 <ReturnType>System.String</ReturnType> 1876 </ReturnValue> 1877 <Docs> 1878 <value>To be added.</value> 1879 <since version=".NET 2.0" /> 1880 <remarks> 1881 <attribution license="cc4" from="Microsoft" modified="false" /> 1882 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 1883 </remarks> 1884 <summary> 1885 <attribution license="cc4" from="Microsoft" modified="false" /> 1886 <para>Gets or sets the text of the link to the Web page that contains a <see cref="T:System.Web.UI.WebControls.CreateUserWizard" /> control for the Web site.</para> 1887 </summary> 1888 </Docs> 1889 <AssemblyInfo> 1890 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1891 </AssemblyInfo> 1892 </Member> 1893 <Member MemberName="CreateUserUrl"> 1894 <MemberSignature Language="C#" Value="public virtual string CreateUserUrl { set; get; }" /> 1895 <MemberType>Property</MemberType> 1896 <ReturnValue> 1897 <ReturnType>System.String</ReturnType> 1898 </ReturnValue> 1899 <Docs> 1900 <value>To be added.</value> 1901 <remarks>To be added.</remarks> 1902 <since version=".NET 2.0" /> 1903 <summary> 1904 <attribution license="cc4" from="Microsoft" modified="false" /> 1905 <para>Gets or sets the URL of the Web page that contains a <see cref="T:System.Web.UI.WebControls.CreateUserWizard" /> control for the Web site.</para> 1906 </summary> 1907 </Docs> 1908 <AssemblyInfo> 1909 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1910 </AssemblyInfo> 1911 </Member> 1912 <Member MemberName="CurrentPassword"> 1913 <MemberSignature Language="C#" Value="public virtual string CurrentPassword { get; }" /> 1914 <MemberType>Property</MemberType> 1915 <Attributes> 1916 <Attribute> 1917 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 1918 </Attribute> 1919 <Attribute> 1920 <AttributeName>System.ComponentModel.Browsable(false)</AttributeName> 1921 </Attribute> 1922 <Attribute> 1923 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName> 1924 </Attribute> 1925 </Attributes> 1926 <ReturnValue> 1927 <ReturnType>System.String</ReturnType> 1928 </ReturnValue> 1929 <Docs> 1930 <value>To be added.</value> 1931 <since version=".NET 2.0" /> 1932 <remarks> 1933 <attribution license="cc4" from="Microsoft" modified="false" /> 1934 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.CurrentPassword" /> property contains the current password entered by the user.</para> 1935 <block subset="none" type="note"> 1936 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 1937 </block> 1938 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 1939 </remarks> 1940 <summary> 1941 <attribution license="cc4" from="Microsoft" modified="false" /> 1942 <para>Gets the current password for the user.</para> 1943 </summary> 1944 </Docs> 1945 <AssemblyInfo> 1946 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1947 </AssemblyInfo> 1948 </Member> 1949 <Member MemberName="DisplayUserName"> 1950 <MemberSignature Language="C#" Value="public virtual bool DisplayUserName { set; get; }" /> 1951 <MemberType>Property</MemberType> 1952 <Attributes> 1953 <Attribute> 1954 <AttributeName>System.ComponentModel.DefaultValue(false)</AttributeName> 1955 </Attribute> 1956 </Attributes> 1957 <ReturnValue> 1958 <ReturnType>System.Boolean</ReturnType> 1959 </ReturnValue> 1960 <Docs> 1961 <value>To be added.</value> 1962 <since version=".NET 2.0" /> 1963 <remarks> 1964 <attribution license="cc4" from="Microsoft" modified="false" /> 1965 <para>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 <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control can display a <see cref="T:System.Web.UI.WebControls.TextBox" /> control to accept the user name. </para> 1966 <para>You must set the <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> property to true if the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control will be displayed to users who are not logged on; otherwise, the user will not be able to specify a user name.</para> 1967 </remarks> 1968 <summary> 1969 <attribution license="cc4" from="Microsoft" modified="false" /> 1970 <para>Gets or sets a value indicating whether the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control should display the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> control and label.</para> 1971 </summary> 1972 </Docs> 1973 <AssemblyInfo> 1974 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1975 </AssemblyInfo> 1976 </Member> 1977 <Member MemberName="EditProfileIconUrl"> 1978 <MemberSignature Language="C#" Value="public virtual string EditProfileIconUrl { set; get; }" /> 1979 <MemberType>Property</MemberType> 1980 <ReturnValue> 1981 <ReturnType>System.String</ReturnType> 1982 </ReturnValue> 1983 <Docs> 1984 <value>To be added.</value> 1985 <remarks>To be added.</remarks> 1986 <since version=".NET 2.0" /> 1987 <summary> 1988 <attribution license="cc4" from="Microsoft" modified="false" /> 1989 <para>Gets or sets the URL of an image to display next to the link to the user profile editing page for the Web site.</para> 1990 </summary> 1991 </Docs> 1992 <AssemblyInfo> 1993 <AssemblyVersion>2.0.0.0</AssemblyVersion> 1994 </AssemblyInfo> 1995 </Member> 1996 <Member MemberName="EditProfileText"> 1997 <MemberSignature Language="C#" Value="public virtual string EditProfileText { set; get; }" /> 1998 <MemberType>Property</MemberType> 1999 <Attributes> 2000 <Attribute> 2001 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 2002 </Attribute> 2003 </Attributes> 2004 <ReturnValue> 2005 <ReturnType>System.String</ReturnType> 2006 </ReturnValue> 2007 <Docs> 2008 <value>To be added.</value> 2009 <since version=".NET 2.0" /> 2010 <remarks> 2011 <attribution license="cc4" from="Microsoft" modified="false" /> 2012 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 2013 </remarks> 2014 <summary> 2015 <attribution license="cc4" from="Microsoft" modified="false" /> 2016 <para>Gets or sets the text of the link to the user profile editing page for the Web site.</para> 2017 </summary> 2018 </Docs> 2019 <AssemblyInfo> 2020 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2021 </AssemblyInfo> 2022 </Member> 2023 <Member MemberName="EditProfileUrl"> 2024 <MemberSignature Language="C#" Value="public virtual string EditProfileUrl { set; get; }" /> 2025 <MemberType>Property</MemberType> 2026 <ReturnValue> 2027 <ReturnType>System.String</ReturnType> 2028 </ReturnValue> 2029 <Docs> 2030 <value>To be added.</value> 2031 <remarks>To be added.</remarks> 2032 <since version=".NET 2.0" /> 2033 <summary> 2034 <attribution license="cc4" from="Microsoft" modified="false" /> 2035 <para>Gets or sets the URL of the user profile editing page for the Web site.</para> 2036 </summary> 2037 </Docs> 2038 <AssemblyInfo> 2039 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2040 </AssemblyInfo> 2041 </Member> 2042 <Member MemberName="FailureTextStyle"> 2043 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle FailureTextStyle { get; }" /> 2044 <MemberType>Property</MemberType> 2045 <Attributes> 2046 <Attribute> 2047 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 2048 </Attribute> 2049 <Attribute> 2050 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 2051 </Attribute> 2052 <Attribute> 2053 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 2054 </Attribute> 2055 </Attributes> 2056 <ReturnValue> 2057 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 2058 </ReturnValue> 2059 <Docs> 2060 <value>To be added.</value> 2061 <since version=".NET 2.0" /> 2062 <remarks> 2063 <attribution license="cc4" from="Microsoft" modified="false" /> 2064 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.FailureTextStyle" /> property.</para> 2065 <list type="table"> 2066 <listheader> 2067 <item> 2068 <term> 2069 <para>Setting</para> 2070 </term> 2071 <description> 2072 <para>Description</para> 2073 </description> 2074 </item> 2075 </listheader> 2076 <item> 2077 <term> 2078 <para> BackColor 2079 </para> 2080 </term> 2081 <description> 2082 <para>The color that appears behind the error message text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2083 </description> 2084 </item> 2085 <item> 2086 <term> 2087 <para> BorderColor 2088 </para> 2089 </term> 2090 <description> 2091 <para>The color of the border around the error message text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2092 </description> 2093 </item> 2094 <item> 2095 <term> 2096 <para> BorderStyle 2097 </para> 2098 </term> 2099 <description> 2100 <para>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.</para> 2101 </description> 2102 </item> 2103 <item> 2104 <term> 2105 <para> BorderWidth 2106 </para> 2107 </term> 2108 <description> 2109 <para>The width of the border around the error message text.</para> 2110 </description> 2111 </item> 2112 <item> 2113 <term> 2114 <para> CssClass 2115 </para> 2116 </term> 2117 <description> 2118 <para>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.</para> 2119 </description> 2120 </item> 2121 <item> 2122 <term> 2123 <para> Font-Bold 2124 </para> 2125 </term> 2126 <description> 2127 <para> true to display the error message text in bold type.</para> 2128 </description> 2129 </item> 2130 <item> 2131 <term> 2132 <para> Font-Italic 2133 </para> 2134 </term> 2135 <description> 2136 <para> true to display the error message text in italic type.</para> 2137 </description> 2138 </item> 2139 <item> 2140 <term> 2141 <para> Font-Names 2142 </para> 2143 </term> 2144 <description> 2145 <para>The name of the font face.</para> 2146 </description> 2147 </item> 2148 <item> 2149 <term> 2150 <para> Font-Overline 2151 </para> 2152 </term> 2153 <description> 2154 <para> true to display the error message text with a line above it.</para> 2155 </description> 2156 </item> 2157 <item> 2158 <term> 2159 <para> Font-Size 2160 </para> 2161 </term> 2162 <description> 2163 <para>The size of the text in the error message as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 2164 </description> 2165 </item> 2166 <item> 2167 <term> 2168 <para> Font-Strikeout 2169 </para> 2170 </term> 2171 <description> 2172 <para> true to display the error message text as crossed out.</para> 2173 </description> 2174 </item> 2175 <item> 2176 <term> 2177 <para> Font-Underline 2178 </para> 2179 </term> 2180 <description> 2181 <para> true to display the error message text with an underline.</para> 2182 </description> 2183 </item> 2184 <item> 2185 <term> 2186 <para> ForeColor 2187 </para> 2188 </term> 2189 <description> 2190 <para>The color of the text in the error message text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2191 </description> 2192 </item> 2193 <item> 2194 <term> 2195 <para> Height 2196 </para> 2197 </term> 2198 <description> 2199 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the error message text.</para> 2200 </description> 2201 </item> 2202 <item> 2203 <term> 2204 <para> Width 2205 </para> 2206 </term> 2207 <description> 2208 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the error message text.</para> 2209 </description> 2210 </item> 2211 </list> 2212 </remarks> 2213 <summary> 2214 <attribution license="cc4" from="Microsoft" modified="false" /> 2215 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of error messages on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 2216 </summary> 2217 </Docs> 2218 <AssemblyInfo> 2219 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2220 </AssemblyInfo> 2221 </Member> 2222 <Member MemberName="HelpPageIconUrl"> 2223 <MemberSignature Language="C#" Value="public virtual string HelpPageIconUrl { set; get; }" /> 2224 <MemberType>Property</MemberType> 2225 <ReturnValue> 2226 <ReturnType>System.String</ReturnType> 2227 </ReturnValue> 2228 <Docs> 2229 <value>To be added.</value> 2230 <remarks>To be added.</remarks> 2231 <since version=".NET 2.0" /> 2232 <summary> 2233 <attribution license="cc4" from="Microsoft" modified="false" /> 2234 <para>Gets or sets the URL of an image to display next to the Change Password help page for the Web site.</para> 2235 </summary> 2236 </Docs> 2237 <AssemblyInfo> 2238 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2239 </AssemblyInfo> 2240 </Member> 2241 <Member MemberName="HelpPageText"> 2242 <MemberSignature Language="C#" Value="public virtual string HelpPageText { set; get; }" /> 2243 <MemberType>Property</MemberType> 2244 <Attributes> 2245 <Attribute> 2246 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 2247 </Attribute> 2248 </Attributes> 2249 <ReturnValue> 2250 <ReturnType>System.String</ReturnType> 2251 </ReturnValue> 2252 <Docs> 2253 <value>To be added.</value> 2254 <since version=".NET 2.0" /> 2255 <remarks> 2256 <attribution license="cc4" from="Microsoft" modified="false" /> 2257 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 2258 </remarks> 2259 <summary> 2260 <attribution license="cc4" from="Microsoft" modified="false" /> 2261 <para>Gets or sets the link text to the Change Password help page for the Web site.</para> 2262 </summary> 2263 </Docs> 2264 <AssemblyInfo> 2265 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2266 </AssemblyInfo> 2267 </Member> 2268 <Member MemberName="HelpPageUrl"> 2269 <MemberSignature Language="C#" Value="public virtual string HelpPageUrl { set; get; }" /> 2270 <MemberType>Property</MemberType> 2271 <ReturnValue> 2272 <ReturnType>System.String</ReturnType> 2273 </ReturnValue> 2274 <Docs> 2275 <value>To be added.</value> 2276 <remarks>To be added.</remarks> 2277 <since version=".NET 2.0" /> 2278 <summary> 2279 <attribution license="cc4" from="Microsoft" modified="false" /> 2280 <para>Gets or sets the URL of the Change Password help page for the Web site.</para> 2281 </summary> 2282 </Docs> 2283 <AssemblyInfo> 2284 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2285 </AssemblyInfo> 2286 </Member> 2287 <Member MemberName="HyperLinkStyle"> 2288 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle HyperLinkStyle { get; }" /> 2289 <MemberType>Property</MemberType> 2290 <Attributes> 2291 <Attribute> 2292 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 2293 </Attribute> 2294 <Attribute> 2295 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 2296 </Attribute> 2297 <Attribute> 2298 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 2299 </Attribute> 2300 </Attributes> 2301 <ReturnValue> 2302 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 2303 </ReturnValue> 2304 <Docs> 2305 <value>To be added.</value> 2306 <since version=".NET 2.0" /> 2307 <remarks> 2308 <attribution license="cc4" from="Microsoft" modified="false" /> 2309 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.HyperLinkStyle" /> property.</para> 2310 <list type="table"> 2311 <listheader> 2312 <item> 2313 <term> 2314 <para>Setting</para> 2315 </term> 2316 <description> 2317 <para>Description</para> 2318 </description> 2319 </item> 2320 </listheader> 2321 <item> 2322 <term> 2323 <para> BackColor 2324 </para> 2325 </term> 2326 <description> 2327 <para>The color behind the hyperlink text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2328 </description> 2329 </item> 2330 <item> 2331 <term> 2332 <para> BorderColor 2333 </para> 2334 </term> 2335 <description> 2336 <para>The color of the border around the hyperlinks. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2337 </description> 2338 </item> 2339 <item> 2340 <term> 2341 <para> BorderStyle 2342 </para> 2343 </term> 2344 <description> 2345 <para>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.</para> 2346 </description> 2347 </item> 2348 <item> 2349 <term> 2350 <para> BorderWidth 2351 </para> 2352 </term> 2353 <description> 2354 <para>The width of the border around the hyperlinks.</para> 2355 </description> 2356 </item> 2357 <item> 2358 <term> 2359 <para> CssClass 2360 </para> 2361 </term> 2362 <description> 2363 <para>The cascading style sheet (CSS) class used to render the hyperlinks. If other settings are specified, they will override a style sheet setting.</para> 2364 </description> 2365 </item> 2366 <item> 2367 <term> 2368 <para> Font-Bold 2369 </para> 2370 </term> 2371 <description> 2372 <para> true to display the hyperlinks text in bold type.</para> 2373 </description> 2374 </item> 2375 <item> 2376 <term> 2377 <para> Font-Italic 2378 </para> 2379 </term> 2380 <description> 2381 <para> true to display the hyperlinks text in italic type.</para> 2382 </description> 2383 </item> 2384 <item> 2385 <term> 2386 <para> Font-Names 2387 </para> 2388 </term> 2389 <description> 2390 <para>The name of the font face.</para> 2391 </description> 2392 </item> 2393 <item> 2394 <term> 2395 <para> Font-Overline 2396 </para> 2397 </term> 2398 <description> 2399 <para> true to display the hyperlinks text with a line above it.</para> 2400 </description> 2401 </item> 2402 <item> 2403 <term> 2404 <para> Font-Size 2405 </para> 2406 </term> 2407 <description> 2408 <para>The size of the text in the hyperlinks as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 2409 </description> 2410 </item> 2411 <item> 2412 <term> 2413 <para> Font-Strikeout 2414 </para> 2415 </term> 2416 <description> 2417 <para> true to display the hyperlinks text as crossed out.</para> 2418 </description> 2419 </item> 2420 <item> 2421 <term> 2422 <para> Font-Underline 2423 </para> 2424 </term> 2425 <description> 2426 <para> true to display the hyperlinks text with an underline.</para> 2427 </description> 2428 </item> 2429 <item> 2430 <term> 2431 <para> ForeColor 2432 </para> 2433 </term> 2434 <description> 2435 <para>The color of the text in the hyperlinks. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2436 </description> 2437 </item> 2438 <item> 2439 <term> 2440 <para> Height 2441 </para> 2442 </term> 2443 <description> 2444 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the hyperlinks.</para> 2445 </description> 2446 </item> 2447 <item> 2448 <term> 2449 <para> Width 2450 </para> 2451 </term> 2452 <description> 2453 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the hyperlinks.</para> 2454 </description> 2455 </item> 2456 </list> 2457 </remarks> 2458 <summary> 2459 <attribution license="cc4" from="Microsoft" modified="false" /> 2460 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of hyperlinks on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 2461 </summary> 2462 </Docs> 2463 <AssemblyInfo> 2464 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2465 </AssemblyInfo> 2466 </Member> 2467 <Member MemberName="InstructionText"> 2468 <MemberSignature Language="C#" Value="public virtual string InstructionText { set; get; }" /> 2469 <MemberType>Property</MemberType> 2470 <Attributes> 2471 <Attribute> 2472 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 2473 </Attribute> 2474 </Attributes> 2475 <ReturnValue> 2476 <ReturnType>System.String</ReturnType> 2477 </ReturnValue> 2478 <Docs> 2479 <value>To be added.</value> 2480 <since version=".NET 2.0" /> 2481 <remarks> 2482 <attribution license="cc4" from="Microsoft" modified="false" /> 2483 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.InstructionText" /> property gets or sets informational text that appears on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. The default is <see cref="F:System.String.Empty" />.</para> 2484 <para>Use this property to display general information about your control. You can also use the <see cref="P:System.Web.UI.WebControls.ChangePassword.PasswordHintText" /> property to display instructions about password requirements specified in the membership provider or in the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property.</para> 2485 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 2486 </remarks> 2487 <summary> 2488 <attribution license="cc4" from="Microsoft" modified="false" /> 2489 <para>Gets or sets informational text that appears on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control between the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTitleText" /> and the input boxes.</para> 2490 </summary> 2491 </Docs> 2492 <AssemblyInfo> 2493 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2494 </AssemblyInfo> 2495 </Member> 2496 <Member MemberName="InstructionTextStyle"> 2497 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle InstructionTextStyle { get; }" /> 2498 <MemberType>Property</MemberType> 2499 <Attributes> 2500 <Attribute> 2501 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 2502 </Attribute> 2503 <Attribute> 2504 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 2505 </Attribute> 2506 <Attribute> 2507 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 2508 </Attribute> 2509 </Attributes> 2510 <ReturnValue> 2511 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 2512 </ReturnValue> 2513 <Docs> 2514 <value>To be added.</value> 2515 <since version=".NET 2.0" /> 2516 <remarks> 2517 <attribution license="cc4" from="Microsoft" modified="false" /> 2518 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.InstructionTextStyle" /> property.</para> 2519 <list type="table"> 2520 <listheader> 2521 <item> 2522 <term> 2523 <para>Setting</para> 2524 </term> 2525 <description> 2526 <para>Description</para> 2527 </description> 2528 </item> 2529 </listheader> 2530 <item> 2531 <term> 2532 <para> BackColor 2533 </para> 2534 </term> 2535 <description> 2536 <para>The color behind the instructional text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2537 </description> 2538 </item> 2539 <item> 2540 <term> 2541 <para> BorderColor 2542 </para> 2543 </term> 2544 <description> 2545 <para>The color of the border around the instructional text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2546 </description> 2547 </item> 2548 <item> 2549 <term> 2550 <para> BorderStyle 2551 </para> 2552 </term> 2553 <description> 2554 <para>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.</para> 2555 </description> 2556 </item> 2557 <item> 2558 <term> 2559 <para> BorderWidth 2560 </para> 2561 </term> 2562 <description> 2563 <para>The width of the border around the instructional text.</para> 2564 </description> 2565 </item> 2566 <item> 2567 <term> 2568 <para> CssClass 2569 </para> 2570 </term> 2571 <description> 2572 <para>The cascading style sheet (CSS) class used to render the instructional text. If other settings are specified, they will override a style sheet setting.</para> 2573 </description> 2574 </item> 2575 <item> 2576 <term> 2577 <para> Font-Bold 2578 </para> 2579 </term> 2580 <description> 2581 <para> true to display the instructional text in bold type.</para> 2582 </description> 2583 </item> 2584 <item> 2585 <term> 2586 <para> Font-Italic 2587 </para> 2588 </term> 2589 <description> 2590 <para> true to display the instructional text in italic type.</para> 2591 </description> 2592 </item> 2593 <item> 2594 <term> 2595 <para> Font-Names 2596 </para> 2597 </term> 2598 <description> 2599 <para>The name of the font face.</para> 2600 </description> 2601 </item> 2602 <item> 2603 <term> 2604 <para> Font-Overline 2605 </para> 2606 </term> 2607 <description> 2608 <para> true to display the instructional text with a line above it.</para> 2609 </description> 2610 </item> 2611 <item> 2612 <term> 2613 <para> Font-Size 2614 </para> 2615 </term> 2616 <description> 2617 <para>The size of the text in the instructional text as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 2618 </description> 2619 </item> 2620 <item> 2621 <term> 2622 <para> Font-Strikeout 2623 </para> 2624 </term> 2625 <description> 2626 <para> true to display the instructional text as crossed out.</para> 2627 </description> 2628 </item> 2629 <item> 2630 <term> 2631 <para> Font-Underline 2632 </para> 2633 </term> 2634 <description> 2635 <para> true to display the instructional text with an underline.</para> 2636 </description> 2637 </item> 2638 <item> 2639 <term> 2640 <para> ForeColor 2641 </para> 2642 </term> 2643 <description> 2644 <para>The color of the text in the instructional text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2645 </description> 2646 </item> 2647 <item> 2648 <term> 2649 <para> Height 2650 </para> 2651 </term> 2652 <description> 2653 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the instructional text.</para> 2654 </description> 2655 </item> 2656 <item> 2657 <term> 2658 <para> Width 2659 </para> 2660 </term> 2661 <description> 2662 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the instructional text.</para> 2663 </description> 2664 </item> 2665 </list> 2666 </remarks> 2667 <summary> 2668 <attribution license="cc4" from="Microsoft" modified="false" /> 2669 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of the instructional text on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 2670 </summary> 2671 </Docs> 2672 <AssemblyInfo> 2673 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2674 </AssemblyInfo> 2675 </Member> 2676 <Member MemberName="LabelStyle"> 2677 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle LabelStyle { get; }" /> 2678 <MemberType>Property</MemberType> 2679 <Attributes> 2680 <Attribute> 2681 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 2682 </Attribute> 2683 <Attribute> 2684 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 2685 </Attribute> 2686 <Attribute> 2687 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 2688 </Attribute> 2689 </Attributes> 2690 <ReturnValue> 2691 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 2692 </ReturnValue> 2693 <Docs> 2694 <value>To be added.</value> 2695 <since version=".NET 2.0" /> 2696 <remarks> 2697 <attribution license="cc4" from="Microsoft" modified="false" /> 2698 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.LabelStyle" /> property.</para> 2699 <list type="table"> 2700 <listheader> 2701 <item> 2702 <term> 2703 <para>Setting</para> 2704 </term> 2705 <description> 2706 <para>Description</para> 2707 </description> 2708 </item> 2709 </listheader> 2710 <item> 2711 <term> 2712 <para> BackColor 2713 </para> 2714 </term> 2715 <description> 2716 <para>The color behind the text box labels. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2717 </description> 2718 </item> 2719 <item> 2720 <term> 2721 <para> BorderColor 2722 </para> 2723 </term> 2724 <description> 2725 <para>The color of the border around the text box labels. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2726 </description> 2727 </item> 2728 <item> 2729 <term> 2730 <para> BorderStyle 2731 </para> 2732 </term> 2733 <description> 2734 <para>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.</para> 2735 </description> 2736 </item> 2737 <item> 2738 <term> 2739 <para> BorderWidth 2740 </para> 2741 </term> 2742 <description> 2743 <para>The width of the border around the text box labels.</para> 2744 </description> 2745 </item> 2746 <item> 2747 <term> 2748 <para> CssClass 2749 </para> 2750 </term> 2751 <description> 2752 <para>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.</para> 2753 </description> 2754 </item> 2755 <item> 2756 <term> 2757 <para> Font-Bold 2758 </para> 2759 </term> 2760 <description> 2761 <para> true to display the text box labels text in bold type.</para> 2762 </description> 2763 </item> 2764 <item> 2765 <term> 2766 <para> Font-Italic 2767 </para> 2768 </term> 2769 <description> 2770 <para> true to display the text box labels text in italic type.</para> 2771 </description> 2772 </item> 2773 <item> 2774 <term> 2775 <para> Font-Names 2776 </para> 2777 </term> 2778 <description> 2779 <para>The name of the font face.</para> 2780 </description> 2781 </item> 2782 <item> 2783 <term> 2784 <para> Font-Overline 2785 </para> 2786 </term> 2787 <description> 2788 <para> true to display the text box labels text with a line above it.</para> 2789 </description> 2790 </item> 2791 <item> 2792 <term> 2793 <para> Font-Size 2794 </para> 2795 </term> 2796 <description> 2797 <para>The size of the text in the text box labels as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 2798 </description> 2799 </item> 2800 <item> 2801 <term> 2802 <para> Font-Strikeout 2803 </para> 2804 </term> 2805 <description> 2806 <para> true to display the text box labels text as crossed out.</para> 2807 </description> 2808 </item> 2809 <item> 2810 <term> 2811 <para> Font-Underline 2812 </para> 2813 </term> 2814 <description> 2815 <para> true to display the text box labels text with an underline.</para> 2816 </description> 2817 </item> 2818 <item> 2819 <term> 2820 <para> ForeColor 2821 </para> 2822 </term> 2823 <description> 2824 <para>The color of the text in the text box labels. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 2825 </description> 2826 </item> 2827 <item> 2828 <term> 2829 <para> Height 2830 </para> 2831 </term> 2832 <description> 2833 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the text box labels.</para> 2834 </description> 2835 </item> 2836 <item> 2837 <term> 2838 <para> Width 2839 </para> 2840 </term> 2841 <description> 2842 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the text box labels.</para> 2843 </description> 2844 </item> 2845 </list> 2846 </remarks> 2847 <summary> 2848 <attribution license="cc4" from="Microsoft" modified="false" /> 2849 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> objects that define the appearance of text box labels on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 2850 </summary> 2851 </Docs> 2852 <AssemblyInfo> 2853 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2854 </AssemblyInfo> 2855 </Member> 2856 <Member MemberName="LoadControlState"> 2857 <MemberSignature Language="C#" Value="protected override void LoadControlState (object savedState);" /> 2858 <MemberType>Method</MemberType> 2859 <AssemblyInfo> 2860 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2861 </AssemblyInfo> 2862 <ReturnValue> 2863 <ReturnType>System.Void</ReturnType> 2864 </ReturnValue> 2865 <Parameters> 2866 <Parameter Name="savedState" Type="System.Object" /> 2867 </Parameters> 2868 <Docs> 2869 <remarks> 2870 <attribution license="cc4" from="Microsoft" modified="false" /> 2871 <para>Override the <see cref="M:System.Web.UI.WebControls.ChangePassword.LoadControlState(System.Object)" /> method when you need to specify how a custom server control restores its control state. For more information, see <format type="text/html"><a href="96f79173-9d1a-4bde-bf34-1032ebbbe5a9">Server Control Custom State Management</a></format>.</para> 2872 </remarks> 2873 <summary> 2874 <attribution license="cc4" from="Microsoft" modified="false" /> 2875 <para>Restores control state information from a previous page request that was saved by the <see cref="M:System.Web.UI.WebControls.ChangePassword.SaveControlState" /> method.</para> 2876 </summary> 2877 <param name="savedState"> 2878 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the control state to restore.</param> 2879 </Docs> 2880 </Member> 2881 <Member MemberName="LoadViewState"> 2882 <MemberSignature Language="C#" Value="protected override void LoadViewState (object savedState);" /> 2883 <MemberType>Method</MemberType> 2884 <ReturnValue> 2885 <ReturnType>System.Void</ReturnType> 2886 </ReturnValue> 2887 <Parameters> 2888 <Parameter Name="savedState" Type="System.Object" /> 2889 </Parameters> 2890 <Docs> 2891 <since version=".NET 2.0" /> 2892 <remarks> 2893 <attribution license="cc4" from="Microsoft" modified="false" /> 2894 <para>Override the <see cref="M:System.Web.UI.WebControls.ChangePassword.LoadViewState(System.Object)" /> method when you need to specify how a custom server control restores its view state. For more information, see <format type="text/html"><a href="96f79173-9d1a-4bde-bf34-1032ebbbe5a9">Server Control Custom State Management</a></format>.</para> 2895 </remarks> 2896 <summary> 2897 <attribution license="cc4" from="Microsoft" modified="false" /> 2898 <para>Restores view state information from a previous page request that was saved by the <see cref="M:System.Web.UI.WebControls.ChangePassword.SaveViewState" /> method.</para> 2899 </summary> 2900 <param name="savedState"> 2901 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the control state to restore.</param> 2902 </Docs> 2903 <AssemblyInfo> 2904 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2905 </AssemblyInfo> 2906 </Member> 2907 <Member MemberName="MailDefinition"> 2908 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.MailDefinition MailDefinition { get; }" /> 2909 <MemberType>Property</MemberType> 2910 <Attributes> 2911 <Attribute> 2912 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 2913 </Attribute> 2914 <Attribute> 2915 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 2916 </Attribute> 2917 <Attribute> 2918 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 2919 </Attribute> 2920 <Attribute> 2921 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 2922 </Attribute> 2923 </Attributes> 2924 <ReturnValue> 2925 <ReturnType>System.Web.UI.WebControls.MailDefinition</ReturnType> 2926 </ReturnValue> 2927 <Docs> 2928 <value>To be added.</value> 2929 <since version=".NET 2.0" /> 2930 <remarks> 2931 <attribution license="cc4" from="Microsoft" modified="false" /> 2932 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> 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 <see cref="T:System.Web.UI.WebControls.MailDefinition" />.</para> 2933 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> property is read-only; however, you can set the properties of the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> object it returns. You can set these properties in the form property-subproperty, where subproperty represents a property of the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> class (for example, MailDefinition-Subject). You can also set the properties programmatically in the form Property.Subproperty (for example,MailDefinition.Subject).</para> 2934 <para>An e-mail message is sent only if the user has an e-mail address registered with the membership provider and if the <see cref="P:System.Web.UI.WebControls.MailDefinition.BodyFileName" /> property of the <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> property points to a valid file. If the <see cref="P:System.Web.UI.WebControls.MailDefinition.BodyFileName" /> property is set, the <see cref="P:System.Web.UI.WebControls.MailDefinition.From" /> property must be set to an e-mail address; otherwise, an <see cref="T:System.Web.HttpException" /> exception is thrown.</para> 2935 <para>If the e-mail message is created from the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> object, it will make the substitutions shown in the following table. The substitution text is case-insensitive.</para> 2936 <list type="table"> 2937 <listheader> 2938 <item> 2939 <term> 2940 <para>Substitution text</para> 2941 </term> 2942 <description> 2943 <para>Replaced with</para> 2944 </description> 2945 </item> 2946 </listheader> 2947 <item> 2948 <term> 2949 <para> <system><%</system> 2950 <paramref name="UserName" /> 2951 <system>%></system> 2952 </para> 2953 </term> 2954 <description> 2955 <para>The Web site user name of the user.</para> 2956 </description> 2957 </item> 2958 <item> 2959 <term> 2960 <para> <system><%</system> 2961 Password 2962 <system>%></system> 2963 </para> 2964 </term> 2965 <description> 2966 <para>The new password for the user.</para> 2967 </description> 2968 </item> 2969 </list> 2970 <para>If the <see cref="P:System.Web.UI.WebControls.MailDefinition.IsBodyHtml" /> property of the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> 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.</para> 2971 <para>You can use the <see cref="E:System.Web.UI.WebControls.ChangePassword.SendingMail" /> event to modify the <see cref="T:System.Net.Mail.MailMessage" /> object that is created by the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> object.</para> 2972 <block subset="none" type="note"> 2973 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 2974 </block> 2975 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 2976 </remarks> 2977 <summary> 2978 <attribution license="cc4" from="Microsoft" modified="false" /> 2979 <para>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.</para> 2980 </summary> 2981 </Docs> 2982 <AssemblyInfo> 2983 <AssemblyVersion>2.0.0.0</AssemblyVersion> 2984 </AssemblyInfo> 2985 </Member> 2986 <Member MemberName="MembershipProvider"> 2987 <MemberSignature Language="C#" Value="public virtual string MembershipProvider { set; get; }" /> 2988 <MemberType>Property</MemberType> 2989 <Attributes> 2990 <Attribute> 2991 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 2992 </Attribute> 2993 <Attribute> 2994 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 2995 </Attribute> 2996 </Attributes> 2997 <ReturnValue> 2998 <ReturnType>System.String</ReturnType> 2999 </ReturnValue> 3000 <Docs> 3001 <value>To be added.</value> 3002 <since version=".NET 2.0" /> 3003 <remarks> 3004 <attribution license="cc4" from="Microsoft" modified="false" /> 3005 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> property gets or sets the membership provider that is used to look up member information. If the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> 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 <format type="text/html"><a href="d2c90ff6-aa86-4001-b2c5-e5c99cb7f68f">Membership Providers</a></format>.</para> 3006 <para>The new password must meet the minimum requirements set by the membership provider in the <see cref="P:System.Web.Security.Membership.MinRequiredPasswordLength" />, <see cref="P:System.Web.Security.Membership.MinRequiredNonAlphanumericCharacters" />, and <see cref="P:System.Web.Security.Membership.PasswordStrengthRegularExpression" /> properties. If the password does not meet these requirements, the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event is raised. </para> 3007 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 3008 </remarks> 3009 <summary> 3010 <attribution license="cc4" from="Microsoft" modified="false" /> 3011 <para>Gets or sets the membership provider that is used to manage member information.</para> 3012 </summary> 3013 </Docs> 3014 <AssemblyInfo> 3015 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3016 </AssemblyInfo> 3017 </Member> 3018 <Member MemberName="NewPassword"> 3019 <MemberSignature Language="C#" Value="public virtual string NewPassword { get; }" /> 3020 <MemberType>Property</MemberType> 3021 <Attributes> 3022 <Attribute> 3023 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 3024 </Attribute> 3025 <Attribute> 3026 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName> 3027 </Attribute> 3028 </Attributes> 3029 <ReturnValue> 3030 <ReturnType>System.String</ReturnType> 3031 </ReturnValue> 3032 <Docs> 3033 <value>To be added.</value> 3034 <since version=".NET 2.0" /> 3035 <remarks> 3036 <attribution license="cc4" from="Microsoft" modified="false" /> 3037 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPassword" /> property contains the new password entered by the user.</para> 3038 <para>You can use the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property to define the requirements for the new password. This regular expression is used to enforce password rules on the client side. The <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> 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 <format type="text/html"><a href="d2c90ff6-aa86-4001-b2c5-e5c99cb7f68f">membership provider</a></format> in the <see cref="P:System.Web.Security.Membership.MinRequiredPasswordLength" />, <see cref="P:System.Web.Security.Membership.MinRequiredNonAlphanumericCharacters" />, and <see cref="P:System.Web.Security.Membership.PasswordStrengthRegularExpression" /> properties. If the password does not meet these requirements, the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event is raised.</para> 3039 <block subset="none" type="note"> 3040 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 3041 </block> 3042 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 3043 </remarks> 3044 <summary> 3045 <attribution license="cc4" from="Microsoft" modified="false" /> 3046 <para>Gets the new password entered by the user.</para> 3047 </summary> 3048 </Docs> 3049 <AssemblyInfo> 3050 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3051 </AssemblyInfo> 3052 </Member> 3053 <Member MemberName="NewPasswordLabelText"> 3054 <MemberSignature Language="C#" Value="public virtual string NewPasswordLabelText { set; get; }" /> 3055 <MemberType>Property</MemberType> 3056 <Attributes> 3057 <Attribute> 3058 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 3059 </Attribute> 3060 </Attributes> 3061 <ReturnValue> 3062 <ReturnType>System.String</ReturnType> 3063 </ReturnValue> 3064 <Docs> 3065 <value>To be added.</value> 3066 <since version=".NET 2.0" /> 3067 <remarks> 3068 <attribution license="cc4" from="Microsoft" modified="false" /> 3069 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 3070 </remarks> 3071 <summary> 3072 <attribution license="cc4" from="Microsoft" modified="false" /> 3073 <para>Gets or sets the label text for the New Password text box.</para> 3074 </summary> 3075 </Docs> 3076 <AssemblyInfo> 3077 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3078 </AssemblyInfo> 3079 </Member> 3080 <Member MemberName="NewPasswordRegularExpression"> 3081 <MemberSignature Language="C#" Value="public virtual string NewPasswordRegularExpression { set; get; }" /> 3082 <MemberType>Property</MemberType> 3083 <ReturnValue> 3084 <ReturnType>System.String</ReturnType> 3085 </ReturnValue> 3086 <Docs> 3087 <value>To be added.</value> 3088 <since version=".NET 2.0" /> 3089 <remarks> 3090 <attribution license="cc4" from="Microsoft" modified="false" /> 3091 <para>Use the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> 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 <format type="text/html"><a href="d2c90ff6-aa86-4001-b2c5-e5c99cb7f68f">membership provider</a></format> in the <see cref="P:System.Web.Security.Membership.MinRequiredPasswordLength" />, <see cref="P:System.Web.Security.Membership.MinRequiredNonAlphanumericCharacters" />, and <see cref="P:System.Web.Security.Membership.PasswordStrengthRegularExpression" /> properties. If the password does not meet these requirements, the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event is raised.</para> 3092 <para>To display requirements to the user, set the <see cref="P:System.Web.UI.WebControls.ChangePassword.PasswordHintText" /> property.</para> 3093 <para>If the password entered does not pass the regular expression contained in the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property, the text contained in the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpressionErrorMessage" /> property is displayed to the user.</para> 3094 <para>If the password is rejected by the membership provider, the text contained in the <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordFailureText" /> property is displayed.</para> 3095 <para>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 <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> 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 <format type="text/html"><a href="2dab2012-c278-426a-bb0d-93b260c428a7">Securing Membership</a></format>.</para> 3096 </remarks> 3097 <summary> 3098 <attribution license="cc4" from="Microsoft" modified="false" /> 3099 <para>Gets or sets the regular expression that is used to validate the password provided by the user.</para> 3100 </summary> 3101 </Docs> 3102 <AssemblyInfo> 3103 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3104 </AssemblyInfo> 3105 </Member> 3106 <Member MemberName="NewPasswordRegularExpressionErrorMessage"> 3107 <MemberSignature Language="C#" Value="public virtual string NewPasswordRegularExpressionErrorMessage { set; get; }" /> 3108 <MemberType>Property</MemberType> 3109 <ReturnValue> 3110 <ReturnType>System.String</ReturnType> 3111 </ReturnValue> 3112 <Docs> 3113 <value>To be added.</value> 3114 <since version=".NET 2.0" /> 3115 <remarks> 3116 <attribution license="cc4" from="Microsoft" modified="false" /> 3117 <para>Use the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpressionErrorMessage" /> property to inform the user that the password entered does not pass the regular expression defined in the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property. </para> 3118 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpressionErrorMessage" /> 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 <format type="text/html"><a href="d2c90ff6-aa86-4001-b2c5-e5c99cb7f68f">membership provider</a></format> in the <see cref="P:System.Web.Security.Membership.MinRequiredPasswordLength" />, <see cref="P:System.Web.Security.Membership.MinRequiredNonAlphanumericCharacters" />, and <see cref="P:System.Web.Security.Membership.PasswordStrengthRegularExpression" /> properties. If the password does not meet these requirements, the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event is raised.</para> 3119 </remarks> 3120 <summary> 3121 <attribution license="cc4" from="Microsoft" modified="false" /> 3122 <para>Gets or sets the error message that is shown when the password entered does not pass the regular expression criteria defined in the <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property.</para> 3123 </summary> 3124 </Docs> 3125 <AssemblyInfo> 3126 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3127 </AssemblyInfo> 3128 </Member> 3129 <Member MemberName="NewPasswordRequiredErrorMessage"> 3130 <MemberSignature Language="C#" Value="public virtual string NewPasswordRequiredErrorMessage { set; get; }" /> 3131 <MemberType>Property</MemberType> 3132 <Attributes> 3133 <Attribute> 3134 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 3135 </Attribute> 3136 </Attributes> 3137 <ReturnValue> 3138 <ReturnType>System.String</ReturnType> 3139 </ReturnValue> 3140 <Docs> 3141 <value>To be added.</value> 3142 <since version=".NET 2.0" /> 3143 <remarks> 3144 <attribution license="cc4" from="Microsoft" modified="false" /> 3145 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 3146 </remarks> 3147 <summary> 3148 <attribution license="cc4" from="Microsoft" modified="false" /> 3149 <para>Gets or sets the error message that is displayed when the user leaves the New Password text box empty.</para> 3150 </summary> 3151 </Docs> 3152 <AssemblyInfo> 3153 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3154 </AssemblyInfo> 3155 </Member> 3156 <Member MemberName="OnBubbleEvent"> 3157 <MemberSignature Language="C#" Value="protected override bool OnBubbleEvent (object source, EventArgs e);" /> 3158 <MemberType>Method</MemberType> 3159 <ReturnValue> 3160 <ReturnType>System.Boolean</ReturnType> 3161 </ReturnValue> 3162 <Parameters> 3163 <Parameter Name="source" Type="System.Object" /> 3164 <Parameter Name="e" Type="System.EventArgs" /> 3165 </Parameters> 3166 <Docs> 3167 <since version=".NET 2.0" /> 3168 <remarks> 3169 <attribution license="cc4" from="Microsoft" modified="false" /> 3170 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> 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.</para> 3171 </remarks> 3172 <summary> 3173 <attribution license="cc4" from="Microsoft" modified="false" /> 3174 <para>Determines whether the event for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control is passed up the Web server control hierarchy for the page.</para> 3175 </summary> 3176 <returns> 3177 <attribution license="cc4" from="Microsoft" modified="false" /> 3178 <para> true if the event has been canceled; otherwise, false. The default is false.</para> 3179 </returns> 3180 <param name="source"> 3181 <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param> 3182 <param name="e"> 3183 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object that contains the event data.</param> 3184 </Docs> 3185 <AssemblyInfo> 3186 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3187 </AssemblyInfo> 3188 </Member> 3189 <Member MemberName="OnCancelButtonClick"> 3190 <MemberSignature Language="C#" Value="protected virtual void OnCancelButtonClick (EventArgs e);" /> 3191 <MemberType>Method</MemberType> 3192 <ReturnValue> 3193 <ReturnType>System.Void</ReturnType> 3194 </ReturnValue> 3195 <Parameters> 3196 <Parameter Name="e" Type="System.EventArgs" /> 3197 </Parameters> 3198 <Docs> 3199 <remarks>To be added.</remarks> 3200 <since version=".NET 2.0" /> 3201 <summary> 3202 <attribution license="cc4" from="Microsoft" modified="false" /> 3203 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.CancelButtonClick" /> event when a user clicks the Cancel button.</para> 3204 </summary> 3205 <param name="e"> 3206 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object that contains the event data.</param> 3207 </Docs> 3208 <AssemblyInfo> 3209 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3210 </AssemblyInfo> 3211 </Member> 3212 <Member MemberName="OnChangedPassword"> 3213 <MemberSignature Language="C#" Value="protected virtual void OnChangedPassword (EventArgs e);" /> 3214 <MemberType>Method</MemberType> 3215 <ReturnValue> 3216 <ReturnType>System.Void</ReturnType> 3217 </ReturnValue> 3218 <Parameters> 3219 <Parameter Name="e" Type="System.EventArgs" /> 3220 </Parameters> 3221 <Docs> 3222 <since version=".NET 2.0" /> 3223 <remarks> 3224 <attribution license="cc4" from="Microsoft" modified="false" /> 3225 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangedPassword(System.EventArgs)" /> method is called after the password is changed by the membership provider specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> property. After the <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangedPassword(System.EventArgs)" /> method is called, the following occurs: </para> 3226 <list type="bullet"> 3227 <item> 3228 <para>If the <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> property is set, the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control attempts to send an e-mail message to the user.</para> 3229 </item> 3230 <item> 3231 <para>The user is either redirected to the Web site specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessPageUrl" /> property or the control template specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> property is displayed.</para> 3232 </item> 3233 </list> 3234 <para>Raising an event invokes the event handler through a delegate. For more information, see <format type="text/html"><a href="765bfc89-33ee-4d0d-bbe6-3b172c06def9">Server Event Handling in ASP.NET Web Pages</a></format>.</para> 3235 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangedPassword(System.EventArgs)" /> 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.</para> 3236 </remarks> 3237 <summary> 3238 <attribution license="cc4" from="Microsoft" modified="false" /> 3239 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangedPassword" /> event after the password is changed.</para> 3240 </summary> 3241 <param name="e"> 3242 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object that contains the event data. </param> 3243 </Docs> 3244 <AssemblyInfo> 3245 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3246 </AssemblyInfo> 3247 </Member> 3248 <Member MemberName="OnChangePasswordError"> 3249 <MemberSignature Language="C#" Value="protected virtual void OnChangePasswordError (EventArgs e);" /> 3250 <MemberType>Method</MemberType> 3251 <ReturnValue> 3252 <ReturnType>System.Void</ReturnType> 3253 </ReturnValue> 3254 <Parameters> 3255 <Parameter Name="e" Type="System.EventArgs" /> 3256 </Parameters> 3257 <Docs> 3258 <since version=".NET 2.0" /> 3259 <remarks> 3260 <attribution license="cc4" from="Microsoft" modified="false" /> 3261 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangePasswordError(System.EventArgs)" /> method is called when the membership provider specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> property encounters an error while attempting to change the user's password. The specified <see cref="T:System.Web.Security.MembershipProvider" /> object does not indicate the reason why changing the password failed, only that the password was not changed.</para> 3262 <para>Use the <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangePasswordError(System.EventArgs)" /> method to perform a custom action when the user's password is not changed.</para> 3263 <para>Raising an event invokes the event handler through a delegate. For more information, see <format type="text/html"><a href="765bfc89-33ee-4d0d-bbe6-3b172c06def9">Server Event Handling in ASP.NET Web Pages</a></format>.</para> 3264 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangePasswordError(System.EventArgs)" /> 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.</para> 3265 </remarks> 3266 <summary> 3267 <attribution license="cc4" from="Microsoft" modified="false" /> 3268 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangePasswordError" /> event when the user's password is not changed.</para> 3269 </summary> 3270 <param name="e"> 3271 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object that contains the event data.</param> 3272 </Docs> 3273 <AssemblyInfo> 3274 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3275 </AssemblyInfo> 3276 </Member> 3277 <Member MemberName="OnChangingPassword"> 3278 <MemberSignature Language="C#" Value="protected virtual void OnChangingPassword (System.Web.UI.WebControls.LoginCancelEventArgs e);" /> 3279 <MemberType>Method</MemberType> 3280 <ReturnValue> 3281 <ReturnType>System.Void</ReturnType> 3282 </ReturnValue> 3283 <Parameters> 3284 <Parameter Name="e" Type="System.Web.UI.WebControls.LoginCancelEventArgs" /> 3285 </Parameters> 3286 <Docs> 3287 <since version=".NET 2.0" /> 3288 <remarks> 3289 <attribution license="cc4" from="Microsoft" modified="false" /> 3290 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangingPassword(System.Web.UI.WebControls.LoginCancelEventArgs)" /> method is called before the membership provider specified in the <see cref="P:System.Web.UI.WebControls.ChangePassword.MembershipProvider" /> property is called to change the user's password.</para> 3291 <para>Use the <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangingPassword(System.Web.UI.WebControls.LoginCancelEventArgs)" /> 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.</para> 3292 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangingPassword(System.Web.UI.WebControls.LoginCancelEventArgs)" /> method can cancel the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> event by setting the <see cref="P:System.ComponentModel.CancelEventArgs.Cancel" /> property of the <see cref="T:System.ComponentModel.CancelEventArgs" /> object passed as the e parameter to true.</para> 3293 <para>Raising an event invokes the event handler through a delegate. For more information, see <format type="text/html"><a href="765bfc89-33ee-4d0d-bbe6-3b172c06def9">Server Event Handling in ASP.NET Web Pages</a></format>.</para> 3294 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnChangingPassword(System.Web.UI.WebControls.LoginCancelEventArgs)" /> 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.</para> 3295 </remarks> 3296 <summary> 3297 <attribution license="cc4" from="Microsoft" modified="false" /> 3298 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.ChangingPassword" /> event before the user's password is changed by the membership provider.</para> 3299 </summary> 3300 <param name="e"> 3301 <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.CancelEventArgs" /> object containing the event data.</param> 3302 </Docs> 3303 <AssemblyInfo> 3304 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3305 </AssemblyInfo> 3306 </Member> 3307 <Member MemberName="OnContinueButtonClick"> 3308 <MemberSignature Language="C#" Value="protected virtual void OnContinueButtonClick (EventArgs e);" /> 3309 <MemberType>Method</MemberType> 3310 <ReturnValue> 3311 <ReturnType>System.Void</ReturnType> 3312 </ReturnValue> 3313 <Parameters> 3314 <Parameter Name="e" Type="System.EventArgs" /> 3315 </Parameters> 3316 <Docs> 3317 <remarks>To be added.</remarks> 3318 <since version=".NET 2.0" /> 3319 <summary> 3320 <attribution license="cc4" from="Microsoft" modified="false" /> 3321 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.ContinueButtonClick" /> event when a user clicks the Continue button.</para> 3322 </summary> 3323 <param name="e"> 3324 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object that contains the event data.</param> 3325 </Docs> 3326 <AssemblyInfo> 3327 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3328 </AssemblyInfo> 3329 </Member> 3330 <Member MemberName="OnInit"> 3331 <MemberSignature Language="C#" Value="protected override void OnInit (EventArgs e);" /> 3332 <MemberType>Method</MemberType> 3333 <AssemblyInfo> 3334 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3335 </AssemblyInfo> 3336 <ReturnValue> 3337 <ReturnType>System.Void</ReturnType> 3338 </ReturnValue> 3339 <Parameters> 3340 <Parameter Name="e" Type="System.EventArgs" /> 3341 </Parameters> 3342 <Docs> 3343 <remarks> 3344 <attribution license="cc4" from="Microsoft" modified="false" /> 3345 <para>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 <see cref="M:System.Web.UI.WebControls.ChangePassword.OnInit(System.EventArgs)" /> method, regardless of whether it is a child or parent to the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. Other Web server controls are not certain to be created and ready for access.</para> 3346 </remarks> 3347 <summary> 3348 <attribution license="cc4" from="Microsoft" modified="false" /> 3349 <para>Raises the <see cref="E:System.Web.UI.Control.Init" /> event for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control to allow the control to register itself with the page.</para> 3350 </summary> 3351 <param name="e"> 3352 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object containing the event data.</param> 3353 </Docs> 3354 </Member> 3355 <Member MemberName="OnPreRender"> 3356 <MemberSignature Language="C#" Value="protected override void OnPreRender (EventArgs e);" /> 3357 <MemberType>Method</MemberType> 3358 <AssemblyInfo> 3359 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3360 </AssemblyInfo> 3361 <ReturnValue> 3362 <ReturnType>System.Void</ReturnType> 3363 </ReturnValue> 3364 <Parameters> 3365 <Parameter Name="e" Type="System.EventArgs" /> 3366 </Parameters> 3367 <Docs> 3368 <remarks>To be added.</remarks> 3369 <summary> 3370 <attribution license="cc4" from="Microsoft" modified="false" /> 3371 <para>Raises the <see cref="E:System.Web.UI.Control.PreRender" /> event.</para> 3372 </summary> 3373 <param name="e"> 3374 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object containing the event data.</param> 3375 </Docs> 3376 </Member> 3377 <Member MemberName="OnSendingMail"> 3378 <MemberSignature Language="C#" Value="protected virtual void OnSendingMail (System.Web.UI.WebControls.MailMessageEventArgs e);" /> 3379 <MemberType>Method</MemberType> 3380 <ReturnValue> 3381 <ReturnType>System.Void</ReturnType> 3382 </ReturnValue> 3383 <Parameters> 3384 <Parameter Name="e" Type="System.Web.UI.WebControls.MailMessageEventArgs" /> 3385 </Parameters> 3386 <Docs> 3387 <since version=".NET 2.0" /> 3388 <remarks> 3389 <attribution license="cc4" from="Microsoft" modified="false" /> 3390 <para>Use the <see cref="M:System.Web.UI.WebControls.ChangePassword.OnSendingMail(System.Web.UI.WebControls.MailMessageEventArgs)" /> method to modify the e-mail message that is sent to users after they change their password. The <see cref="P:System.Web.UI.WebControls.MailMessageEventArgs.Message" /> property of the <see cref="T:System.Web.UI.WebControls.MailMessageEventArgs" /> object will be sent to the SMTP server for processing. Modify the properties of the <see cref="T:System.Web.Mail.MailMessage" /> object to modify the e-mail message.</para> 3391 <para>E-mail messages are created only when the <see cref="P:System.Web.UI.WebControls.MailDefinition.BodyFileName" /> property of the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> object specified by the <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> property points to a valid file name.</para> 3392 <block subset="none" type="note"> 3393 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 3394 </block> 3395 <para>Raising an event invokes the event handler through a delegate. For more information, see <format type="text/html"><a href="765bfc89-33ee-4d0d-bbe6-3b172c06def9">Server Event Handling in ASP.NET Web Pages</a></format>.</para> 3396 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnSendingMail(System.Web.UI.WebControls.MailMessageEventArgs)" /> 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.</para> 3397 </remarks> 3398 <summary> 3399 <attribution license="cc4" from="Microsoft" modified="false" /> 3400 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.SendingMail" /> 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.</para> 3401 </summary> 3402 <param name="e"> 3403 <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.MailMessageEventArgs" /> object containing the event data.</param> 3404 </Docs> 3405 <AssemblyInfo> 3406 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3407 </AssemblyInfo> 3408 </Member> 3409 <Member MemberName="OnSendMailError"> 3410 <MemberSignature Language="C#" Value="protected virtual void OnSendMailError (System.Web.UI.WebControls.SendMailErrorEventArgs e);" /> 3411 <MemberType>Method</MemberType> 3412 <ReturnValue> 3413 <ReturnType>System.Void</ReturnType> 3414 </ReturnValue> 3415 <Parameters> 3416 <Parameter Name="e" Type="System.Web.UI.WebControls.SendMailErrorEventArgs" /> 3417 </Parameters> 3418 <Docs> 3419 <since version=".NET 2.0" /> 3420 <remarks> 3421 <attribution license="cc4" from="Microsoft" modified="false" /> 3422 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnSendMailError(System.Web.UI.WebControls.SendMailErrorEventArgs)" /> 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. </para> 3423 <para>Examine the <see cref="P:System.Web.UI.WebControls.SendMailErrorEventArgs.Exception" /> property of the <see cref="T:System.Web.UI.WebControls.SendMailErrorEventArgs" /> object passed as the <paramref name="e" /> 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.</para> 3424 <para>You must set the <see cref="P:System.Web.UI.WebControls.SendMailErrorEventArgs.Handled" /> property of the object passed as the <paramref name="e" /> parameter to true to signal that the exception has been taken care of; otherwise, the exception is thrown again.</para> 3425 <para>Raising an event invokes the event handler through a delegate. For more information, see <format type="text/html"><a href="765bfc89-33ee-4d0d-bbe6-3b172c06def9">Server Event Handling in ASP.NET Web Pages</a></format>.</para> 3426 <para>The <see cref="M:System.Web.UI.WebControls.ChangePassword.OnSendMailError(System.Web.UI.WebControls.SendMailErrorEventArgs)" /> 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.</para> 3427 </remarks> 3428 <summary> 3429 <attribution license="cc4" from="Microsoft" modified="false" /> 3430 <para>Raises the <see cref="E:System.Web.UI.WebControls.ChangePassword.SendMailError" /> event when an e-mail message cannot be sent to the user.</para> 3431 </summary> 3432 <param name="e"> 3433 <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.SendMailErrorEventArgs" /> object containing the event data.</param> 3434 </Docs> 3435 <AssemblyInfo> 3436 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3437 </AssemblyInfo> 3438 </Member> 3439 <Member MemberName="PasswordHintStyle"> 3440 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle PasswordHintStyle { get; }" /> 3441 <MemberType>Property</MemberType> 3442 <Attributes> 3443 <Attribute> 3444 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 3445 </Attribute> 3446 <Attribute> 3447 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 3448 </Attribute> 3449 <Attribute> 3450 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 3451 </Attribute> 3452 </Attributes> 3453 <ReturnValue> 3454 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 3455 </ReturnValue> 3456 <Docs> 3457 <value>To be added.</value> 3458 <since version=".NET 2.0" /> 3459 <remarks> 3460 <attribution license="cc4" from="Microsoft" modified="false" /> 3461 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.PasswordHintStyle" /> property.</para> 3462 <list type="table"> 3463 <listheader> 3464 <item> 3465 <term> 3466 <para>Setting</para> 3467 </term> 3468 <description> 3469 <para>Description</para> 3470 </description> 3471 </item> 3472 </listheader> 3473 <item> 3474 <term> 3475 <para> BackColor 3476 </para> 3477 </term> 3478 <description> 3479 <para>The color behind the hint text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 3480 </description> 3481 </item> 3482 <item> 3483 <term> 3484 <para> BorderColor 3485 </para> 3486 </term> 3487 <description> 3488 <para>The color of the border around the hint text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 3489 </description> 3490 </item> 3491 <item> 3492 <term> 3493 <para> BorderStyle 3494 </para> 3495 </term> 3496 <description> 3497 <para>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.</para> 3498 </description> 3499 </item> 3500 <item> 3501 <term> 3502 <para> BorderWidth 3503 </para> 3504 </term> 3505 <description> 3506 <para>The width of the border around the hint text.</para> 3507 </description> 3508 </item> 3509 <item> 3510 <term> 3511 <para> CssClass 3512 </para> 3513 </term> 3514 <description> 3515 <para>The cascading style sheet (CSS) class used to render the hint text. If other settings are specified, they will override a style sheet setting.</para> 3516 </description> 3517 </item> 3518 <item> 3519 <term> 3520 <para> Font-Bold 3521 </para> 3522 </term> 3523 <description> 3524 <para> true to display the hint text in bold type.</para> 3525 </description> 3526 </item> 3527 <item> 3528 <term> 3529 <para> Font-Italic 3530 </para> 3531 </term> 3532 <description> 3533 <para> true to display the hint text in italic type.</para> 3534 </description> 3535 </item> 3536 <item> 3537 <term> 3538 <para> Font-Names 3539 </para> 3540 </term> 3541 <description> 3542 <para>The name of the font face.</para> 3543 </description> 3544 </item> 3545 <item> 3546 <term> 3547 <para> Font-Overline 3548 </para> 3549 </term> 3550 <description> 3551 <para> true to display the hint text with a line above it.</para> 3552 </description> 3553 </item> 3554 <item> 3555 <term> 3556 <para> Font-Size 3557 </para> 3558 </term> 3559 <description> 3560 <para>The size of the text in the hint text as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 3561 </description> 3562 </item> 3563 <item> 3564 <term> 3565 <para> Font-Strikeout 3566 </para> 3567 </term> 3568 <description> 3569 <para> true to display the hint text as crossed out.</para> 3570 </description> 3571 </item> 3572 <item> 3573 <term> 3574 <para> Font-Underline 3575 </para> 3576 </term> 3577 <description> 3578 <para> true to display the hint text with an underline.</para> 3579 </description> 3580 </item> 3581 <item> 3582 <term> 3583 <para> ForeColor 3584 </para> 3585 </term> 3586 <description> 3587 <para>The color of the text in the hint text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 3588 </description> 3589 </item> 3590 <item> 3591 <term> 3592 <para> Height 3593 </para> 3594 </term> 3595 <description> 3596 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the hint text.</para> 3597 </description> 3598 </item> 3599 <item> 3600 <term> 3601 <para> Width 3602 </para> 3603 </term> 3604 <description> 3605 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the hint text.</para> 3606 </description> 3607 </item> 3608 </list> 3609 </remarks> 3610 <summary> 3611 <attribution license="cc4" from="Microsoft" modified="false" /> 3612 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of hint text that appears on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 3613 </summary> 3614 </Docs> 3615 <AssemblyInfo> 3616 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3617 </AssemblyInfo> 3618 </Member> 3619 <Member MemberName="PasswordHintText"> 3620 <MemberSignature Language="C#" Value="public virtual string PasswordHintText { set; get; }" /> 3621 <MemberType>Property</MemberType> 3622 <Attributes> 3623 <Attribute> 3624 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 3625 </Attribute> 3626 </Attributes> 3627 <ReturnValue> 3628 <ReturnType>System.String</ReturnType> 3629 </ReturnValue> 3630 <Docs> 3631 <value>To be added.</value> 3632 <since version=".NET 2.0" /> 3633 <remarks> 3634 <attribution license="cc4" from="Microsoft" modified="false" /> 3635 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.PasswordHintText" /> 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 <see cref="P:System.Web.UI.WebControls.ChangePassword.NewPasswordRegularExpression" /> property.</para> 3636 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 3637 </remarks> 3638 <summary> 3639 <attribution license="cc4" from="Microsoft" modified="false" /> 3640 <para>Gets or sets informational text about the requirements for creating a password for the Web site.</para> 3641 </summary> 3642 </Docs> 3643 <AssemblyInfo> 3644 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3645 </AssemblyInfo> 3646 </Member> 3647 <Member MemberName="PasswordLabelText"> 3648 <MemberSignature Language="C#" Value="public virtual string PasswordLabelText { set; get; }" /> 3649 <MemberType>Property</MemberType> 3650 <Attributes> 3651 <Attribute> 3652 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 3653 </Attribute> 3654 </Attributes> 3655 <ReturnValue> 3656 <ReturnType>System.String</ReturnType> 3657 </ReturnValue> 3658 <Docs> 3659 <value>To be added.</value> 3660 <since version=".NET 2.0" /> 3661 <remarks> 3662 <attribution license="cc4" from="Microsoft" modified="false" /> 3663 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 3664 </remarks> 3665 <summary> 3666 <attribution license="cc4" from="Microsoft" modified="false" /> 3667 <para>Gets or sets the label text for the Current Password text box.</para> 3668 </summary> 3669 </Docs> 3670 <AssemblyInfo> 3671 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3672 </AssemblyInfo> 3673 </Member> 3674 <Member MemberName="PasswordRecoveryIconUrl"> 3675 <MemberSignature Language="C#" Value="public virtual string PasswordRecoveryIconUrl { set; get; }" /> 3676 <MemberType>Property</MemberType> 3677 <ReturnValue> 3678 <ReturnType>System.String</ReturnType> 3679 </ReturnValue> 3680 <Docs> 3681 <value>To be added.</value> 3682 <remarks>To be added.</remarks> 3683 <since version=".NET 2.0" /> 3684 <summary> 3685 <attribution license="cc4" from="Microsoft" modified="false" /> 3686 <para>Gets or sets the URL of an image to display next to a link to the Web page that contains the <see cref="T:System.Web.UI.WebControls.PasswordRecovery" /> control.</para> 3687 </summary> 3688 </Docs> 3689 <AssemblyInfo> 3690 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3691 </AssemblyInfo> 3692 </Member> 3693 <Member MemberName="PasswordRecoveryText"> 3694 <MemberSignature Language="C#" Value="public virtual string PasswordRecoveryText { set; get; }" /> 3695 <MemberType>Property</MemberType> 3696 <Attributes> 3697 <Attribute> 3698 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 3699 </Attribute> 3700 </Attributes> 3701 <ReturnValue> 3702 <ReturnType>System.String</ReturnType> 3703 </ReturnValue> 3704 <Docs> 3705 <value>To be added.</value> 3706 <since version=".NET 2.0" /> 3707 <remarks> 3708 <attribution license="cc4" from="Microsoft" modified="false" /> 3709 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 3710 </remarks> 3711 <summary> 3712 <attribution license="cc4" from="Microsoft" modified="false" /> 3713 <para>Gets or sets the text of the link to the Web page that contains the <see cref="T:System.Web.UI.WebControls.PasswordRecovery" /> control.</para> 3714 </summary> 3715 </Docs> 3716 <AssemblyInfo> 3717 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3718 </AssemblyInfo> 3719 </Member> 3720 <Member MemberName="PasswordRecoveryUrl"> 3721 <MemberSignature Language="C#" Value="public virtual string PasswordRecoveryUrl { set; get; }" /> 3722 <MemberType>Property</MemberType> 3723 <ReturnValue> 3724 <ReturnType>System.String</ReturnType> 3725 </ReturnValue> 3726 <Docs> 3727 <value>To be added.</value> 3728 <remarks>To be added.</remarks> 3729 <since version=".NET 2.0" /> 3730 <summary> 3731 <attribution license="cc4" from="Microsoft" modified="false" /> 3732 <para>Gets or sets the URL of the Web page that contains the <see cref="T:System.Web.UI.WebControls.PasswordRecovery" /> control.</para> 3733 </summary> 3734 </Docs> 3735 <AssemblyInfo> 3736 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3737 </AssemblyInfo> 3738 </Member> 3739 <Member MemberName="PasswordRequiredErrorMessage"> 3740 <MemberSignature Language="C#" Value="public virtual string PasswordRequiredErrorMessage { set; get; }" /> 3741 <MemberType>Property</MemberType> 3742 <Attributes> 3743 <Attribute> 3744 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 3745 </Attribute> 3746 </Attributes> 3747 <ReturnValue> 3748 <ReturnType>System.String</ReturnType> 3749 </ReturnValue> 3750 <Docs> 3751 <value>To be added.</value> 3752 <since version=".NET 2.0" /> 3753 <remarks> 3754 <attribution license="cc4" from="Microsoft" modified="false" /> 3755 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.PasswordRequiredErrorMessage" /> property gets or sets the error message that is displayed when the user leaves the Current Password text box empty. </para> 3756 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 3757 </remarks> 3758 <summary> 3759 <attribution license="cc4" from="Microsoft" modified="false" /> 3760 <para>Gets or sets the error message that is displayed when the user leaves the Current Password text box empty.</para> 3761 </summary> 3762 </Docs> 3763 <AssemblyInfo> 3764 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3765 </AssemblyInfo> 3766 </Member> 3767 <Member MemberName="Render"> 3768 <MemberSignature Language="C#" Value="protected override void Render (System.Web.UI.HtmlTextWriter writer);" /> 3769 <MemberType>Method</MemberType> 3770 <AssemblyInfo> 3771 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3772 </AssemblyInfo> 3773 <ReturnValue> 3774 <ReturnType>System.Void</ReturnType> 3775 </ReturnValue> 3776 <Parameters> 3777 <Parameter Name="writer" Type="System.Web.UI.HtmlTextWriter" /> 3778 </Parameters> 3779 <Docs> 3780 <remarks>To be added.</remarks> 3781 <summary> 3782 <attribution license="cc4" from="Microsoft" modified="false" /> 3783 <para>Writes the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control content to the specified <see cref="T:System.Web.UI.HtmlTextWriter" /> object, for display on the client.</para> 3784 </summary> 3785 <param name="writer"> 3786 <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriter" /> object that represents the output stream used to write content to a Web page.</param> 3787 </Docs> 3788 </Member> 3789 <Member MemberName="SaveControlState"> 3790 <MemberSignature Language="C#" Value="protected override object SaveControlState ();" /> 3791 <MemberType>Method</MemberType> 3792 <AssemblyInfo> 3793 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3794 </AssemblyInfo> 3795 <ReturnValue> 3796 <ReturnType>System.Object</ReturnType> 3797 </ReturnValue> 3798 <Parameters /> 3799 <Docs> 3800 <remarks> 3801 <attribution license="cc4" from="Microsoft" modified="false" /> 3802 <para>Use the <see cref="M:System.Web.UI.WebControls.ChangePassword.SaveControlState" /> method to save state information required for the operation of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. This control state data is stored separately from the view state data for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 3803 <para>Custom controls using control state must call the <see cref="M:System.Web.UI.Page.RegisterRequiresControlState(System.Web.UI.Control)" /> method on the <see cref="P:System.Web.UI.Control.Page" /> object before saving control state.</para> 3804 </remarks> 3805 <summary> 3806 <attribution license="cc4" from="Microsoft" modified="false" /> 3807 <para>Saves any server control state changes that have occurred since the time the page was posted back to the server.</para> 3808 </summary> 3809 <returns> 3810 <attribution license="cc4" from="Microsoft" modified="false" /> 3811 <para>The server control's current state; otherwise, null.</para> 3812 </returns> 3813 </Docs> 3814 </Member> 3815 <Member MemberName="SaveViewState"> 3816 <MemberSignature Language="C#" Value="protected override object SaveViewState ();" /> 3817 <MemberType>Method</MemberType> 3818 <ReturnValue> 3819 <ReturnType>System.Object</ReturnType> 3820 </ReturnValue> 3821 <Parameters /> 3822 <Docs> 3823 <since version=".NET 2.0" /> 3824 <remarks> 3825 <attribution license="cc4" from="Microsoft" modified="false" /> 3826 <para>View state is the accumulation of the values of the properties for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. These values are automatically placed in the <see cref="P:System.Web.UI.Control.ViewState" /> property for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control, which is an instance of the <see cref="T:System.Web.UI.StateBag" /> class. The value for the <see cref="P:System.Web.UI.Control.ViewState" /> property is then persisted to a string object after the save state stage of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control life cycle. For more information, see <format type="text/html"><a href="7949d756-1a79-464e-891f-904b1cfc7991">Control Execution Lifecycle</a></format>.</para> 3827 <para>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 <see cref="M:System.Web.UI.WebControls.ChangePassword.SaveViewState" /> method and modifying the <see cref="P:System.Web.UI.Control.ViewState" /> property for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. </para> 3828 </remarks> 3829 <summary> 3830 <attribution license="cc4" from="Microsoft" modified="false" /> 3831 <para>Saves any server control view state changes that have occurred since the time the page was posted back to the server.</para> 3832 </summary> 3833 <returns> 3834 <attribution license="cc4" from="Microsoft" modified="false" /> 3835 <para>The server control's current view state; otherwise, null.</para> 3836 </returns> 3837 </Docs> 3838 <AssemblyInfo> 3839 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3840 </AssemblyInfo> 3841 </Member> 3842 <Member MemberName="SendingMail"> 3843 <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.MailMessageEventHandler SendingMail;" /> 3844 <MemberType>Event</MemberType> 3845 <ReturnValue> 3846 <ReturnType>System.Web.UI.WebControls.MailMessageEventHandler</ReturnType> 3847 </ReturnValue> 3848 <Docs> 3849 <since version=".NET 2.0" /> 3850 <remarks> 3851 <attribution license="cc4" from="Microsoft" modified="false" /> 3852 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control will send an e-mail message confirming that the password has been changed when the <see cref="P:System.Web.UI.WebControls.ChangePassword.MailDefinition" /> property defines an e-mail message to send. </para> 3853 <para>The e-mail message contains automatic replacement fields for the user name and password. You can use the <see cref="E:System.Web.UI.WebControls.ChangePassword.SendingMail" /> event to modify the e-mail message before it is sent to the user.</para> 3854 <block subset="none" type="note"> 3855 <para>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 <format type="text/html"><a href="d85075bc-9c1a-4453-8a0c-539b10853c9c">Securing Login Controls</a></format>.</para> 3856 </block> 3857 <para>For more information about handling events, see <format type="text/html"><a href="b6f65241-e0ad-4590-a99f-200ce741bb1f">Handling and Raising Events</a></format>. </para> 3858 </remarks> 3859 <summary> 3860 <attribution license="cc4" from="Microsoft" modified="false" /> 3861 <para>Occurs before the user is sent an e-mail confirmation that the password has been changed.</para> 3862 </summary> 3863 </Docs> 3864 <AssemblyInfo> 3865 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3866 </AssemblyInfo> 3867 </Member> 3868 <Member MemberName="SendMailError"> 3869 <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.SendMailErrorEventHandler SendMailError;" /> 3870 <MemberType>Event</MemberType> 3871 <ReturnValue> 3872 <ReturnType>System.Web.UI.WebControls.SendMailErrorEventHandler</ReturnType> 3873 </ReturnValue> 3874 <Docs> 3875 <since version=".NET 2.0" /> 3876 <remarks> 3877 <attribution license="cc4" from="Microsoft" modified="false" /> 3878 <para>The <see cref="E:System.Web.UI.WebControls.ChangePassword.SendMailError" /> 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 <format type="text/html"><a href="220b0329-e384-4e0c-86b4-0945ad17efd9"><smtp></a></format>.</para> 3879 <para>The default <see cref="E:System.Web.UI.WebControls.ChangePassword.SendMailError" /> event handler does not catch or handle the SMTP error from the mail system. Your <see cref="E:System.Web.UI.WebControls.ChangePassword.SendMailError" /> event handler must set the <see cref="P:System.Web.UI.WebControls.SendMailErrorEventArgs.Handled" /> property of the <see cref="T:System.Web.UI.WebControls.SendMailErrorEventArgs" /> object to true in order to stop the error from being displayed to users.</para> 3880 <para>For more information about handling events, see <format type="text/html"><a href="b6f65241-e0ad-4590-a99f-200ce741bb1f">Handling and Raising Events</a></format>. </para> 3881 </remarks> 3882 <summary> 3883 <attribution license="cc4" from="Microsoft" modified="false" /> 3884 <para>Occurs when there is an SMTP error sending an e-mail message to the user.</para> 3885 </summary> 3886 </Docs> 3887 <AssemblyInfo> 3888 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3889 </AssemblyInfo> 3890 </Member> 3891 <Member MemberName="SetDesignModeState"> 3892 <MemberSignature Language="C#" Value="protected override void SetDesignModeState (System.Collections.IDictionary data);" /> 3893 <MemberType>Method</MemberType> 3894 <ReturnValue> 3895 <ReturnType>System.Void</ReturnType> 3896 </ReturnValue> 3897 <Parameters> 3898 <Parameter Name="data" Type="System.Collections.IDictionary" /> 3899 </Parameters> 3900 <Docs> 3901 <remarks>To be added.</remarks> 3902 <since version=".NET 2.0" /> 3903 <summary> 3904 <attribution license="cc4" from="Microsoft" modified="false" /> 3905 <para>Sets design-time data for a control.</para> 3906 </summary> 3907 <param name="data"> 3908 <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> containing the design-time data for the control. </param> 3909 </Docs> 3910 <AssemblyInfo> 3911 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3912 </AssemblyInfo> 3913 </Member> 3914 <Member MemberName="SuccessPageUrl"> 3915 <MemberSignature Language="C#" Value="public virtual string SuccessPageUrl { set; get; }" /> 3916 <MemberType>Property</MemberType> 3917 <Attributes> 3918 <Attribute> 3919 <AttributeName>System.Web.UI.Themeable(false)</AttributeName> 3920 </Attribute> 3921 </Attributes> 3922 <ReturnValue> 3923 <ReturnType>System.String</ReturnType> 3924 </ReturnValue> 3925 <Docs> 3926 <value>To be added.</value> 3927 <since version=".NET 2.0" /> 3928 <remarks> 3929 <attribution license="cc4" from="Microsoft" modified="false" /> 3930 <para>Set the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessPageUrl" /> property when you want users to be redirected to a specific page of your Web site after successfully changing their passwords. If the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessPageUrl" /> property is not set (set is the default), the page containing the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control is refreshed and the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessText" /> property is displayed. If the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessPageUrl" /> property is set, the Success view is not displayed.</para> 3931 <para>This property cannot be set by themes or style sheet themes. For more information, see <see cref="T:System.Web.UI.ThemeableAttribute" /> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">ASP.NET Themes Overview</a></format>.</para> 3932 </remarks> 3933 <summary> 3934 <attribution license="cc4" from="Microsoft" modified="false" /> 3935 <para>Gets or sets the URL of the page that is shown to users after they have changed their password successfully.</para> 3936 </summary> 3937 </Docs> 3938 <AssemblyInfo> 3939 <AssemblyVersion>2.0.0.0</AssemblyVersion> 3940 </AssemblyInfo> 3941 </Member> 3942 <Member MemberName="SuccessTemplate"> 3943 <MemberSignature Language="C#" Value="public virtual System.Web.UI.ITemplate SuccessTemplate { set; get; }" /> 3944 <MemberType>Property</MemberType> 3945 <Attributes> 3946 <Attribute> 3947 <AttributeName>System.ComponentModel.Browsable(false)</AttributeName> 3948 </Attribute> 3949 <Attribute> 3950 <AttributeName>System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ChangePassword))</AttributeName> 3951 </Attribute> 3952 <Attribute> 3953 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 3954 </Attribute> 3955 </Attributes> 3956 <ReturnValue> 3957 <ReturnType>System.Web.UI.ITemplate</ReturnType> 3958 </ReturnValue> 3959 <Docs> 3960 <value>To be added.</value> 3961 <since version=".NET 2.0" /> 3962 <remarks> 3963 <attribution license="cc4" from="Microsoft" modified="false" /> 3964 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> property specifies the <see cref="T:System.Web.UI.ITemplate" /> object that is used by the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. The <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> property is accessible only when using a code-behind file. For more information, see <format type="text/html"><a href="8d7aef0c-d9e3-444b-b3f7-ca0c157eb8b4">Creating Web Server Control Templates Dynamically</a></format>.</para> 3965 <para>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: </para> 3966 <list type="bullet"> 3967 <item> 3968 <para>Templates define the content of a section of a control. </para> 3969 </item> 3970 <item> 3971 <para>Styles specify the appearance of elements in the control. </para> 3972 </item> 3973 </list> 3974 <para>For more information, see <format type="text/html"><a href="f769d290-fd04-4084-85fc-4ea30dd2e8ae">ASP.NET Web Server Controls Templates</a></format> and <format type="text/html"><a href="5df3ebbd-d46c-4502-9406-02f9df4ef2c3">Introduction to ASP.NET Themes</a></format>.</para> 3975 <para>The <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control supports the following templates, which are applied to the corresponding control view.</para> 3976 <list type="table"> 3977 <listheader> 3978 <item> 3979 <term> 3980 <para>Template name</para> 3981 </term> 3982 <description> 3983 <para>Control view</para> 3984 </description> 3985 </item> 3986 </listheader> 3987 <item> 3988 <term> 3989 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.ChangePasswordTemplate" /> 3990 </para> 3991 </term> 3992 <description> 3993 <para>Change Password view</para> 3994 </description> 3995 </item> 3996 <item> 3997 <term> 3998 <para> <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> 3999 </para> 4000 </term> 4001 <description> 4002 <para>Success view</para> 4003 </description> 4004 </item> 4005 </list> 4006 <para>You can also create or modify the template for a control in your .aspx file. For more information, see <format type="text/html"><a href="4977e1d5-c53a-4908-83be-bba0ad37357a">How to: Create Web Server Control Templates Using ASP.NET Syntax</a></format>.</para> 4007 </remarks> 4008 <summary> 4009 <attribution license="cc4" from="Microsoft" modified="false" /> 4010 <para>Gets or sets the <see cref="T:System.Web.UI.ITemplate" /> object that is used to display the Success and Change Password views of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 4011 </summary> 4012 </Docs> 4013 <AssemblyInfo> 4014 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4015 </AssemblyInfo> 4016 </Member> 4017 <Member MemberName="SuccessTemplateContainer"> 4018 <MemberSignature Language="C#" Value="public System.Web.UI.Control SuccessTemplateContainer { get; }" /> 4019 <MemberType>Property</MemberType> 4020 <Attributes> 4021 <Attribute> 4022 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName> 4023 </Attribute> 4024 <Attribute> 4025 <AttributeName>System.ComponentModel.Browsable(false)</AttributeName> 4026 </Attribute> 4027 </Attributes> 4028 <ReturnValue> 4029 <ReturnType>System.Web.UI.Control</ReturnType> 4030 </ReturnValue> 4031 <Docs> 4032 <value>To be added.</value> 4033 <remarks>To be added.</remarks> 4034 <since version=".NET 2.0" /> 4035 <summary> 4036 <attribution license="cc4" from="Microsoft" modified="false" /> 4037 <para>Gets the container that a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control used to create an instance of the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTemplate" /> template. This provides programmatic access to child controls.</para> 4038 </summary> 4039 </Docs> 4040 <AssemblyInfo> 4041 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4042 </AssemblyInfo> 4043 </Member> 4044 <Member MemberName="SuccessText"> 4045 <MemberSignature Language="C#" Value="public virtual string SuccessText { set; get; }" /> 4046 <MemberType>Property</MemberType> 4047 <Attributes> 4048 <Attribute> 4049 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 4050 </Attribute> 4051 </Attributes> 4052 <ReturnValue> 4053 <ReturnType>System.String</ReturnType> 4054 </ReturnValue> 4055 <Docs> 4056 <value>To be added.</value> 4057 <since version=".NET 2.0" /> 4058 <remarks> 4059 <attribution license="cc4" from="Microsoft" modified="false" /> 4060 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessText" /> property gets or sets the text that is displayed on the Success view. The default is "Your password has been changed!".</para> 4061 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 4062 </remarks> 4063 <summary> 4064 <attribution license="cc4" from="Microsoft" modified="false" /> 4065 <para>Gets or sets the text that is displayed on the Success view between the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTitleText" /> and the Continue button.</para> 4066 </summary> 4067 </Docs> 4068 <AssemblyInfo> 4069 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4070 </AssemblyInfo> 4071 </Member> 4072 <Member MemberName="SuccessTextStyle"> 4073 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle SuccessTextStyle { get; }" /> 4074 <MemberType>Property</MemberType> 4075 <Attributes> 4076 <Attribute> 4077 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 4078 </Attribute> 4079 <Attribute> 4080 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 4081 </Attribute> 4082 <Attribute> 4083 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 4084 </Attribute> 4085 </Attributes> 4086 <ReturnValue> 4087 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 4088 </ReturnValue> 4089 <Docs> 4090 <value>To be added.</value> 4091 <since version=".NET 2.0" /> 4092 <remarks> 4093 <attribution license="cc4" from="Microsoft" modified="false" /> 4094 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTextStyle" /> property.</para> 4095 <list type="table"> 4096 <listheader> 4097 <item> 4098 <term> 4099 <para>Setting</para> 4100 </term> 4101 <description> 4102 <para>Description</para> 4103 </description> 4104 </item> 4105 </listheader> 4106 <item> 4107 <term> 4108 <para> BackColor 4109 </para> 4110 </term> 4111 <description> 4112 <para>The color behind the Success view text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4113 </description> 4114 </item> 4115 <item> 4116 <term> 4117 <para> BorderColor 4118 </para> 4119 </term> 4120 <description> 4121 <para>The color of the border around the Success view text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4122 </description> 4123 </item> 4124 <item> 4125 <term> 4126 <para> BorderStyle 4127 </para> 4128 </term> 4129 <description> 4130 <para>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.</para> 4131 </description> 4132 </item> 4133 <item> 4134 <term> 4135 <para> BorderWidth 4136 </para> 4137 </term> 4138 <description> 4139 <para>The width of the border around the Success view text.</para> 4140 </description> 4141 </item> 4142 <item> 4143 <term> 4144 <para> CssClass 4145 </para> 4146 </term> 4147 <description> 4148 <para>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.</para> 4149 </description> 4150 </item> 4151 <item> 4152 <term> 4153 <para> Font-Bold 4154 </para> 4155 </term> 4156 <description> 4157 <para> true to display the Success view text in bold type.</para> 4158 </description> 4159 </item> 4160 <item> 4161 <term> 4162 <para> Font-Italic 4163 </para> 4164 </term> 4165 <description> 4166 <para> true to display the Success view text in italic type.</para> 4167 </description> 4168 </item> 4169 <item> 4170 <term> 4171 <para> Font-Names 4172 </para> 4173 </term> 4174 <description> 4175 <para>The name of the font face.</para> 4176 </description> 4177 </item> 4178 <item> 4179 <term> 4180 <para> Font-Overline 4181 </para> 4182 </term> 4183 <description> 4184 <para> true to display the Success view text with a line above it.</para> 4185 </description> 4186 </item> 4187 <item> 4188 <term> 4189 <para> Font-Size 4190 </para> 4191 </term> 4192 <description> 4193 <para>The size of the text in the Success view text as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 4194 </description> 4195 </item> 4196 <item> 4197 <term> 4198 <para> Font-Strikeout 4199 </para> 4200 </term> 4201 <description> 4202 <para> true to display the Success view text as crossed out.</para> 4203 </description> 4204 </item> 4205 <item> 4206 <term> 4207 <para> Font-Underline 4208 </para> 4209 </term> 4210 <description> 4211 <para> true to display the Success view text with an underline.</para> 4212 </description> 4213 </item> 4214 <item> 4215 <term> 4216 <para> ForeColor 4217 </para> 4218 </term> 4219 <description> 4220 <para>The color of the text in the Success view text. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4221 </description> 4222 </item> 4223 <item> 4224 <term> 4225 <para> Height 4226 </para> 4227 </term> 4228 <description> 4229 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the Success view text.</para> 4230 </description> 4231 </item> 4232 <item> 4233 <term> 4234 <para> Width 4235 </para> 4236 </term> 4237 <description> 4238 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the Success view text.</para> 4239 </description> 4240 </item> 4241 </list> 4242 </remarks> 4243 <summary> 4244 <attribution license="cc4" from="Microsoft" modified="false" /> 4245 <para>Gets a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of text on the Success view.</para> 4246 </summary> 4247 </Docs> 4248 <AssemblyInfo> 4249 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4250 </AssemblyInfo> 4251 </Member> 4252 <Member MemberName="SuccessTitleText"> 4253 <MemberSignature Language="C#" Value="public virtual string SuccessTitleText { set; get; }" /> 4254 <MemberType>Property</MemberType> 4255 <Attributes> 4256 <Attribute> 4257 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 4258 </Attribute> 4259 </Attributes> 4260 <ReturnValue> 4261 <ReturnType>System.String</ReturnType> 4262 </ReturnValue> 4263 <Docs> 4264 <value>To be added.</value> 4265 <since version=".NET 2.0" /> 4266 <remarks> 4267 <attribution license="cc4" from="Microsoft" modified="false" /> 4268 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.SuccessTitleText" /> property gets or sets the title of the Success view. The default is "Change Password Complete".</para> 4269 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 4270 </remarks> 4271 <summary> 4272 <attribution license="cc4" from="Microsoft" modified="false" /> 4273 <para>Gets or sets the title of the Success view.</para> 4274 </summary> 4275 </Docs> 4276 <AssemblyInfo> 4277 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4278 </AssemblyInfo> 4279 </Member> 4280 <Member MemberName="TagKey"> 4281 <MemberSignature Language="C#" Value="protected override System.Web.UI.HtmlTextWriterTag TagKey { get; }" /> 4282 <MemberType>Property</MemberType> 4283 <ReturnValue> 4284 <ReturnType>System.Web.UI.HtmlTextWriterTag</ReturnType> 4285 </ReturnValue> 4286 <Docs> 4287 <value>To be added.</value> 4288 <since version=".NET 2.0" /> 4289 <remarks> 4290 <attribution license="cc4" from="Microsoft" modified="false" /> 4291 <para>Use the <see cref="P:System.Web.UI.WebControls.ChangePassword.TagKey" /> property to determine the <see cref="T:System.Web.UI.HtmlTextWriterTag" /> value that is associated with a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. </para> 4292 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.TagKey" /> property allows the output stream to write the appropriate HTML markup for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 4293 <para>This property is used primarily by control developers.</para> 4294 </remarks> 4295 <summary> 4296 <attribution license="cc4" from="Microsoft" modified="false" /> 4297 <para>Gets the <see cref="T:System.Web.UI.HtmlTextWriterTag" /> value that corresponds to a <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. This property is used primarily by control developers.</para> 4298 </summary> 4299 </Docs> 4300 <AssemblyInfo> 4301 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4302 </AssemblyInfo> 4303 </Member> 4304 <Member MemberName="TextBoxStyle"> 4305 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.Style TextBoxStyle { get; }" /> 4306 <MemberType>Property</MemberType> 4307 <Attributes> 4308 <Attribute> 4309 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 4310 </Attribute> 4311 <Attribute> 4312 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 4313 </Attribute> 4314 <Attribute> 4315 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 4316 </Attribute> 4317 </Attributes> 4318 <ReturnValue> 4319 <ReturnType>System.Web.UI.WebControls.Style</ReturnType> 4320 </ReturnValue> 4321 <Docs> 4322 <value>To be added.</value> 4323 <since version=".NET 2.0" /> 4324 <remarks> 4325 <attribution license="cc4" from="Microsoft" modified="false" /> 4326 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.TextBoxStyle" /> property.</para> 4327 <list type="table"> 4328 <listheader> 4329 <item> 4330 <term> 4331 <para>Setting</para> 4332 </term> 4333 <description> 4334 <para>Description</para> 4335 </description> 4336 </item> 4337 </listheader> 4338 <item> 4339 <term> 4340 <para> BackColor 4341 </para> 4342 </term> 4343 <description> 4344 <para>The background color of text boxes. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4345 </description> 4346 </item> 4347 <item> 4348 <term> 4349 <para> BorderColor 4350 </para> 4351 </term> 4352 <description> 4353 <para>The color of the border around the text boxes. The color can be any of the <see cref="T:System.Drawing.Color" /> properties. </para> 4354 </description> 4355 </item> 4356 <item> 4357 <term> 4358 <para> BorderStyle 4359 </para> 4360 </term> 4361 <description> 4362 <para>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.</para> 4363 </description> 4364 </item> 4365 <item> 4366 <term> 4367 <para> BorderWidth 4368 </para> 4369 </term> 4370 <description> 4371 <para>The width of the border around the text boxes.</para> 4372 </description> 4373 </item> 4374 <item> 4375 <term> 4376 <para> CssClass 4377 </para> 4378 </term> 4379 <description> 4380 <para>The cascading style sheet (CSS) class used to render the text boxes. If other settings are specified, they will override a style sheet setting.</para> 4381 </description> 4382 </item> 4383 <item> 4384 <term> 4385 <para> Font-Bold 4386 </para> 4387 </term> 4388 <description> 4389 <para> true to display the text boxes text in bold type.</para> 4390 </description> 4391 </item> 4392 <item> 4393 <term> 4394 <para> Font-Italic 4395 </para> 4396 </term> 4397 <description> 4398 <para> true to display the text boxes text in italic type.</para> 4399 </description> 4400 </item> 4401 <item> 4402 <term> 4403 <para> Font-Names 4404 </para> 4405 </term> 4406 <description> 4407 <para>The name of the font face.</para> 4408 </description> 4409 </item> 4410 <item> 4411 <term> 4412 <para> Font-Overline 4413 </para> 4414 </term> 4415 <description> 4416 <para> true to display the text boxes text with a line above it.</para> 4417 </description> 4418 </item> 4419 <item> 4420 <term> 4421 <para> Font-Size 4422 </para> 4423 </term> 4424 <description> 4425 <para>The size of the text in the text boxes as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 4426 </description> 4427 </item> 4428 <item> 4429 <term> 4430 <para> Font-Strikeout 4431 </para> 4432 </term> 4433 <description> 4434 <para> true to display the text boxes text as crossed out.</para> 4435 </description> 4436 </item> 4437 <item> 4438 <term> 4439 <para> Font-Underline 4440 </para> 4441 </term> 4442 <description> 4443 <para> true to display the text boxes text with an underline.</para> 4444 </description> 4445 </item> 4446 <item> 4447 <term> 4448 <para> ForeColor 4449 </para> 4450 </term> 4451 <description> 4452 <para>The color of the text in the text boxes. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4453 </description> 4454 </item> 4455 <item> 4456 <term> 4457 <para> Height 4458 </para> 4459 </term> 4460 <description> 4461 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the text boxes.</para> 4462 </description> 4463 </item> 4464 <item> 4465 <term> 4466 <para> Width 4467 </para> 4468 </term> 4469 <description> 4470 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the text boxes.</para> 4471 </description> 4472 </item> 4473 </list> 4474 </remarks> 4475 <summary> 4476 <attribution license="cc4" from="Microsoft" modified="false" /> 4477 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of text box controls on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 4478 </summary> 4479 </Docs> 4480 <AssemblyInfo> 4481 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4482 </AssemblyInfo> 4483 </Member> 4484 <Member MemberName="TitleTextStyle"> 4485 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.TableItemStyle TitleTextStyle { get; }" /> 4486 <MemberType>Property</MemberType> 4487 <Attributes> 4488 <Attribute> 4489 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 4490 </Attribute> 4491 <Attribute> 4492 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 4493 </Attribute> 4494 <Attribute> 4495 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 4496 </Attribute> 4497 </Attributes> 4498 <ReturnValue> 4499 <ReturnType>System.Web.UI.WebControls.TableItemStyle</ReturnType> 4500 </ReturnValue> 4501 <Docs> 4502 <value>To be added.</value> 4503 <since version=".NET 2.0" /> 4504 <remarks> 4505 <attribution license="cc4" from="Microsoft" modified="false" /> 4506 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.TitleTextStyle" /> property.</para> 4507 <list type="table"> 4508 <listheader> 4509 <item> 4510 <term> 4511 <para>Setting</para> 4512 </term> 4513 <description> 4514 <para>Description</para> 4515 </description> 4516 </item> 4517 </listheader> 4518 <item> 4519 <term> 4520 <para> BackColor 4521 </para> 4522 </term> 4523 <description> 4524 <para>The color behind the titles. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4525 </description> 4526 </item> 4527 <item> 4528 <term> 4529 <para> BorderColor 4530 </para> 4531 </term> 4532 <description> 4533 <para>The color of the border around the titles. The color can be any of the <see cref="T:System.Drawing.Color" /> properties. </para> 4534 </description> 4535 </item> 4536 <item> 4537 <term> 4538 <para> BorderStyle 4539 </para> 4540 </term> 4541 <description> 4542 <para>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.</para> 4543 </description> 4544 </item> 4545 <item> 4546 <term> 4547 <para> BorderWidth 4548 </para> 4549 </term> 4550 <description> 4551 <para>The width of the border around the titles.</para> 4552 </description> 4553 </item> 4554 <item> 4555 <term> 4556 <para> CssClass 4557 </para> 4558 </term> 4559 <description> 4560 <para>The cascading style sheet (CSS) class used to render the titles. If other settings are specified, they will override a style sheet setting.</para> 4561 </description> 4562 </item> 4563 <item> 4564 <term> 4565 <para> Font-Bold 4566 </para> 4567 </term> 4568 <description> 4569 <para> true to display the titles text in bold type.</para> 4570 </description> 4571 </item> 4572 <item> 4573 <term> 4574 <para> Font-Italic 4575 </para> 4576 </term> 4577 <description> 4578 <para> true to display the titles text in italic type.</para> 4579 </description> 4580 </item> 4581 <item> 4582 <term> 4583 <para> Font-Names 4584 </para> 4585 </term> 4586 <description> 4587 <para>The name of the font face.</para> 4588 </description> 4589 </item> 4590 <item> 4591 <term> 4592 <para> Font-Overline 4593 </para> 4594 </term> 4595 <description> 4596 <para> true to display the titles text with a line above it.</para> 4597 </description> 4598 </item> 4599 <item> 4600 <term> 4601 <para> Font-Size 4602 </para> 4603 </term> 4604 <description> 4605 <para>The size of the text in the titles as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 4606 </description> 4607 </item> 4608 <item> 4609 <term> 4610 <para> Font-Strikeout 4611 </para> 4612 </term> 4613 <description> 4614 <para> true to display the titles text as crossed out.</para> 4615 </description> 4616 </item> 4617 <item> 4618 <term> 4619 <para> Font-Underline 4620 </para> 4621 </term> 4622 <description> 4623 <para> true to display the titles text with an underline.</para> 4624 </description> 4625 </item> 4626 <item> 4627 <term> 4628 <para> ForeColor 4629 </para> 4630 </term> 4631 <description> 4632 <para>The color of the text in the titles. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4633 </description> 4634 </item> 4635 <item> 4636 <term> 4637 <para> Height 4638 </para> 4639 </term> 4640 <description> 4641 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the titles.</para> 4642 </description> 4643 </item> 4644 <item> 4645 <term> 4646 <para> Width 4647 </para> 4648 </term> 4649 <description> 4650 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the titles.</para> 4651 </description> 4652 </item> 4653 </list> 4654 </remarks> 4655 <summary> 4656 <attribution license="cc4" from="Microsoft" modified="false" /> 4657 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of titles on the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 4658 </summary> 4659 </Docs> 4660 <AssemblyInfo> 4661 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4662 </AssemblyInfo> 4663 </Member> 4664 <Member MemberName="TrackViewState"> 4665 <MemberSignature Language="C#" Value="protected override void TrackViewState ();" /> 4666 <MemberType>Method</MemberType> 4667 <ReturnValue> 4668 <ReturnType>System.Void</ReturnType> 4669 </ReturnValue> 4670 <Parameters /> 4671 <Docs> 4672 <remarks>To be added.</remarks> 4673 <since version=".NET 2.0" /> 4674 <summary> 4675 <attribution license="cc4" from="Microsoft" modified="false" /> 4676 <para>Causes tracking of view-state changes to the server control so that they can be stored in the server control's <see cref="T:System.Web.UI.StateBag" /> object. This object is accessible through the <see cref="P:System.Web.UI.Control.ViewState" /> property. </para> 4677 </summary> 4678 </Docs> 4679 <AssemblyInfo> 4680 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4681 </AssemblyInfo> 4682 </Member> 4683 <Member MemberName="UserName"> 4684 <MemberSignature Language="C#" Value="public virtual string UserName { set; get; }" /> 4685 <MemberType>Property</MemberType> 4686 <Attributes> 4687 <Attribute> 4688 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 4689 </Attribute> 4690 </Attributes> 4691 <ReturnValue> 4692 <ReturnType>System.String</ReturnType> 4693 </ReturnValue> 4694 <Docs> 4695 <value>To be added.</value> 4696 <since version=".NET 2.0" /> 4697 <remarks> 4698 <attribution license="cc4" from="Microsoft" modified="false" /> 4699 <para>The <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> property gets the Web site user name for which to change the password. You can also use the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> property just to get the user name from within the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control, without changing the password. Additionally, the <see cref="P:System.Web.UI.WebControls.ChangePassword.UserName" /> property can be used from within an e-mail message that has been created to send e-mail from the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control by using the string "<%UserName%>" in the body of the e-mail message.</para> 4700 <para>To allow the user to type in a user name, set the <see cref="P:System.Web.UI.WebControls.ChangePassword.DisplayUserName" /> property to true. If a user is already authenticated, he or she does not need to enter a user name.</para> 4701 </remarks> 4702 <summary> 4703 <attribution license="cc4" from="Microsoft" modified="false" /> 4704 <para>Gets or sets the Web site user name for which to change the password.</para> 4705 </summary> 4706 </Docs> 4707 <AssemblyInfo> 4708 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4709 </AssemblyInfo> 4710 </Member> 4711 <Member MemberName="UserNameLabelText"> 4712 <MemberSignature Language="C#" Value="public virtual string UserNameLabelText { set; get; }" /> 4713 <MemberType>Property</MemberType> 4714 <Attributes> 4715 <Attribute> 4716 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 4717 </Attribute> 4718 </Attributes> 4719 <ReturnValue> 4720 <ReturnType>System.String</ReturnType> 4721 </ReturnValue> 4722 <Docs> 4723 <value>To be added.</value> 4724 <since version=".NET 2.0" /> 4725 <remarks> 4726 <attribution license="cc4" from="Microsoft" modified="false" /> 4727 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 4728 </remarks> 4729 <summary> 4730 <attribution license="cc4" from="Microsoft" modified="false" /> 4731 <para>Gets or sets the label for the User Name text box.</para> 4732 </summary> 4733 </Docs> 4734 <AssemblyInfo> 4735 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4736 </AssemblyInfo> 4737 </Member> 4738 <Member MemberName="UserNameRequiredErrorMessage"> 4739 <MemberSignature Language="C#" Value="public virtual string UserNameRequiredErrorMessage { set; get; }" /> 4740 <MemberType>Property</MemberType> 4741 <Attributes> 4742 <Attribute> 4743 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 4744 </Attribute> 4745 </Attributes> 4746 <ReturnValue> 4747 <ReturnType>System.String</ReturnType> 4748 </ReturnValue> 4749 <Docs> 4750 <value>To be added.</value> 4751 <since version=".NET 2.0" /> 4752 <remarks> 4753 <attribution license="cc4" from="Microsoft" modified="false" /> 4754 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 4755 </remarks> 4756 <summary> 4757 <attribution license="cc4" from="Microsoft" modified="false" /> 4758 <para>Gets or sets the error message that is displayed when the user leaves the User Name text box empty.</para> 4759 </summary> 4760 </Docs> 4761 <AssemblyInfo> 4762 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4763 </AssemblyInfo> 4764 </Member> 4765 <Member MemberName="ValidatorTextStyle"> 4766 <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.Style ValidatorTextStyle { get; }" /> 4767 <MemberType>Property</MemberType> 4768 <Attributes> 4769 <Attribute> 4770 <AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)</AttributeName> 4771 </Attribute> 4772 <Attribute> 4773 <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName> 4774 </Attribute> 4775 <Attribute> 4776 <AttributeName>System.ComponentModel.NotifyParentProperty(true)</AttributeName> 4777 </Attribute> 4778 </Attributes> 4779 <ReturnValue> 4780 <ReturnType>System.Web.UI.WebControls.Style</ReturnType> 4781 </ReturnValue> 4782 <Docs> 4783 <value>To be added.</value> 4784 <since version=".NET 2.0" /> 4785 <remarks> 4786 <attribution license="cc4" from="Microsoft" modified="false" /> 4787 <para>The following table lists the style settings that are available for customization with the <see cref="P:System.Web.UI.WebControls.ChangePassword.ValidatorTextStyle" /> property.</para> 4788 <list type="table"> 4789 <listheader> 4790 <item> 4791 <term> 4792 <para>Setting</para> 4793 </term> 4794 <description> 4795 <para>Description</para> 4796 </description> 4797 </item> 4798 </listheader> 4799 <item> 4800 <term> 4801 <para> BackColor 4802 </para> 4803 </term> 4804 <description> 4805 <para>The color behind the error messages. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4806 </description> 4807 </item> 4808 <item> 4809 <term> 4810 <para> BorderColor 4811 </para> 4812 </term> 4813 <description> 4814 <para>The color of the border around the error messages. The color can be any of the <see cref="T:System.Drawing.Color" /> properties. </para> 4815 </description> 4816 </item> 4817 <item> 4818 <term> 4819 <para> BorderStyle 4820 </para> 4821 </term> 4822 <description> 4823 <para>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.</para> 4824 </description> 4825 </item> 4826 <item> 4827 <term> 4828 <para> BorderWidth 4829 </para> 4830 </term> 4831 <description> 4832 <para>The width of the border around the error messages.</para> 4833 </description> 4834 </item> 4835 <item> 4836 <term> 4837 <para> CssClass 4838 </para> 4839 </term> 4840 <description> 4841 <para>The cascading style sheet (CSS) class used to render the error messages. If other settings are specified, they will override a style sheet setting.</para> 4842 </description> 4843 </item> 4844 <item> 4845 <term> 4846 <para> Font-Bold 4847 </para> 4848 </term> 4849 <description> 4850 <para> true to display the error messages text in bold type.</para> 4851 </description> 4852 </item> 4853 <item> 4854 <term> 4855 <para> Font-Italic 4856 </para> 4857 </term> 4858 <description> 4859 <para> true to display the error messages text in italic type.</para> 4860 </description> 4861 </item> 4862 <item> 4863 <term> 4864 <para> Font-Names 4865 </para> 4866 </term> 4867 <description> 4868 <para>The name of the font face.</para> 4869 </description> 4870 </item> 4871 <item> 4872 <term> 4873 <para> Font-Overline 4874 </para> 4875 </term> 4876 <description> 4877 <para> true to display the error messages text with a line above it.</para> 4878 </description> 4879 </item> 4880 <item> 4881 <term> 4882 <para> Font-Size 4883 </para> 4884 </term> 4885 <description> 4886 <para>The size of the text in the error messages as a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para> 4887 </description> 4888 </item> 4889 <item> 4890 <term> 4891 <para> Font-Strikeout 4892 </para> 4893 </term> 4894 <description> 4895 <para> true to display the error messages text as crossed out.</para> 4896 </description> 4897 </item> 4898 <item> 4899 <term> 4900 <para> Font-Underline 4901 </para> 4902 </term> 4903 <description> 4904 <para> true to display the error messages text with an underline.</para> 4905 </description> 4906 </item> 4907 <item> 4908 <term> 4909 <para> ForeColor 4910 </para> 4911 </term> 4912 <description> 4913 <para>The color of the text in the error messages. The color can be any of the <see cref="T:System.Drawing.Color" /> properties.</para> 4914 </description> 4915 </item> 4916 <item> 4917 <term> 4918 <para> Height 4919 </para> 4920 </term> 4921 <description> 4922 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the height of the error messages.</para> 4923 </description> 4924 </item> 4925 <item> 4926 <term> 4927 <para> Width 4928 </para> 4929 </term> 4930 <description> 4931 <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the width of the error messages.</para> 4932 </description> 4933 </item> 4934 </list> 4935 </remarks> 4936 <summary> 4937 <attribution license="cc4" from="Microsoft" modified="false" /> 4938 <para>Gets a reference to a collection of <see cref="T:System.Web.UI.WebControls.Style" /> properties that define the appearance of error messages that are associated with any input validation used by the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para> 4939 </summary> 4940 </Docs> 4941 <AssemblyInfo> 4942 <AssemblyVersion>2.0.0.0</AssemblyVersion> 4943 </AssemblyInfo> 4944 </Member> 4945 </Members> 4946</Type>