ChangePassword 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供使用户能够更改其网站密码的用户界面。
public ref class ChangePassword : System::Web::UI::WebControls::CompositeControl[System.ComponentModel.Bindable(false)]
public class ChangePassword : System.Web.UI.WebControls.CompositeControl[<System.ComponentModel.Bindable(false)>]
type ChangePassword = class
inherit CompositeControl
interface INamingContainerPublic Class ChangePassword
Inherits CompositeControl- 继承
- 属性
- 实现
示例
下面的代码示例演示如何设置 NewPasswordRegularExpression 属性以定义检查密码以确保密码符合以下条件的正则表达式：
大于 6 个字符。
至少包含一位数字。
至少包含一个特殊 (非字母数字) 字符。
属性中包含的 PasswordHintText 密码要求会显示给用户。
如果用户输入的密码不符合 属性的要求 NewPasswordRegularExpression ，则会向用户显示 属性中包含的 NewPasswordRegularExpressionErrorMessage 文本。 如果未输入新密码，则会向用户显示 属性中包含的 NewPasswordRequiredErrorMessage 文本。
注意
新密码必须满足成员资格提供程序在 、 MinRequiredNonAlphanumericCharacters和 PasswordStrengthRegularExpression 属性中MinRequiredPasswordLength设置的最低要求。 如果密码不符合这些要求，则会 ChangePasswordError 引发 事件。
<%@ page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Change Password with Validation</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:changepassword id="ChangePassword1" runat="server"
PasswordHintText =
"Please enter a password at least 7 characters long,
containing a number and one special character."
NewPasswordRegularExpression =
'@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})'
NewPasswordRegularExpressionErrorMessage =
"Error: Your password must be at least 7 characters long,
and contain at least one number and one special character." >
</asp:changepassword>
</div>
</form>
</body>
</html>
<%@ page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Change Password with Validation</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:changepassword id="ChangePassword1" runat="server"
PasswordHintText = "Please enter a password at least 7 characters long, containing a number and one special character."
NewPasswordRegularExpression = '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})'
NewPasswordRegularExpressionErrorMessage = "Your password must be at least 7 characters long, and contain at least one number and one special character.">
</asp:changepassword>
</div>
</form>
</body>
</html>
注解
本主题内容：
介绍
使用页面上的 ChangePassword 控件，使网站用户能够更改他们用于登录网站的密码。
注意
如果不熟悉 ASP.NET 中提供的登录控件集，请先 阅读 ASP.NET 登录控件概述 ，然后再继续。 有关与登录控件和成员身份相关的其他主题的列表，请参阅 使用成员身份管理用户。
重要
通过 HTTP 传输密码是一种潜在的安全威胁。 恶意用户可以查看或入侵 HTTP 传输。 若要提高使用登录控件时的安全性，应将 HTTPS 协议与安全套接字层 (SSL) 加密配合使用，以确保在回发期间无法读取用户的密码。 有关详细信息，请参阅 保护登录控件。
控件 ChangePassword 使用 在 属性中 MembershipProvider 定义的成员资格提供程序更改网站的成员资格提供程序数据存储中存储的密码。 如果不分配成员资格提供程序，该 ChangePassword 控件将使用在 Web.config 文件的 membership 节中定义的默认 成员资格 提供程序。 控件 ChangePassword 使用户能够执行以下操作：
如果已登录，请更改其密码。
如果控件未登录，请更改其密码，前提是包含 ChangePassword 控件的页面允许匿名访问， DisplayUserName 并且 属性为
true。更改用户帐户的密码，即使他们以其他用户身份登录也是如此。 这要求 属性 DisplayUserName 为
true。
将 DisplayUserName 属性设置为 true 将显示“用户名”文本框，该文本框允许用户键入用户名。 如果用户已登录，则 UserName 控件将填充已登录用户的名称。 更改给定用户名的密码后，用户将登录到与更改后的密码关联的帐户，即使用户以前未登录到该帐户。
重要
接受用户输入是潜在的安全威胁。 恶意用户可以发送旨在公开漏洞的数据，或运行尝试生成密码的程序。 为了在处理用户输入时提高安全性，应使用控件的验证功能，并保护为控件配置的任何数据提供程序。 有关详细信息，请参阅 保护登录控件、 Web 应用程序的基本安全做法和 保护成员身份。
发送Email消息
可以将 ChangePassword 控件配置为使用电子邮件服务向用户发送新密码。 若要从任何 ASP.NET Web 服务器控件向用户发送电子邮件，必须在应用程序的 Web.config 文件中配置电子邮件服务器。 有关详细信息，请参阅 如何：在 IIS 6.0 中安装和配置 SMTP 虚拟服务器。
Email消息是使用 MailDefinition 类配置的。 必须设置 BodyFileName 属性以指示 ASP.NET 发送电子邮件。
重要
在电子邮件中发送用户帐户名或密码是潜在的安全威胁。 Email消息通常以纯文本形式发送，可由特殊网络“探查”应用程序读取。 若要提高安全性，请使用 保护登录控件中所述的缓解措施。
注意
无法保证用户将收到或查看电子邮件。 若要验证用户是否已收到消息，请在电子邮件中提供一个确认链接，让用户确认已收到通知。
视图
控件 ChangePassword 有两种状态或视图：
“更改密码”视图 请求当前密码，并要求用户键入新密码两次进行确认。 如果允许未登录的用户更改其密码，请将 属性设置为 DisplayUserName
true以在“更改密码”视图中显示 UserName 控件。 控件 UserName 允许用户提供其注册的用户名。 如果更改密码时出错，“更改密码”视图中会显示一条错误消息，允许用户重试。“成功”视图 提供密码已更改的确认。
重要
更改密码以及用于继续和取消的功能附加到具有正确命令名称的任何按钮，无论该按钮位于哪个视图上。 例如，在“成功”视图中具有 值的
commandname=changepassword按钮将尝试更改密码并导致异常。
样式和模板
可以使用一组广泛的样式属性来自定义控件的外观 ChangePassword 。 或者，如果需要完全控制控件的外观，可以将自定义模板应用于这两个 ChangePassword 视图。 如果为视图定义模板，则会 ControlStyle 应用属性。 有关必须在视图模板中设置的控件的列表，请参阅 ChangePasswordTemplate 和 SuccessTemplate 属性。 如果找不到所需控件、未正确命名或类型错误，控件 ChangePassword 将检查模板中的内容，并引发异常。 例如，如果使用模板中的内容并将 属性设置为 DisplayUserNametrue，ChangePassword则在找不到用户名的 IEditableTextControl 或其他控件时TextBox，将引发异常。
下表列出了 ChangePassword 控件样式属性，并描述了它们影响的 UI 元素。 有关每个样式所应用的属性的列表，请参阅单个样式属性。
| ChangePassword style 属性 | UI 元素 |
|---|---|
| CancelButtonStyle | “更改密码”视图上的“取消”按钮。 |
| ChangePasswordButtonStyle | “更改密码”视图上的“更改密码”按钮。 |
| ContinueButtonStyle | “成功”视图上的“继续”按钮。 |
| FailureTextStyle | 向用户显示的错误文本。 |
| HyperLinkStyle | 指向其他页面的超链接。 |
| InstructionTextStyle | 页面上描述如何使用 控件的说明 ChangePassword 性文本。 |
| LabelStyle | 所有输入字段（如文本框）的标签。 |
| PasswordHintStyle | 为网站提供可接受的密码的提示。 |
| SuccessTextStyle | 成功更改密码后向用户显示的文本。 |
| TextBoxStyle | 文本输入输入字段。 |
| TitleTextStyle | “更改密码”和“成功”视图的标题。 |
应用 CSS 样式
控件 ChangePassword 允许你在标记中指定 CSS 样式规则。 如果使用模板自定义控件的外观 ChangePassword ，则可以在模板的标记中指定 CSS 样式。 在这种情况下，不需要额外的外部表。 可以通过将 属性设置为 RenderOuterTablefalse来防止呈现表。
验证分组
控件 ChangePassword 使用验证组，以便可以单独验证控件所在的同一页上 ChangePassword 的其他字段。 默认情况下， ID 控件的 ChangePassword 属性用作验证组的名称。 例如，ID 为 的ChangePassword控件也将使用验证组名称ChangePassword1。"ChangePassword1" 若要设置控件所属的 ChangePassword 验证组，必须使用控件创建模板，然后更改验证组名称。
若要在用户将控件留 TextBox 空时显示错误消息，请将控件 ValidationSummary 添加到页面。 将 ValidationGroup 控件的 ValidationSummary 属性设置为 ID 控件的 ChangePassword 属性。
访问键和选项卡索引
有关如何使用 控件的 AccessKey 属性和 TabIndex 属性 ChangePassword 的信息，请参阅 Visual Studio 中的辅助功能和 ASP.NET 和 ASP.NET 控件和辅助功能。
可访问性
有关如何配置此控件以便生成符合辅助功能标准的标记的信息，请参阅 Visual Studio 中的辅助功能和 ASP.NET 和 ASP.NET 控件和辅助功能。
在Page_Load和Page_Init期间访问控件
ChangePassword 在页面生命周期的所有阶段都可以访问由文本框（如 UserName 和 CurrentPassword）表示的控件属性。 具体而言，在Page_Init和Page_Load阶段，这些属性的值与呈现控件时 ChangePassword 的值相同。 如果用户通过修改UserName文本框更改属性的值UserName，则引发更改事件（在Page_Load阶段之后发生）时，新值将可用。 因此，如果在Page_Init阶段或Page_Load阶段设置 属性的值 UserName 并为事件提供自定义处理程序 ChangePassword ，则用户在文本框中所做的 UserName 任何更改将替代Page_Init或Page_Load阶段设置的值。
声明性语法
<asp:ChangePassword
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderPadding="integer"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CancelButtonImageUrl="uri"
CancelButtonText="string"
CancelButtonType="Button|Image|Link"
CancelDestinationPageUrl="uri"
ChangePasswordButtonImageUrl="uri"
ChangePasswordButtonText="string"
ChangePasswordButtonType="Button|Image|Link"
ChangePasswordFailureText="string"
ChangePasswordTitleText="string"
ConfirmNewPasswordLabelText="string"
ConfirmPasswordCompareErrorMessage="string"
ConfirmPasswordRequiredErrorMessage="string"
ContinueButtonImageUrl="uri"
ContinueButtonText="string"
ContinueButtonType="Button|Image|Link"
ContinueDestinationPageUrl="uri"
CreateUserIconUrl="uri"
CreateUserText="string"
CreateUserUrl="uri"
CssClass="string"
DisplayUserName="True|False"
EditProfileIconUrl="uri"
EditProfileText="string"
EditProfileUrl="uri"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HelpPageIconUrl="uri"
HelpPageText="string"
HelpPageUrl="uri"
ID="string"
InstructionText="string"
MailDefinition-BodyFileName="uri"
MailDefinition-CC="string"
MailDefinition-From="string"
MailDefinition-IsBodyHtml="True|False"
MailDefinition-Priority="Normal|Low|High"
MailDefinition-Subject="string"
MembershipProvider="string"
NewPasswordLabelText="string"
NewPasswordRegularExpression="string"
NewPasswordRegularExpressionErrorMessage="string"
NewPasswordRequiredErrorMessage="string"
OnCancelButtonClick="CancelButtonClick event handler"
OnChangedPassword="ChangedPassword event handler"
OnChangePasswordError="ChangePasswordError event handler"
OnChangingPassword="ChangingPassword event handler"
OnContinueButtonClick="ContinueButtonClick event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSendingMail="SendingMail event handler"
OnSendMailError="SendMailError event handler"
OnUnload="Unload event handler"
PasswordHintText="string"
PasswordLabelText="string"
PasswordRecoveryIconUrl="uri"
PasswordRecoveryText="string"
PasswordRecoveryUrl="uri"
PasswordRequiredErrorMessage="string"
runat="server"
SkinID="string"
Style="string"
SuccessPageUrl="uri"
SuccessText="string"
SuccessTitleText="string"
TabIndex="integer"
ToolTip="string"
UserName="string"
UserNameLabelText="string"
UserNameRequiredErrorMessage="string"
Visible="True|False"
Width="size"
>
<CancelButtonStyle/>
<ChangePasswordButtonStyle/>
<ChangePasswordTemplate>
<!-- child controls -->
</ChangePasswordTemplate>
<ContinueButtonStyle/>
<FailureTextStyle/>
<HyperLinkStyle/>
<InstructionTextStyle/>
<LabelStyle/>
<MailDefinition
BodyFileName="uri"
CC="string"
From="string"
IsBodyHtml="True|False"
Priority="Normal|Low|High"
Subject="string"
>
<EmbeddedObjects>
<asp:EmbeddedMailObject
Name="string"
Path="uri"
/>
</EmbeddedObjects>
</MailDefinition>
<PasswordHintStyle/>
<SuccessTemplate>
<!-- child controls -->
</SuccessTemplate>
<SuccessTextStyle/>
<TextBoxStyle/>
<TitleTextStyle/>
<ValidatorTextStyle/>
</asp:ChangePassword>
构造函数
| ChangePassword() |
初始化 ChangePassword 类的新实例。 |
字段
| CancelButtonCommandName |
表示“取消”按钮的 |
| ChangePasswordButtonCommandName |
表示“更改密码”按钮的 |
| ContinueButtonCommandName |
表示“继续”按钮的 |
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性（只用于呈现）的集合。 (继承自 WebControl) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderPadding |
获取或设置 ChangePassword 控件的边界内及指定区域内的空白填充量（以像素为单位）。 |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| CancelButtonImageUrl |
如果“取消”按钮由 CancelButtonType 属性配置为一个图像按钮，则获取或设置在该按钮上所显示的图像的 URL。 |
| CancelButtonStyle |
获取一个对定义 Style 控件上“取消”按钮外观的 ChangePassword 属性集的引用。 |
| CancelButtonText |
获取或设置显示在“取消”按钮上的文本。 |
| CancelButtonType |
获取或设置呈现 ChangePassword 控件时所使用的“取消”按钮的类型。 |
| CancelDestinationPageUrl |
获取或设置单击 ChangePassword 控件中的“取消”按钮后显示给用户的页面的 URL。 |
| ChangePasswordButtonImageUrl |
如果“更改密码”按钮由 ChangePassword 属性配置为一个图像按钮，则获取或设置在 ChangePasswordButtonType 控件中该按钮旁显示的图像的 URL。 |
| ChangePasswordButtonStyle |
获取一个对定义 Style 控件上“更改密码”按钮外观的 ChangePassword 属性集的引用。 |
| ChangePasswordButtonText |
获取或设置显示在“更改密码”按钮上的文本。 |
| ChangePasswordButtonType |
获取或设置呈现 ChangePassword 控件中的“更改密码”按钮时所使用的按钮类型。 |
| ChangePasswordFailureText |
获取或设置当用户密码未更改时显示的消息。 |
| ChangePasswordTemplate |
获取或设置用于显示 ITemplate 控件的“更改密码”视图的 ChangePassword 对象。 |
| ChangePasswordTemplateContainer |
获取 ChangePassword 控件用以创建 ChangePasswordTemplate 模板实例的容器。 这样就可以通过编程的方式访问子控件。 |
| ChangePasswordTitleText |
获取或设置显示于“更改密码”视图中 ChangePassword 控件顶部的文本。 |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| ConfirmNewPassword |
获取用户输入的重复密码。 |
| ConfirmNewPasswordLabelText |
获取或设置 ConfirmNewPassword 文本框的标签文本。 |
| ConfirmPasswordCompareErrorMessage |
获取或设置当用户输入的新密码和重复输入密码不一致时显示的消息。 |
| ConfirmPasswordRequiredErrorMessage |
获取或设置当“确认新密码”文本框留空时显示的错误消息。 |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| ContinueButtonImageUrl |
如果“继续”按钮由 ChangePassword 属性配置为一个图像按钮，则获取或设置在 ContinueButtonType 控件中用于该按钮的图像的 URL。 |
| ContinueButtonStyle |
获取一个对定义 Style 控件“成功”视图上“继续”按钮外观的 ChangePassword 属性集的引用。 |
| ContinueButtonText |
获取或设置在 ChangePassword 控件“成功”视图中“继续”按钮上显示的文本。 |
| ContinueButtonType |
获取或设置呈现 ChangePassword 控件的“继续”按钮时所使用的按钮类型。 |
| ContinueDestinationPageUrl |
获取或设置单击“成功”视图中的“继续”按钮后将显示给用户的页面的 URL。 |
| Controls |
获取表示 ControlCollection 中的子控件的 CompositeControl 对象。 (继承自 CompositeControl) |
| ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| ControlStyleCreated |
获取一个值，该值指示是否已为 Style 属性创建了 ControlStyle 对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| CreateUserIconUrl |
获取或设置在链接旁显示的图像的 URL，该链接指向含有网站 CreateUserWizard 控件的网页。 |
| CreateUserText |
获取或设置链接的文本，该链接指向含有网站 CreateUserWizard 控件的网页。 |
| CreateUserUrl |
获取或设置含有网站 CreateUserWizard 控件的网页的 URL。 |
| CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
| CurrentPassword |
获取用户的当前密码。 |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| DisplayUserName |
获取或设置一个指示 ChangePassword 控件是否应显示 UserName 控件和标签的值。 |
| EditProfileIconUrl |
获取或设置在链接旁显示的图像的 URL，该链接指向网站的用户配置文件编辑页。 |
| EditProfileText |
获取或设置为链接显示的文本，该链接指向网站的用户配置文件编辑页。 |
| EditProfileUrl |
获取或设置网站的用户配置文件编辑页的 URL。 |
| Enabled |
获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| FailureTextStyle |
获取一个对定义 Style 控件上错误消息显示效果的 ChangePassword 属性集的引用。 |
| Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
| ForeColor |
获取或设置 Web 服务器控件的前景色（通常是文本颜色）。 (继承自 WebControl) |
| HasAttributes |
获取一个值，该值指示控件是否具有特性集。 (继承自 WebControl) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
| HelpPageIconUrl |
获取或设置在网站的“更改密码”帮助页旁显示的图像的 URL。 |
| HelpPageText |
获取或设置指向网站“更改密码”帮助页的链接的文本。 |
| HelpPageUrl |
获取或设置网站“更改密码”帮助页的 URL。 |
| HyperLinkStyle |
获取一个对定义 Style 控件上超链接外观的 ChangePassword 属性集的引用。 |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| InstructionText |
获取或设置在 ChangePassword 控件的 ChangePasswordTitleText 和输入框之间显示的信息性文本。 |
| InstructionTextStyle |
获取一个对定义 Style 控件上说明文本显示效果的 ChangePassword 属性集的引用。 |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsEnabled |
获取一个值，该值指示是否启用控件。 (继承自 WebControl) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LabelStyle |
获取一个对定义 Style 控件上文本框标签外观的 ChangePassword 对象集的引用。 |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| MailDefinition |
获取对一个属性集合的引用，这些属性定义了用户更改其密码后会接收到的电子邮件。 |
| MembershipProvider |
获取或设置用于管理成员信息的成员资格提供程序。 |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| NewPassword |
获取用户输入的新密码。 |
| NewPasswordLabelText |
获取或设置“新密码”文本框的标签文本。 |
| NewPasswordRegularExpression |
获取或设置用于验证用户输入的密码的正则表达式。 |
| NewPasswordRegularExpressionErrorMessage |
获取或设置当所输入的密码不符合 NewPasswordRegularExpression 属性中定义的正则表达式验证条件时显示的错误消息。 |
| NewPasswordRequiredErrorMessage |
获取或设置当用户将“新密码”文本框留空时显示的错误消息。 |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| PasswordHintStyle |
获取一个对定义 Style 控件上提示文本显示效果的 ChangePassword 属性集的引用。 |
| PasswordHintText |
获取或设置有关对创建网站密码的要求的信息性文本。 |
| PasswordLabelText |
获取或设置“当前密码”文本框的标签文本。 |
| PasswordRecoveryIconUrl |
获取或设置要在链接旁显示的图像的 URL，该链接指向含有 PasswordRecovery 控件的网页。 |
| PasswordRecoveryText |
获取或设置链接的文本，该链接指向含有 PasswordRecovery 控件的网页。 |
| PasswordRecoveryUrl |
获取或设置包含 PasswordRecovery 控件的网页的 URL。 |
| PasswordRequiredErrorMessage |
获取或设置当用户将“当前密码”文本框留空时显示的错误消息。 |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| RenderOuterTable |
获取或设置一个值，该值指示控件是否将呈现的 HTML 包含在 |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
| SuccessPageUrl |
获取或设置用户成功更改密码后向其显示的页面的 URL。 |
| SuccessTemplate |
获取或设置用于显示 ITemplate 控件的“成功”视图和“更改密码”视图的 ChangePassword 对象。 |
| SuccessTemplateContainer |
获取供 ChangePassword 控件用来创建 SuccessTemplate 模板实例的容器。 这样就可以通过编程的方式访问子控件。 |
| SuccessText |
获取或设置在“成功”视图中的 SuccessTitleText 和“继续”按钮之间显示的文本。 |
| SuccessTextStyle |
获取一个定义“成功”视图上文本显示效果的 Style 属性集。 |
| SuccessTitleText |
获取或设置“成功”视图的标题。 |
| SupportsDisabledAttribute |
获取一个值，该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TagKey |
获取对应于 HtmlTextWriterTag 控件的 ChangePassword 值。 此属性主要由控件开发人员使用。 |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| TextBoxStyle |
获取一个对定义 Style 控件上文本框控件外观的 ChangePassword 属性集的引用。 |
| TitleTextStyle |
获取一个对定义 Style 控件上标题外观的 ChangePassword 属性集的引用。 |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| UserName |
获取或设置要更改其密码的网站用户名。 |
| UserNameLabelText |
获取或设置“用户名”文本框的标签。 |
| UserNameRequiredErrorMessage |
获取或设置当用户将“用户名”文本框留空时显示的错误消息。 |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| ValidatorTextStyle |
获取一个对定义错误消息显示效果的 Style 属性集的引用，这些错误消息与 ChangePassword 控件所使用的所有输入确认相关联。 |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
方法
事件
| CancelButtonClick |
当用户单击“取消”按钮来取消密码更改操作时发生。 |
| ChangedPassword |
在用户帐户的密码更改时发生。 |
| ChangePasswordError |
当更改用户帐户的密码出错时发生。 |
| ChangingPassword |
在成员资格提供程序更改用户帐户的密码之前发生。 |
| ContinueButtonClick |
用户单击“继续”按钮时引发 ContinueButtonClick 事件。 |
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| SendingMail |
在向用户发送密码已更改的电子邮件确认之前发生。 |
| SendMailError |
在向用户发送电子邮件的过程中出现 SMTP 错误时发生。 |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
| GetDefaultValues(INamingContainer) |
为指定数据控件获取默认值的集合。 |
| GetMetaTable(INamingContainer) |
为指定数据控件获取表元数据。 |
| SetMetaTable(INamingContainer, MetaTable) |
为指定数据控件设置表元数据。 |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
为指定数据控件设置表元数据和默认值映射。 |
| SetMetaTable(INamingContainer, MetaTable, Object) |
为指定数据控件设置表元数据和默认值映射。 |
| TryGetMetaTable(INamingContainer, MetaTable) |
确定表元数据是否可用。 |
| EnableDynamicData(INamingContainer, Type) |
为指定数据控件启用动态数据行为。 |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
为指定数据控件启用动态数据行为。 |
| EnableDynamicData(INamingContainer, Type, Object) |
为指定数据控件启用动态数据行为。 |
适用于
另请参阅
- CurrentPassword
- NewPassword
- CreateUserWizard
- PasswordRecovery
- Login
- DeleteUser(String)
- ASP.NET 登录控件概述
- 自定义 ASP.NET 登录控件的外观和行为
- ASP.NET Web 服务器控件模板
- ASP.NET 主题和外观概述
- 如何：动态创建 ASP.NET Web 服务器控件模板
- 如何：以声明方式创建 ASP.NET Web 控件模板
- 如何：向匿名用户和登录用户显示不同的信息
- “网站管理工具安全性”选项卡
- 保护登录控件
- Basic Security Practices for Web Applications（Web 应用程序的基本安全实践）
- 保护成员身份
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