ActiveDirectoryMembershipUser クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Active Directory データストアに格納されているメンバーシップユーザー情報を公開および更新します。

public ref class ActiveDirectoryMembershipUser : System::Web::Security::MembershipUser

[System.Serializable]
public class ActiveDirectoryMembershipUser : System.Web.Security.MembershipUser

[<System.Serializable>]
type ActiveDirectoryMembershipUser = class
    inherit MembershipUser

Public Class ActiveDirectoryMembershipUser
Inherits MembershipUser

継承: Object

MembershipUser
ActiveDirectoryMembershipUser

属性: SerializableAttribute

例

次のコード例は、複数のメンバーシップデータストアからユーザー情報を ActiveDirectoryMembershipUser 返す可能性がある Web ページ上のオブジェクトのプロパティの使用を示しています。 ActiveDirectoryMembershipUserメンバーシッププロバイダーによって返されるオブジェクトのMembershipUser基になるオブジェクトにはプロパティと LastLoginDate プロパティが実装LastActivityDateされていないため、コードはまず、メンバーシッププロバイダーから返されたユーザーオブジェクトの型を確認してから、それらのプロパティの内容を表示します。


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    MembershipUser user =
        Membership.GetUser();

    userName.Text = user.UserName;
    emailAddress.Text = user.Email;

    // <Snippet2>
    if (user is ActiveDirectoryMembershipUser)
    {
      lastLoginDate.Text = "Not available";
      lastActivityDate.Text = "Not available";
    }
    else
    {
      lastLoginDate.Text = user.LastLoginDate.ToShortDateString();
      lastActivityDate.Text = user.LastActivityDate.ToShortDateString();
    }
    // </Snippet2>   
    
    // <Snippet3>
    System.Security.Principal.SecurityIdentifier sidValue =
      (System.Security.Principal.SecurityIdentifier)user.ProviderUserKey;

    sid.Text = sidValue.ToString();
    // </Snippet3>
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim user As MembershipUser = Membership.GetUser()
        
    userName.Text = user.UserName
    emailAddress.Text = user.Email
        
    ' <Snippet2>
    If TypeOf (user) Is ActiveDirectoryMembershipUser Then
      lastLoginDate.Text = "Not available"
      lastActivityDate.Text = "Not available"
    Else
      lastLoginDate.Text = user.LastLoginDate.ToString()
      lastActivityDate.Text = user.LastActivityDate.ToString()
    End If
    ' </Snippet2>
    
    ' <Snippet3>
    Dim sidValue As System.Security.Principal.SecurityIdentifier
    sidValue = CType(user.ProviderUserKey, System.Security.Principal.SecurityIdentifier)
    
    sid.Text = sidValue.ToString()
    ' </Snippet3>
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information page</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

注釈

オブジェクトは ActiveDirectoryMembershipUser 、Active Directory メンバーシップデータストア内の 1 人のメンバーシップユーザーを表すために使用されます。電子メールアドレスなどのメンバーシップユーザーに関する情報を公開し、メンバーシップユーザーのパスワードを変更またはリセットする機能などの機能を提供します。

ActiveDirectoryMembershipUser Active Directory データストアを使用するようにアプリケーションが構成されるたびに、アプリケーションのメンバーシッププロバイダーによってオブジェクトが返されます。異なるデータストアを使用するように構成できるアプリケーション、または複数のデータストアを使用するアプリケーションでは、 MembershipUser基本クラスを参照できます。オブジェクトは ActiveDirectoryMembershipUser およびプロパティをLastActivityDate実装していないため、オブジェクトでこれらのメンバーにアクセスしたときにスローされるをNotSupportedException処理するように準備するActiveDirectoryMembershipUser LastLoginDate必要があります。

クラスは ActiveDirectoryMembershipUser 、メソッドの呼び出し時に発生する属性更新の数を最小限に抑えるために、クラスによって ActiveDirectoryMembershipProvider 使用される内部最適化を UpdateUser 実装します。また、(プロパティで使用可能な) 表現をProviderUserKeyシリアル化SecurityIdentifierして、例外をActiveDirectoryMembershipUserスローせずにオブジェクトをシリアル化および逆シリアル化できるようにします。

ActiveDirectoryMembershipUserオブジェクトは、メソッドおよび CreateUser メソッドによってGetUser返されるか、および FindUsersByEmail メソッドによってGetAllUsers FindUsersByName返されるの一部MembershipUserCollectionとして返されます。

既存の ActiveDirectoryMembershipUser メンバーシップユーザーの情報を UpdateUser 更新する場合は、メソッドでオブジェクトが必要です。

ActiveDirectoryMembershipUser プロパティは Active Directory 属性にマップされます。次の表に、 ActiveDirectoryMembershipUser プロパティとその既定の属性マッピングを示します。

