Principal.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 que corresponde ao valor de identidade especificado.

Sobrecargas

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

FindByIdentity(PrincipalContext, String)

Origem:

Principal.cs

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

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

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 segurança. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

Principal

Um objeto Principal 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 segurança que correspondem ao objeto atual.

FindByIdentity(PrincipalContext, IdentityType, String)

Origem:

Principal.cs

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

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

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 segurança. Esse parâmetro pode estar em qualquer formato que esteja contido na enumeração IdentityType.

Retornos

Principal

Um objeto Principal 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 segurança que correspondem ao objeto atual.

InvalidEnumArgumentException

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