ChangePassword 类

定义

提供使用户能够更改其网站密码的用户界面。

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 INamingContainer
Public Class ChangePassword
Inherits CompositeControl
继承
属性
实现

示例

下面的代码示例演示如何设置 NewPasswordRegularExpression 属性以定义检查密码以确保密码符合以下条件的正则表达式:

  • 大于 6 个字符。

  • 至少包含一位数字。

  • 至少包含一个特殊 (非字母数字) 字符。

属性中包含的 PasswordHintText 密码要求会显示给用户。

如果用户输入的密码不符合 属性的要求 NewPasswordRegularExpression ,则会向用户显示 属性中包含的 NewPasswordRegularExpressionErrorMessage 文本。 如果未输入新密码,则会向用户显示 属性中包含的 NewPasswordRequiredErrorMessage 文本。

注意

新密码必须满足成员资格提供程序在 、 MinRequiredNonAlphanumericCharactersPasswordStrengthRegularExpression 属性中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

  • 更改用户帐户的密码,即使他们以其他用户身份登录也是如此。 这要求 属性 DisplayUserNametrue

DisplayUserName 属性设置为 true 将显示“用户名”文本框,该文本框允许用户键入用户名。 如果用户已登录,则 UserName 控件将填充已登录用户的名称。 更改给定用户名的密码后,用户将登录到与更改后的密码关联的帐户,即使用户以前未登录到该帐户。

重要

接受用户输入是潜在的安全威胁。 恶意用户可以发送旨在公开漏洞的数据,或运行尝试生成密码的程序。 为了在处理用户输入时提高安全性,应使用控件的验证功能,并保护为控件配置的任何数据提供程序。 有关详细信息,请参阅 保护登录控件Web 应用程序的基本安全做法保护成员身份

发送电子邮件

可以将 ChangePassword 控件配置为使用电子邮件服务向用户发送新密码。 若要从任何 ASP.NET Web 服务器控件向用户发送电子邮件,必须在应用程序的 Web.config 文件中配置电子邮件服务器。 有关详细信息,请参阅 如何:在 IIS 6.0 中安装和配置 SMTP 虚拟服务器

电子邮件是使用 MailDefinition 类配置的。 必须设置 BodyFileName 属性以指示 ASP.NET 发送电子邮件。

重要

在电子邮件中发送用户帐户名或密码是潜在的安全威胁。 电子邮件通常以纯文本形式发送,可由特殊网络“探查”应用程序读取。 若要提高安全性,请使用 保护登录控件中所述的缓解措施。

注意

无法保证用户将收到或查看电子邮件。 若要验证用户是否已收到消息,请在电子邮件中提供一个确认链接,让用户确认已收到通知。

视图

控件 ChangePassword 有两种状态或视图:

  • “更改密码”视图 请求当前密码,并要求用户键入新密码两次进行确认。 如果允许未登录的用户更改其密码,请将 属性设置为 DisplayUserNametrue 以在“更改密码”视图中显示 UserName 控件。 控件 UserName 允许用户提供其注册的用户名。 如果更改密码时出错,“更改密码”视图中会显示一条错误消息,允许用户重试。

  • “成功”视图 提供密码已更改的确认。

    重要

    更改密码以及用于继续和取消的功能附加到具有正确命令名称的任何按钮,无论该按钮位于哪个视图上。 例如,在“成功”视图中具有 值的 commandname=changepassword 按钮将尝试更改密码并导致异常。

样式和模板

可以使用一组广泛的样式属性来自定义控件的外观 ChangePassword 。 或者,如果需要完全控制控件的外观,可以将自定义模板应用于这两个 ChangePassword 视图。 如果为视图定义模板,则会 ControlStyle 应用属性。 有关必须在视图模板中设置的控件的列表,请参阅 ChangePasswordTemplateSuccessTemplate 属性。 如果找不到所需控件、未正确命名或类型错误,控件 ChangePassword 将检查模板中的内容,并引发异常。 例如,如果使用模板中的内容并将 属性设置为 DisplayUserNametrueChangePassword则在找不到用户名的 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.NETASP.NET 控件和辅助功能

可访问性

有关如何配置此控件以便生成符合辅助功能标准的标记的信息,请参阅 Visual Studio 中的辅助功能和 ASP.NETASP.NET 控件和辅助功能

在Page_Load和Page_Init期间访问控件

ChangePassword 在页面生命周期的所有阶段都可以访问由文本框(如 UserNameCurrentPassword)表示的控件属性。 具体而言,在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

