PrincipalSearcher.FindOne Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Origem:

PrincipalSearcher.cs

Retorna um resultado de pesquisa de entidades que contém o primeiro objeto de entidade de segurança encontrado que corresponde à entidade de segurança especificada na propriedade QueryFilter.

public:
 System::DirectoryServices::AccountManagement::Principal ^ FindOne();

public System.DirectoryServices.AccountManagement.Principal FindOne ();

member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal

Public Function FindOne () As Principal

Retornos

Principal

Um Principal objeto que contém o objeto principal que corresponde ao filtro de consulta ou null se nenhum resultado for encontrado.

Exceções

InvalidOperationException

O QueryFilter contém propriedades referenciais. Para obter mais informações, consulte o tópico de visão geral Query by Example (Consulta por Exemplo).

O QueryFilter é uma entidade de segurança persistente.

ArgumentException

Um QueryFilter deve ser atribuído primeiro ao pesquisador de entidades de segurança antes que a consulta seja realizada.

Comentários

Se houver exatamente uma correspondência do objeto especificado no QueryFilter, esse método retornará esse objeto. Se houver várias correspondências do QueryFilter objeto, esse método retornará arbitrariamente uma das entidades de segurança correspondentes.

O Principal objeto retornado desse método corresponde ao tipo de objeto contido na QueryFilter propriedade . A pesquisa é realizada no contexto especificado na Context propriedade . Para obter mais informações, consulte o tópico de visão geral Query by Example (Consulta por Exemplo).

Confira também

• Consulta por exemplo