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 要素が含まれていないかどうかが検証されます。詳細については、「スクリプトによる攻略の概要」を参照してください。

<%@ 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オブジェクトは、メソッドと CreateUser メソッドによってGetUser返されるか、および FindUsersByEmail メソッドによってGetAllUsers FindUsersByName返されるの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()	ユーザーのロックアウト状態を解除して、メンバーシップユーザーを検証可能な状態にします。

適用対象

こちらもご覧ください

メンバーシップの概要

次の方法で共有