GroupPrincipal.FindByIdentity 方法

定义

命名空间:

System.DirectoryServices.AccountManagement

程序集:

System.DirectoryServices.AccountManagement.dll

包:

System.DirectoryServices.AccountManagement v8.0.0

返回一个与指定的标识值匹配的组主体对象。

重载

FindByIdentity(PrincipalContext, String)	返回一个与指定的标识值匹配的组主体对象。
FindByIdentity(PrincipalContext, IdentityType, String)	返回一个与指定的标识类型和值匹配的组主体对象。 此版本的 FindByIdentity 方法确定标识值的格式。

FindByIdentity(PrincipalContext, String)

Source:

Group.cs

返回一个与指定的标识值匹配的组主体对象。

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

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

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

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

参数

context

PrincipalContext

PrincipalContext，用于指定要对其执行操作的服务器或域。

identityValue

String

组主体的标识。 此参数的格式可以是 IdentityType 枚举中包含的任何格式。

返回

GroupPrincipal

与指定标识值和类型相匹配的 GroupPrincipal 对象；若未找到匹配，则为 null。

例外

MultipleMatchesException

找到与当前组对象匹配的多个组主体对象。

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

Group.cs

返回一个与指定的标识类型和值匹配的组主体对象。 此版本的 FindByIdentity 方法确定标识值的格式。

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

public static System.DirectoryServices.AccountManagement.GroupPrincipal 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.GroupPrincipal

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

参数

context

PrincipalContext

PrincipalContext，用于指定要对其执行操作的服务器或域。

identityType

IdentityType

IdentityType 枚举值，用于指定 identityValue 参数的格式。

identityValue

String

组主体的标识。 此参数的格式可以是 IdentityType 枚举中包含的任何格式。

返回

GroupPrincipal

一个与指定的标识值和类型匹配的 GroupPrincipal；如果未找到匹配项，则为 null。

例外

MultipleMatchesException

找到与当前组对象匹配的多个组主体对象。

InvalidEnumArgumentException

该标识值不是有效的 IdentityType 枚举值。