ActiveDirectoryMembershipUser クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ActiveDirectoryMembershipUser クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class ActiveDirectoryMembershipUser
    Inherits MembershipUser

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipUser

[SerializableAttribute] 
public class ActiveDirectoryMembershipUser
 : MembershipUser

C++

[SerializableAttribute] 
public ref class ActiveDirectoryMembershipUser
 : public MembershipUser

/** @attribute SerializableAttribute() */ 
public class ActiveDirectoryMembershipUser
 extends MembershipUser

JScript

SerializableAttribute 
public class ActiveDirectoryMembershipUser
 extends MembershipUser

解説

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

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

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

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

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

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

プロパティ	既定のディレクトリ属性	マップ可能である
ProviderUserKey	securityIdentifier	いいえ
Username	userPrincipalName	はい。ただし、userPrincipalName または sAMAccountName のいずれかである必要があります。
Comment	comment	いいえ
CreationDate	whenCreated	いいえ
Email	mail	はい。ただし、Unicode 文字列型の単一の値を持つ属性である必要があります。
LastActivityDate	n/a	ActiveDirectoryMembershipProvider でサポートされていません。
LastLoginDate	n/a	ActiveDirectoryMembershipProvider でサポートされていません。
LastPasswordChangedDate	pwdLastSet	いいえ
PasswordQuestion	なし。ただし、パスワードのリセットまたは取得に質問と解答形式のセキュリティを使用している場合は、属性にマップする必要があります。	はい。ただし、Unicode 文字列型の単一の値を持つ属性である必要があります。
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 で定義された属性に格納された値が返されます。 1 つの無効なパスワードと多数の無効なパスワード試行の両方が原因でロックアウトされた場合は、最後の日付/時刻の値が返されます。アカウントがロックアウトされていない場合、SQL との互換性のために 1/1/1753 が返されます。	いいえ

使用例

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

Visual Basic

<%@ 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
        
    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
    
    Dim sidValue As System.Security.Principal.SecurityIdentifier
    sidValue = CType(user.ProviderUserKey, System.Security.Principal.SecurityIdentifier)
    
    sid.Text = sidValue.ToString()
  End Sub
</script>

<html >
<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>
            E-mail 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="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;

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

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

<html >
<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>
            E-mail 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>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)。要求値 : InheritanceDemand。アクセス許可値 : Minimal。

継承階層

System.Object
System.Web.Security.MembershipUser
System.Web.Security.ActiveDirectoryMembershipUser

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActiveDirectoryMembershipUser メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

東京ドームコンサートを開催したミュージシャンの一覧

>> 「ActiveDirectoryMembershipUser クラス」を含む用語の索引
ActiveDirectoryMembershipUser クラスのページへのリンク

ActiveDirectoryMembershipUser クラスとは？わかりやすく解説

ActiveDirectoryMembershipUser クラス

「ActiveDirectoryMembershipUser クラス」の関連用語


	© 2024 Microsoft.All rights reserved.

ActiveDirectoryMembershipUser クラスとは？ わかりやすく解説

ActiveDirectoryMembershipUser クラス

急上昇のことば

「ActiveDirectoryMembershipUser クラス」の関連用語

ActiveDirectoryMembershipUser クラスとは？わかりやすく解説