共用方式為


MembershipUser 類別

定義

公開及更新成員資格資料存放區中的成員資格使用者資訊。

public ref class MembershipUser
[System.Serializable]
public class MembershipUser
[<System.Serializable>]
type MembershipUser = class
Public Class MembershipUser
繼承
MembershipUser
衍生
屬性

範例

下列程式代碼範例會更新使用者的電子郵件位址。

重要

此範例包含一個文本框,可接受用戶輸入,這是潛在的安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱 Script Exploits Overview (指令碼攻擊概觀)。

<%@ 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和方法會傳GetUserCreateUser回 物件,或 做為 、 FindUsersByNameFindUsersByEmail 方法所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()

清除使用者的鎖定狀態,以便驗證成員資格使用者。

適用於

另請參閱