PrincipalSearcher.FindOne Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.PrincipalPublic Function FindOne () As PrincipalRetornos
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).
