Partilhar via


UserPrincipal.FindByIdentity Método

Definição

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
Origem:
User.cs
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

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

Exceções

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

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();   

Aplica-se a

FindByIdentity(PrincipalContext, String)

Origem:
User.cs
Origem:
User.cs
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

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

Exceções

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

Aplica-se a