Compartilhar via


PrincipalSearcher.FindOne Método

Definição

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 ();
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal FindOne ();
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal
[<System.Security.SecurityCritical>]
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal
Public Function FindOne () As Principal

Retornos

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

Atributos

Exceções

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.

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).

Aplica-se a

Confira também