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)

Source:

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)

Source:

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 枚举值。