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 Web ページによって、ユーザー入力にスクリプトまたは 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 オブジェクトは、メンバーシップ データ ストア内の 1 人のメンバーシップ ユーザーを表すために使用されます。 電子メール アドレスなどのメンバーシップ ユーザーに関する情報を公開し、メンバーシップ ユーザーのパスワードを変更またはリセットする機能などの機能を提供します。

注意

ASP.NET のメンバーシップ機能に慣れていない場合は、続行する前にメンバーシップの概要を参照してください。 メンバーシップに関連するその他のトピックの一覧については、「メンバーシップ を使用したユーザーの管理」を参照してください。

MembershipUserオブジェクトは、and CreateUser メソッドによってGetUser返されるか、または 、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()

ユーザーのロック アウト状態を解除して、メンバーシップ ユーザーを検証可能な状態にします。

適用対象

こちらもご覧ください