PrincipalSearcher.FindOne Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un resultado de búsqueda de entidades de seguridad que contiene el primer objeto de entidad de seguridad encontrado que coincida con la entidad de seguridad especificada en la propiedad 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 PrincipalDevoluciones
Objeto Principal que contiene el objeto principal que coincide con el filtro de consulta o null si no se encuentra ningún resultado.
- Atributos
Excepciones
Propiedad QueryFilter que contiene propiedades referenciales. Para obtener más información, vea el tema de información general Consulta mediante ejemplos.
La propiedad QueryFilter es una entidad de seguridad persistente.
La propiedad QueryFilter primero se debe asignar al buscador de entidades de seguridad antes de que se pueda ejecutar la consulta.
Comentarios
Si hay exactamente una coincidencia del objeto especificado en QueryFilter, este método devuelve ese objeto. Si hay varias coincidencias del QueryFilter objeto, este método devuelve arbitrariamente una de las entidades de seguridad coincidentes.
El Principal objeto devuelto por este método coincide con el tipo de objeto contenido en la QueryFilter propiedad . La búsqueda se realiza en el contexto especificado en la Context propiedad . Para obtener más información, vea el tema de información general Consulta mediante ejemplos.
