Principal.FindByIdentity メソッド

定義

名前空間:

System.DirectoryServices.AccountManagement

アセンブリ:

System.DirectoryServices.AccountManagement.dll

パッケージ:

System.DirectoryServices.AccountManagement v8.0.0

指定された ID 値と一致するプリンシパル オブジェクトを返します。

オーバーロード

FindByIdentity(PrincipalContext, String)	指定された ID 値と一致するプリンシパル オブジェクトを返します。
FindByIdentity(PrincipalContext, IdentityType, String)	指定された ID の種類および値と一致するプリンシパル オブジェクトを返します。 このバージョンの FindByIdentity(PrincipalContext, IdentityType, String) メソッドでは、ID 値の形式が指定されます。

FindByIdentity(PrincipalContext, String)

ソース:

Principal.cs

指定された ID 値と一致するプリンシパル オブジェクトを返します。

public:
 static System::DirectoryServices::AccountManagement::Principal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.Principal

Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As Principal

パラメーター

context

PrincipalContext

操作が実行されるサーバーまたはドメインを指定する PrincipalContext。

identityValue

String

プリンシパルの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。

戻り値

Principal

指定された ID の値と型に一致する Principal オブジェクト。一致するオブジェクトが検出されなかった場合は null。

例外

MultipleMatchesException

現在のオブジェクトと一致する複数のプリンシパル オブジェクトが見つかりました。

FindByIdentity(PrincipalContext, IdentityType, String)

ソース:

Principal.cs

指定された ID の種類および値と一致するプリンシパル オブジェクトを返します。 このバージョンの FindByIdentity(PrincipalContext, IdentityType, String) メソッドでは、ID 値の形式が指定されます。

public:
 static System::DirectoryServices::AccountManagement::Principal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.Principal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As Principal

パラメーター

context

PrincipalContext

操作が実行されるサーバーまたはドメインを指定する PrincipalContext。

identityType

IdentityType

identityValue パラメーターの形式を指定する IdentityType 列挙値。

identityValue

String

プリンシパルの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。

戻り値

Principal

指定された ID の値および型と一致する Principal オブジェクト。一致するオブジェクトが見つからなかった場合は null。

例外

MultipleMatchesException

現在のオブジェクトと一致する複数のプリンシパル オブジェクトが見つかりました。

InvalidEnumArgumentException

ID の種類は有効な IdentityType 列挙値ではありません。