UserPrincipal.FindByIdentity Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Retorna um objeto de entidade de segurança de usuário que corresponde ao valor de identidade especificado.

Sobrecargas

FindByIdentity(PrincipalContext, IdentityType, String)	Retorna um objeto de entidade de usuário que corresponde ao tipo de identidade especificado, e o valor. Essa versão do método FindByIdentity determina o formato do valor de identidade.
FindByIdentity(PrincipalContext, String)	Retorna um objeto de entidade de segurança de usuário que corresponde ao valor de identidade especificado.

FindByIdentity(PrincipalContext, IdentityType, String)

Origem:

User.cs

Retorna um objeto de entidade de usuário que corresponde ao tipo de identidade especificado, e o valor. Essa versão do método FindByIdentity determina o formato do valor de identidade.

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

Parâmetros

context

PrincipalContext

O PrincipalContext que especifica o servidor ou domínio no qual as operações são executadas.

identityType

IdentityType

Um valor de enumeração IdentityType que especifica o formato do parâmetro identityValue.

identityValue

String

A identidade da entidade de usuário. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

UserPrincipal

Um objeto UserPrincipal que corresponde ao valor e ao tipo de identidade especificado, ou nulo, se nenhuma correspondência for encontrada.

Exceções

MultipleMatchesException

Foram encontrados vários objetos de entidade de usuário que correspondem ao objeto de usuário atual.

InvalidEnumArgumentException

O valor de identidade não é um valor de enumeração IdentityType válido.

Exemplos

O código a seguir se conecta ao repositório de computadores local. Como as credenciais não são especificadas no PrincipalContext construtor, as credenciais do usuário que executa o thread atual são usadas.

Uma pesquisa é realizada para localizar o usuário que tem SamAccountName "Convidado".

Se o usuário for encontrado, um marcar será executado para determinar se a conta desse usuário está habilitada. Se a conta não estiver habilitada, o código de exemplo a habilitará.

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)

Origem:

User.cs

Retorna um objeto de entidade de segurança de usuário que corresponde ao valor de identidade especificado.

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

Parâmetros

context

PrincipalContext

O PrincipalContext que especifica o servidor ou domínio no qual as operações são executadas.

identityValue

String

A identidade da entidade de usuário. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

UserPrincipal

Um objeto UserPrincipal que corresponde ao valor e ao tipo de identidade especificado, ou null, se nenhuma correspondência for encontrada.

Exceções

MultipleMatchesException

Foram encontrados vários objetos de entidade de usuário que correspondem ao objeto de usuário atual.