プロパティ	既定のディレクトリ属性	マップできますか?
ProviderUserKey	`securityIdentifier`	いいえ
UserName	`userPrincipalName`	はい。ただし、userPrincipalName または sAMAccountName である必要があります
Comment	`comment`	いいえ
CreationDate	`whenCreated`	いいえ
Email	`mail`	はい。ただし、Unicode String 型の単一値属性である必要があります。
LastActivityDate	該当なし	では ActiveDirectoryMembershipProviderサポートされていません。
LastLoginDate	該当なし	では ActiveDirectoryMembershipProviderサポートされていません。
LastPasswordChangedDate	`pwdLastSet`	いいえ
PasswordQuestion	none ですが、パスワードのリセットまたは取得に質問と回答のセキュリティを使用する場合は、属性にマップする必要があります。	はい。ただし、Unicode String 型の単一値属性である必要があります。
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	いいえ
IsLockedOut	とから `lockoutTime` 計算された AD ロックアウト期間 (Windows 2000 の AD) `msDS-User-Account-Control-Computed` (Windows Server 2003 の AD) `msDS-User-Account-Control-Computed` (ADAM)	いいえ
LastLockoutDate	不正なパスワード試行が多すぎるためにロックアウトされた場合は、ロックアウト時間属性が返されます。不正なパスワード応答試行が多すぎるためにロックアウトされた場合は、で `attributeMapFailedPasswordAnswerLockoutTime` 定義された属性に格納されている値が返されます。不正なパスワードと不正なパスワード試行の両方が原因でロックアウトされた場合は、最新の日付/時刻値が返されます。アカウントがロックアウトされていない場合は、SQL 互換性のために 1/1/1753 を返します。	いいえ

コンストラクター

ActiveDirectoryMembershipUser()	ActiveDirectoryMembershipUser クラスを継承するクラスに対し、ActiveDirectoryMembershipUser オブジェクトの新しいインスタンスを初期化します。
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	指定したプロパティ値を使用して、ActiveDirectoryMembershipUser クラスの新しいインスタンスを作成します。

プロパティ

Comment	メンバーシップユーザーのアプリケーション固有情報を取得または設定します。
CreationDate	ユーザーがメンバーシップデータストアに追加された日時を取得します。 (継承元 MembershipUser)
Email	メンバーシップユーザーの電子メールアドレスを取得または設定します。
IsApproved	メンバーシップユーザーを認証できるかどうかを示す値を取得または設定します。
IsLockedOut	メンバーシップユーザーがロックされ、検証できない状態かどうかを示す値を取得します。 (継承元 MembershipUser)
IsOnline	ユーザーが現在オンラインかどうかを取得します。 (継承元 MembershipUser)
LastActivityDate	常に NotSupportedException 例外をスローします。
LastLockoutDate	メンバーシップのユーザーがロックアウトされた直近の日時を取得します。 (継承元 MembershipUser)
LastLoginDate	常に NotSupportedException 例外をスローします。
LastPasswordChangedDate	メンバーシップユーザーのパスワードが最後に更新された日時を取得します。 (継承元 MembershipUser)
PasswordQuestion	メンバーシップユーザーのパスワードの質問を取得します。 (継承元 MembershipUser)
ProviderName	メンバーシップユーザーのユーザー情報を保管および取得するメンバーシッププロバイダーの名前を取得します。 (継承元 MembershipUser)
ProviderUserKey	Active Directory データストアからメンバーシップユーザーのユーザー ID を取得します。
UserName	メンバーシップユーザーのログオン名を取得します。 (継承元 MembershipUser)

メソッド

ChangePassword(String, String)	メンバーシップデータストア内のメンバーシップユーザーのパスワードを更新します。 (継承元 MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	メンバーシップデータストア内のメンバーシップユーザーのパスワードの質問と答えを更新します。 (継承元 MembershipUser)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetPassword()	メンバーシップデータストアからメンバーシップユーザーのパスワードを取得します。 (継承元 MembershipUser)
GetPassword(String)	メンバーシップデータストアからメンバーシップユーザーのパスワードを取得します。 (継承元 MembershipUser)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ResetPassword()	ユーザーのパスワードをリセットして、自動的に生成された新しいパスワードにします。 (継承元 MembershipUser)
ResetPassword(String)	ユーザーのパスワードをリセットして、自動的に生成された新しいパスワードにします。 (継承元 MembershipUser)
ToString()	メンバーシップのユーザーのユーザー名を返します。 (継承元 MembershipUser)
UnlockUser()	ユーザーのロックアウト状態を解除して、メンバーシップユーザーを検証可能な状態にします。 (継承元 MembershipUser)

適用対象

こちらもご覧ください

メンバーシップの概要