Esta documentación está archivada y no tiene mantenimiento.

DirectorySearcher (Clase)

Realiza consultas en Active Directory.

Espacio de nombres: System.DirectoryServices
Ensamblado: System.DirectoryServices (en system.directoryservices.dll)

public class DirectorySearcher : Component
public class DirectorySearcher extends Component
public class DirectorySearcher extends Component

Utilice un objeto DirectorySearcher para buscar y realizar consultas en una jerarquía de Active Directory utilizando el Protocolo ligero de acceso a directorios (LDAP). LDAP es el único proveedor de interfaces de servicios de Active Directory (Active Directory Service Interfaces, ADSI) del sistema compatible con la operación de búsqueda en directorios. Un administrador puede crear, modificar y eliminar los objetos encontrados en la jerarquía. Para obtener más información, vea Usar System.DirectoryServices.

Cuando cree una instancia de DirectorySearcher, especifique la raíz y una lista opcional de propiedades que desee recuperar. La propiedad SearchRoot permite establecer propiedades adicionales para realizar las tareas siguientes:

  • Almacenar los resultados de la búsqueda en la memoria caché del equipo local. Establezca la propiedad CacheResults en true para almacenar la información de directorios en el equipo local. Las actualizaciones se realizan en esta memoria caché local y se confirman en Active Directory sólo si se llama al método DirectoryEntry.CommitChanges.

  • Especifique el período de tiempo de búsqueda mediante la propiedad ServerTimeLimit.

  • Recuperar sólo los nombres de atributo. Establezca la propiedad PropertyNamesOnly en true para recuperar únicamente los nombres de los atributos a los que se han asignado valores.

  • Realizar una búsqueda paginada. Establezca la propiedad PageSize para especificar el número máximo de objetos que se devuelven en una búsqueda paginada. Si no desea realizar una búsqueda paginada, establezca la propiedad PageSize en cero como valor predeterminado.

  • Especifique el número máximo de entradas que se devuelve mediante la propiedad SizeLimit. Si establece la propiedad SizeLimit en su valor predeterminado, que es cero, el valor predeterminado estipulado por el servidor es de 1000 entradas.

NotaNota

Si el número máximo de entradas devueltas y el límite de tiempo superan las limitaciones establecidas en el servidor, la configuración del servidor reemplaza la del componente.

Para obtener una lista con los valores de propiedad iniciales de una instancia de la clase DirectorySearcher, vea el constructor DirectorySearcher.

NotaNota

Antes de utilizar esta clase debe adquirir una serie de conocimientos generales de Active Directory. Para obtener más información, vea la información general sobre System.DirectoryServices.

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.DirectoryServices.DirectorySearcher

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0
Mostrar: