UserPrincipal.FindByIdentity Метод

Определение

Пространство имен:

System.DirectoryServices.AccountManagement

Сборка:

System.DirectoryServices.AccountManagement.dll

Пакет:

System.DirectoryServices.AccountManagement v8.0.0

Возвращает объект субъекта-пользователя, соответствующий заданному типу и значению удостоверения.

Перегрузки

FindByIdentity(PrincipalContext, IdentityType, String)	Возвращает объект субъекта-пользователя, соответствующий заданному типу и значению удостоверения. Эта версия метода FindByIdentity определяет формат значения удостоверения.
FindByIdentity(PrincipalContext, String)	Возвращает объект субъекта-пользователя, соответствующий заданному типу и значению удостоверения.

FindByIdentity(PrincipalContext, IdentityType, String)

Исходный код:

User.cs

Возвращает объект субъекта-пользователя, соответствующий заданному типу и значению удостоверения. Эта версия метода FindByIdentity определяет формат значения удостоверения.

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

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

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

Параметры

context

PrincipalContext

Объект PrincipalContext, определяющий сервер или домен, в отношении которого выполняются операции.

identityType

IdentityType

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

identityValue

String

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

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

UserPrincipal

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

Исключения

MultipleMatchesException

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

InvalidEnumArgumentException

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

Примеры

Следующий код подключается к хранилищу локального компьютера. Так как учетные данные не указаны в конструкторе PrincipalContext , используются учетные данные пользователя, выполняющего текущий поток.

Поиск выполняется для поиска пользователя с именем SamAccountName "Guest".

Если пользователь найден, выполняется проверка, чтобы определить, включена ли учетная запись этого пользователя. Если учетная запись не включена, пример кода включает ее.

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);  

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,   
                                           IdentityType.SamAccountName,   
                                           "Guest");  

if(usr != null)  
{  
    if (usr.Enabled == false)  
        usr.Enabled = true;  

    usr.Save();  
    usr.Dispose();  
}  
ctx.Dispose();   

FindByIdentity(PrincipalContext, String)

Исходный код:

User.cs

Возвращает объект субъекта-пользователя, соответствующий заданному типу и значению удостоверения.

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

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

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

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

Параметры

context

PrincipalContext

Объект PrincipalContext, определяющий сервер или домен, в отношении которого выполняются операции.

identityValue

String

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

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

UserPrincipal

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

Исключения

MultipleMatchesException

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