Principal.FindByIdentity 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

傳回符合指定的識別值之主體物件。

多載

FindByIdentity(PrincipalContext, String)	傳回符合指定的識別值之主體物件。
FindByIdentity(PrincipalContext, IdentityType, String)	傳回符合指定的識別類型和值的主體物件。 這一版的 FindByIdentity(PrincipalContext, IdentityType, String) 方法會判斷身分識別值的格式。

FindByIdentity(PrincipalContext, String)

來源:

Principal.cs

傳回符合指定的識別值之主體物件。

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

主體的身分識別。 這個參數可以是 IdentityType 列舉中包含的任何格式。

傳回

Principal

符合指定的身分識別值和類型的 Principal 物件，如果找不到相符項目則為 null。

例外狀況

MultipleMatchesException

找到符合目前物件的多個主體物件。

FindByIdentity(PrincipalContext, IdentityType, String)

來源:

Principal.cs

傳回符合指定的識別類型和值的主體物件。 這一版的 FindByIdentity(PrincipalContext, IdentityType, String) 方法會判斷身分識別值的格式。

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

主體的身分識別。 這個參數可以是 IdentityType 列舉中包含的任何格式。

傳回

Principal

符合指定的身分識別值和類型的 Principal 物件，如果找不到相符項目則為 null。

例外狀況

MultipleMatchesException

找到符合目前物件的多個主體物件。

InvalidEnumArgumentException

身分識別類型不是有效的 IdentityType 列舉值。