PrincipalSearcher.FindOne Método

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Source:

PrincipalSearcher.cs

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 ();

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

Public Function FindOne () As Principal

Devoluciones

Principal

Objeto Principal que contiene el objeto principal que coincide con el filtro de consulta o null si no se encuentra ningún resultado.

Excepciones

InvalidOperationException

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.

ArgumentException

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

Consulte también

• Consulta mediante ejemplos