DirectorySearcher (Clase)
Actualización: noviembre 2007
Realiza consultas en los servicios de dominio de Active Directory.
Ensamblado: System.DirectoryServices (en System.DirectoryServices.dll)
[DSDescriptionAttribute("DirectorySearcherDesc")] [DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)] public class DirectorySearcher : Component
/** @attribute DSDescriptionAttribute("DirectorySearcherDesc") */
/** @attribute DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true) */
public class DirectorySearcher extends Component
public class DirectorySearcher extends Component
Utilice un objeto DirectorySearcher para buscar y realizar consultas en una jerarquía de servicios de dominio 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 Using 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 el servicio de dominio de 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.
 Nota: |
|---|
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().
| Nota: |
|---|
Antes de utilizar esta clase debe adquirir una serie de conocimientos generales de los servicios de dominio de Active Directory. Para obtener más información, vea la información general sobre System.DirectoryServices. |
System.MarshalByRefObject
System.ComponentModel.Component
System.DirectoryServices.DirectorySearcher
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
