ActiveDirectoryMembershipProvider.GetUser メソッド

定義

名前空間:

System.Web.Security

アセンブリ:

System.Web.dll

Active Directory データ ストア内のメンバーシップ ユーザーの情報を取得します。

オーバーロード

GetUser(String, Boolean)	指定したユーザー名に関連付けられたメンバーシップ ユーザー情報を取得します。
GetUser(Object, Boolean)	指定したユーザー キーに関連付けられているメンバーシップ ユーザー情報を取得します。

GetUser(String, Boolean)

指定したユーザー名に関連付けられたメンバーシップ ユーザー情報を取得します。

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::String ^ username, bool userIsOnline);

public override System.Web.Security.MembershipUser GetUser (string username, bool userIsOnline);

override this.GetUser : string * bool -> System.Web.Security.MembershipUser

Public Overrides Function GetUser (username As String, userIsOnline As Boolean) As MembershipUser

パラメーター

username

String

情報を取得するユーザーの名前。

userIsOnline

Boolean

GetUser(String, Boolean) メソッドはこのパラメーターを無視します。

戻り値

MembershipUser

指定されたユーザーを表す MembershipUser インスタンス。 指定した username 値のユーザーが Active Directory データ ストアで見つからなかった場合、null が返されます。

例外

ArgumentException

username が空であるか、ユーザー名の最大長 (通常は 256 文字) を超えています。

- または -

username はコンマを含んでいます。

- または -

ユーザー名は userPrincipalName 属性にマップされており、username パラメーターに円記号が含まれています。

ArgumentNullException

username が nullです。

InvalidOperationException

GetUser(String, Boolean) インスタンスが初期化される前に ActiveDirectoryMembershipProvider メソッドが呼び出されました。

注釈

メソッドは GetUser 、 クラスによって呼び出され Membership 、Active Directory データ ストアから指定されたユーザーに関する情報を取得します。

プロバイダーは、接続文字列で指定された検索ポイントから始まるサブツリー検索を使用します。 接続文字列の ActiveDirectoryMembershipProvider 詳細については、クラスのトピックを参照してください。

username パラメーター値の先頭と末尾の空白はトリムされます。

こちらもご覧ください

• ASP.NET メンバーシップの概要

GetUser(Object, Boolean)

指定したユーザー キーに関連付けられているメンバーシップ ユーザー情報を取得します。

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::Object ^ providerUserKey, bool userIsOnline);

public override System.Web.Security.MembershipUser GetUser (object providerUserKey, bool userIsOnline);

override this.GetUser : obj * bool -> System.Web.Security.MembershipUser

Public Overrides Function GetUser (providerUserKey As Object, userIsOnline As Boolean) As MembershipUser

パラメーター

providerUserKey

Object

ユーザーの一意の識別子。

userIsOnline

Boolean

GetUser(Object, Boolean) メソッドはこのパラメーターを無視します。

戻り値

MembershipUser

指定されたユーザーを表す MembershipUser インスタンス。 指定した providerUserKey 値のユーザーが Active Directory データ ストアで見つからなかった場合、null が返されます。

例外

InvalidOperationException

GetUser(Object, Boolean) インスタンスが初期化される前に ActiveDirectoryMembershipProvider メソッドが呼び出されました。

ArgumentException

providerUserKey が SecurityIdentifier 型ではありません。

ArgumentNullException

providerUserKey が nullです。

注釈

メソッドは GetUser 、 クラスによって呼び出され Membership 、Active Directory データ ストアから指定されたユーザーに関する情報を取得します。

この検索では、 属性が objectSID パラメーターと一致するユーザー インスタンスが providerUserKey 検索されます。

プロバイダーは、接続文字列で指定された検索ポイントから始まるサブツリー検索を使用します。 接続文字列の ActiveDirectoryMembershipProvider 詳細については、クラスのトピックを参照してください。