MembershipUser 类

定义

命名空间:: System.Web.Security

程序集:: System.Web.dll

程序集:: System.Web.ApplicationServices.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

公开和更新成员身份数据存储中的成员身份用户信息。

public ref class MembershipUser

[System.Serializable]
public class MembershipUser

[<System.Serializable>]
type MembershipUser = class

Public Class MembershipUser

继承: Object
MembershipUser

派生: System.Web.Security.ActiveDirectoryMembershipUser

属性: SerializableAttribute

示例

下面的代码示例更新用户的电子邮件地址。

Important

此示例包含接受用户输入的文本框，这是潜在的安全威胁。默认情况下，ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。有关详细信息，请参阅脚本攻击概述。

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

MembershipUser u;

public void Page_Load(object sender, EventArgs args)
{
  u = Membership.GetUser(User.Identity.Name);

  if (!IsPostBack)
  {
    EmailTextBox.Text = u.Email; 
  }
}

public void UpdateEmailButton_OnClick(object sender, EventArgs args)
{
  try
  {
    u.Email = EmailTextBox.Text;

    Membership.UpdateUser(u);
  
    Msg.Text = "User email updated.";
  }
  catch (System.Configuration.Provider.ProviderException e)
  {
    Msg.Text = e.Message;
  }
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  <table cellpadding="3" border="0">
    <tr>
      <td>Email Address:</td>
      <td><asp:TextBox id="EmailTextBox" MaxLength="128" Columns="30" runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
                                    ControlToValidate="EmailTextBox" ForeColor="red"
                                    Display="Static" ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="UpdateEmailButton" 
                      Text="Update Email" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>

<%@ Page Language="vb" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Dim u As MembershipUser

Public Sub Page_Load(sender As Object, args As EventArgs)

  u = Membership.GetUser(User.Identity.Name)

  If Not IsPostBack Then EmailTextBox.Text = u.Email

End Sub

Public Sub UpdateEmailButton_OnClick(sender As Object, args As EventArgs)

  Try
    u.Email = EmailTextBox.Text

    Membership.UpdateUser(u)
  
    Msg.Text = "User email updated."
  Catch e As System.Configuration.Provider.ProviderException
    Msg.Text = e.Message
  End Try

End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  <table cellpadding="3" border="0">
    <tr>
      <td>Email Address:</td>
      <td><asp:TextBox id="EmailTextBox" MaxLength="128" Columns="30" runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator" runat="server"
                                    ControlToValidate="EmailTextBox" ForeColor="red"
                                    Display="Static" ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="UpdateEmailButton" 
                      Text="Update Email" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>

注解

该 MembershipUser 对象用于表示成员资格数据存储中的单个成员身份用户。它公开有关成员身份用户（如电子邮件地址）的信息，并为成员身份用户提供功能，例如更改或重置其密码的功能。

注释

如果不熟悉 ASP.NET 的成员身份功能，请参阅 “成员身份简介 ”，然后再继续操作。有关与成员身份相关的其他主题的列表，请参阅使用成员身份管理用户。

MembershipUser对象由GetUser和CreateUser方法返回，或作为由和方法返回的一MembershipUserCollection部分返回GetAllUsers FindUsersByName FindUsersByEmail。

若要更新现有成员身份用户的信息，该方法需要MembershipUser对象UpdateUser。

构造函数

名称	说明
MembershipUser()	为继承MembershipUser该类的MembershipUser类创建对象的新实例。
MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	使用指定的属性值创建新的成员身份用户对象。

属性

名称	说明
Comment	获取或设置成员身份用户的应用程序特定信息。
CreationDate	获取将用户添加到成员资格数据存储中的日期和时间。
Email	获取或设置成员身份用户的电子邮件地址。
IsApproved	获取或设置是否可以对成员身份用户进行身份验证。
IsLockedOut	获取一个值，该值指示成员身份用户是否已锁定且无法验证。
IsOnline	获取用户当前是否处于联机状态。
LastActivityDate	获取或设置上次对应用程序进行身份验证或访问成员身份用户的日期和时间。
LastLockoutDate	获取成员身份用户被锁定的最新日期和时间。
LastLoginDate	获取或设置用户上次进行身份验证的日期和时间。
LastPasswordChangedDate	获取上次更新成员身份用户密码的日期和时间。
PasswordQuestion	获取成员身份用户的密码问题。
ProviderName	获取成员资格提供程序的名称，该提供程序存储并检索成员身份用户的用户信息。
ProviderUserKey	从用户的成员身份数据源中获取用户标识符。
UserName	获取成员身份用户的登录名。

方法

名称	说明
ChangePassword(String, String)	更新成员身份数据存储中成员身份用户的密码。
ChangePasswordQuestionAndAnswer(String, String, String)	更新成员身份数据存储中成员身份用户的密码问题和答案。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetPassword()	从成员身份数据存储中获取成员身份用户的密码。
GetPassword(String)	从成员身份数据存储中获取成员身份用户的密码。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
ResetPassword()	将用户的密码重置为新的自动生成的密码。
ResetPassword(String)	将用户的密码重置为新的自动生成的密码。
ToString()	返回成员身份用户的用户名。
UnlockUser()	清除用户的锁定状态，以便可以验证成员身份用户。

适用于

另请参阅

成员资格简介

反馈

此页面是否有帮助？