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 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和方法會傳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 類別

定義

範例

備註

建構函式

屬性

方法

適用於

另請參閱

其他資源