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

Значение перечисления IdentityType, определяющее формат параметра identityValue.

identityValue

String

Удостоверение субъекта. Этот параметр может иметь любой формат, содержащийся в перечислении IdentityType.

Возвращаемое значение

Principal

Объект Principal, соответствующий значению и типу заданного удостоверения или значению NULL, если соответствий не найдено.

Исключения

MultipleMatchesException

Найдено несколько главных объектов, соответствующих текущему объекту.

InvalidEnumArgumentException

Тип удостоверения недопустимый для значения перечисления IdentityType.