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

示例

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

重要

此示例包含一个接受用户输入的文本框，这是一个潜在的安全威胁。默认情况下，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 方法返回，或作为、 FindUsersByName和 FindUsersByEmail 方法返回的 GetAllUsers的一MembershipUserCollection部分返回。

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()	清除用户锁定状态，以便验证成员资格用户。

适用于

另请参阅

成员资格简介

反馈

此页面是否有帮助？

通过

MembershipUser 类

定义

示例

注解

构造函数

属性

方法

适用于

另请参阅

反馈