通过

MembershipUser 类

  • 参考

定义

命名空间:
System.Web.Security
程序集:
System.Web.dll
程序集:
System.Web.ApplicationServices.dll

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

public ref class MembershipUser
[System.Serializable]
public class MembershipUser
[<System.Serializable>]
type MembershipUser = class
Public Class MembershipUser
继承
Object
MembershipUser
派生
属性
SerializableAttribute

示例

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

重要

此示例包含接受用户输入的文本框，这是潜在的安全威胁。 默认情况下，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 的成员身份功能，请参阅“成员身份简介”，然后再继续操作。 有关与成员身份相关的其他主题的列表，请参阅 使用成员身份管理用户。

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

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()

清除用户锁定状态，以便验证成员资格用户。

适用于

另请参阅