表示“取消”按钮的 CommandName 值。 此字段为只读。

ChangePasswordButtonCommandName

表示“更改密码”按钮的 CommandName 值。 此字段为只读。

ContinueButtonCommandName

表示“继续”按钮的 CommandName 值。 此字段为只读。

属性

AccessKey

获取或设置使您得以快速导航到 Web 服务器控件的访问键。

(继承自 WebControl)
Adapter

获取控件的浏览器特定适配器。

(继承自 Control)
AppRelativeTemplateSourceDirectory

获取或设置包含该控件的 PageUserControl 对象的应用程序相对虚拟目录。

(继承自 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 包含在 table 元素中,以便应用内联样式。

Site

获取容器信息,该容器在呈现于设计图面上时承载当前控件。

(继承自 Control)
SkinID

获取或设置要应用于控件的外观。

(继承自 WebControl)
Style

获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。

(继承自 WebControl)
SuccessPageUrl

获取或设置用户成功更改密码后向其显示的页面的 URL。

SuccessTemplate

获取或设置用于显示 ITemplate 控件的“成功”视图和“更改密码”视图的 ChangePassword 对象。

SuccessTemplateContainer

获取供 ChangePassword 控件用来创建 SuccessTemplate 模板实例的容器。 这样就可以通过编程的方式访问子控件。

SuccessText

获取或设置在“成功”视图中的 SuccessTitleText 和“继续”按钮之间显示的文本。

SuccessTextStyle

获取一个定义“成功”视图上文本显示效果的 Style 属性集。

SuccessTitleText

获取或设置“成功”视图的标题。

SupportsDisabledAttribute

获取一个值,该值指示在控件的 disabled 属性为 IsEnabled 时,控件是否应将呈现的 HTML 元素的 false 特性设置为 "disabled"。

(继承自 CompositeControl)
TabIndex

获取或设置 Web 服务器控件的选项卡索引。

(继承自 WebControl)
TagKey

获取对应于 HtmlTextWriterTag 控件的 ChangePassword 值。 此属性主要由控件开发人员使用。

TagName

获取控件标记的名称。 此属性主要由控件开发人员使用。

(继承自 WebControl)
TemplateControl

获取或设置对包含该控件的模板的引用。

(继承自 Control)
TemplateSourceDirectory

获取包含当前服务器控件的 PageUserControl 的虚拟目录。

(继承自 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)

方法

AddAttributesToRender(HtmlTextWriter)

将需要呈现的 HTML 特性和样式添加到指定的 HtmlTextWriterTag 中。 此方法主要由控件开发人员使用。

(继承自 WebControl)
AddedControl(Control, Int32)

在子控件添加到 Control 对象的 Controls 集合后调用。

(继承自 Control)
AddParsedSubObject(Object)

通知服务器控件,分析了一个元素(XML 或 HTML),并将该元素添加到服务器控件的 ControlCollection 对象中。

(继承自 Control)
ApplyStyle(Style)

将指定样式的所有非空白元素复制到 Web 控件,覆盖控件的所有现有的样式元素。 此方法主要由控件开发人员使用。

(继承自 WebControl)
ApplyStyleSheetSkin(Page)

将页样式表中定义的样式属性应用到控件。

(继承自 Control)
BeginRenderTracing(TextWriter, Object)

开始输出数据的设计时追踪。

(继承自 Control)
BuildProfileTree(String, Boolean)

收集有关服务器控件的信息并将该信息发送到 Trace 属性,在启用页的跟踪功能时将显示该属性。

(继承自 Control)
ClearCachedClientID()

将缓存的 ClientID 值设置为 null

(继承自 Control)
ClearChildControlState()

删除服务器控件的子控件的控件状态信息。

(继承自 Control)
ClearChildState()

删除服务器控件的所有子控件的视图状态和控件状态信息。

(继承自 Control)
ClearChildViewState()

删除服务器控件的所有子控件的视图状态信息。

(继承自 Control)
ClearEffectiveClientIDMode()

将当前控件实例和任何子控件的 ClientIDMode 属性设置为 Inherit

(继承自 Control)
CopyBaseAttributes(WebControl)

Style 对象未封装的属性从指定的 Web 服务器控件复制到从中调用此方法的 Web 服务器控件。 此方法主要由控件开发人员使用。

(继承自 WebControl)
CreateChildControls()

分别创建组成 ChangePassword 控件的各个控件,以便为回发或呈现做准备。

CreateControlCollection()

创建一个新 ControlCollection 对象来保存服务器控件的子控件(包括文本控件和服务器控件)。

(继承自 Control)
CreateControlStyle()

创建由 WebControl 类在内部用来实现所有与样式有关的属性的样式对象。 此方法主要由控件开发人员使用。

(继承自 WebControl)
DataBind()

将数据源绑定到 CompositeControl 及其所有子控件。

(继承自 CompositeControl)
DataBind(Boolean)

将数据源绑定到调用的服务器控件及其所有子控件,同时可以选择引发 DataBinding 事件。

(继承自 Control)
DataBindChildren()

将数据源绑定到服务器控件的子控件。

(继承自 Control)
Dispose()

使服务器控件得以在从内存中释放之前执行最后的清理操作。

(继承自 Control)
EndRenderTracing(TextWriter, Object)

结束输出数据的设计时追踪。

(继承自 Control)
EnsureChildControls()

确定服务器控件是否包含子控件。 如果不包含,则创建子控件。

(继承自 Control)
EnsureID()

为尚未分配标识符的控件创建标识符。

(继承自 Control)
Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
FindControl(String)

在当前的命名容器中搜索带指定 id 参数的服务器控件。

(继承自 Control)
FindControl(String, Int32)

使用指定的 idpathOffset 参数(该参数有助于搜索)中指定的整数在当前命名容器中搜索服务器控件。 不应重写此版本的 FindControl 方法。

(继承自 Control)
Focus()

为控件设置输入焦点。

(继承自 Control)
GetDesignModeState()

获取控件的设计时数据。

(继承自 Control)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetRouteUrl(Object)

获取与一组路由参数对应的 URL。

(继承自 Control)
GetRouteUrl(RouteValueDictionary)

获取与一组路由参数对应的 URL。

(继承自 Control)
GetRouteUrl(String, Object)

获取与一组路由参数以及某个路由名称对应的 URL。

(继承自 Control)
GetRouteUrl(String, RouteValueDictionary)

获取与一组路由参数以及某个路由名称对应的 URL。

(继承自 Control)
GetType()

获取当前实例的 Type

(继承自 Object)
GetUniqueIDRelativeTo(Control)

返回指定控件的 UniqueID 属性的前缀部分。

(继承自 Control)
HasControls()

确定服务器控件是否包含任何子控件。

(继承自 Control)
HasEvents()

返回一个值,该值指示是否为控件或任何子控件注册事件。

(继承自 Control)
IsLiteralContent()

确定服务器控件是否只包含文字内容。

(继承自 Control)
LoadControlState(Object)

可从 SaveControlState() 方法保存的上一个页请求还原控件状态信息。

LoadViewState(Object)

SaveViewState() 方法保存的上一个页请求还原视图状态信息。

MapPathSecure(String)

检索虚拟路径(绝对的或相对的)映射到的物理路径。

(继承自 Control)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
MergeStyle(Style)

将指定样式的所有非空白元素复制到 Web 控件,但不覆盖该控件现有的任何样式元素。 此方法主要由控件开发人员使用。

(继承自 WebControl)
OnBubbleEvent(Object, EventArgs)

确定 ChangePassword 控件的事件是否沿页面的 Web 服务器控件层次结构向上传递。

OnCancelButtonClick(EventArgs)

用户单击“取消”按钮时引发 CancelButtonClick 事件。

OnChangedPassword(EventArgs)

更改密码后引发 ChangedPassword 事件。

OnChangePasswordError(EventArgs)

用户密码未更改时引发 ChangePasswordError 事件。

OnChangingPassword(LoginCancelEventArgs)

在成员资格提供程序更改用户的密码之前引发 ChangingPassword 事件。

OnContinueButtonClick(EventArgs)

用户单击“继续”按钮时引发 ContinueButtonClick 事件。

OnDataBinding(EventArgs)

引发 DataBinding 事件。

(继承自 Control)
OnInit(EventArgs)

引发 Init 控件的 ChangePassword 事件,以便该控件能够将自身注册到页面。

OnLoad(EventArgs)

引发 Load 事件。

(继承自 Control)
OnPreRender(EventArgs)

引发 PreRender 事件。

OnSendingMail(MailMessageEventArgs)

在电子邮件发送到 SMTP 服务器进行处理之前引发 SendingMail 事件。 然后,SMTP 服务器将电子邮件发送给用户。

OnSendMailError(SendMailErrorEventArgs)

当无法向用户发送电子邮件时引发 SendMailError 事件。

OnUnload(EventArgs)

引发 Unload 事件。

(继承自 Control)
OpenFile(String)

获取用于读取文件的 Stream

(继承自 Control)
RaiseBubbleEvent(Object, EventArgs)

将所有事件源及其信息分配给控件的父级。

(继承自 Control)
RecreateChildControls()

在派生自 CompositeControl 的控件中重新创建子控件。

(继承自 CompositeControl)
RemovedControl(Control)

Control 对象的 Controls 集合移除子控件后调用。

(继承自 Control)
Render(HtmlTextWriter)

ChangePassword 控件内容写入指定的 HtmlTextWriter 对象,以便在客户端显示。

RenderBeginTag(HtmlTextWriter)

将控件的 HTML 开始标记呈现到指定的编写器中。 此方法主要由控件开发人员使用。

(继承自 WebControl)
RenderChildren(HtmlTextWriter)

将服务器控件子级的内容输出到提供的 HtmlTextWriter 对象,该对象可写入要在客户端上呈现的内容。

(继承自 Control)
RenderContents(HtmlTextWriter)

将控件的内容呈现到指定的编写器中。 此方法主要由控件开发人员使用。

(继承自 WebControl)
RenderControl(HtmlTextWriter)

将服务器控件内容输出到所提供的 HtmlTextWriter 对象,如果启用了跟踪,则还将存储有关该控件的跟踪信息。

(继承自 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 HtmlTextWriter 对象将服务器控件内容输出到提供的 ControlAdapter 对象。

(继承自 Control)
RenderEndTag(HtmlTextWriter)

将控件的 HTML 结束标记呈现到指定的编写器中。 此方法主要由控件开发人员使用。

(继承自 WebControl)
ResolveAdapter()

获取负责呈现指定控件的控件适配器。

(继承自 Control)
ResolveClientUrl(String)

获取浏览器可以使用的 URL。

(继承自 Control)
ResolveUrl(String)

将 URL 转换为在请求客户端可用的 URL。

(继承自 Control)
SaveControlState()

保存将页面回发到服务器之后发生的所有服务器控件状态更改。

SaveViewState()

保存自页面回发到服务器后发生的任何服务器控件视图状态更改。

SetDesignModeState(IDictionary)

为控件设置设计时数据。

SetRenderMethodDelegate(RenderMethod)

分配事件处理程序委托,以将服务器控件及其内容呈现到父控件中。

(继承自 Control)
SetTraceData(Object, Object)

使用跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。

(继承自 Control)
SetTraceData(Object, Object, Object)

使用跟踪对象、跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。

(继承自 Control)
ToString()

返回表示当前对象的字符串。

(继承自 Object)
TrackViewState()

导致跟踪对服务器控件所做的视图状态更改,以便将这些更改存储到服务器控件的 StateBag 对象中。 通过 ViewState 属性可访问此对象。

事件

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)

显式接口实现

IAttributeAccessor.GetAttribute(String)

获取具有指定名称的 Web 控件的特性。

(继承自 WebControl)
IAttributeAccessor.SetAttribute(String, String)

将 Web 控件的特性设置为指定的名称和值。

(继承自 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

启用设计器,以便在设计时环境中重新创建子控件的复合控件集合。

(继承自 CompositeControl)
IControlBuilderAccessor.ControlBuilder

有关此成员的说明,请参见 ControlBuilder

(继承自 Control)
IControlDesignerAccessor.GetDesignModeState()

有关此成员的说明,请参见 GetDesignModeState()

(继承自 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

有关此成员的说明,请参见 SetDesignModeState(IDictionary)

(继承自 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

有关此成员的说明,请参见 SetOwnerControl(Control)

(继承自 Control)
IControlDesignerAccessor.UserData

有关此成员的说明,请参见 UserData

(继承自 Control)
IDataBindingsAccessor.DataBindings

有关此成员的说明,请参见 DataBindings

(继承自 Control)
IDataBindingsAccessor.HasDataBindings

有关此成员的说明,请参见 HasDataBindings

(继承自 Control)
IExpressionsAccessor.Expressions

有关此成员的说明,请参见 Expressions

(继承自 Control)
IExpressionsAccessor.HasExpressions

有关此成员的说明,请参见 HasExpressions

(继承自 Control)
IParserAccessor.AddParsedSubObject(Object)

有关此成员的说明,请参见 AddParsedSubObject(Object)

(继承自 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)

为指定数据控件启用动态数据行为。

适用于

另请参阅