Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DirectorySearcher

 

Realiza consultas en los servicios de dominio de Active Directory.

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

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

[DSDescriptionAttribute("DirectorySearcherDesc")]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, 
	Unrestricted = true)]
public class DirectorySearcher : Component

NombreDescripción
System_CAPS_pubmethodDirectorySearcher()

Inicializa una nueva instancia de la clase DirectorySearcher con valores predeterminados.

System_CAPS_pubmethodDirectorySearcher(DirectoryEntry)

Inicializa una nueva instancia de la DirectorySearcher clase mediante la raíz de búsqueda especificado.

System_CAPS_pubmethodDirectorySearcher(DirectoryEntry, String)

Inicializa una nueva instancia de la DirectorySearcher clase con el filtro de raíz y la búsqueda de búsqueda especificado.

System_CAPS_pubmethodDirectorySearcher(DirectoryEntry, String, String[])

Inicializa una nueva instancia de la DirectorySearcher clase con la raíz de búsqueda especificado, el filtro de búsqueda y propiedades para recuperar...

System_CAPS_pubmethodDirectorySearcher(DirectoryEntry, String, String[], SearchScope)

Inicializa una nueva instancia de la DirectorySearcher clase con la raíz de búsqueda especificado, el filtro de búsqueda, propiedades para recuperar y el ámbito de búsqueda.

System_CAPS_pubmethodDirectorySearcher(String)

Inicializa una nueva instancia de la DirectorySearcher clase con el filtro de búsqueda especificado.

System_CAPS_pubmethodDirectorySearcher(String, String[])

Inicializa una nueva instancia de la DirectorySearcher clase con el filtro de búsqueda especificado y propiedades a recuperar.

System_CAPS_pubmethodDirectorySearcher(String, String[], SearchScope)

Inicializa una nueva instancia de la DirectorySearcher clase con la búsqueda especificada propiedades de filtro, recuperar y el ámbito de búsqueda.

NombreDescripción
System_CAPS_pubpropertyAsynchronous

Obtiene o establece un valor que indica si la búsqueda se realiza de forma asincrónica.

System_CAPS_pubpropertyAttributeScopeQuery

Obtiene o establece el nombre LDAP para mostrar del atributo de nombre distintivo en el que buscar. Solo atributo se puede utilizar para este tipo de búsqueda.

System_CAPS_pubpropertyCacheResults

Obtiene o establece un valor que indica si el resultado se almacena en caché en el equipo cliente.

System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyClientTimeout

Obtiene o establece la cantidad máxima de tiempo que el cliente espera a que el servidor devuelva resultados. Si el servidor no responde dentro de este tiempo, se anula la búsqueda y se devuelve ningún resultado.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyDerefAlias

Obtiene o establece un valor que indica cómo se deben resolver los alias de objetos que se encuentran durante una búsqueda.

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_pubpropertyDirectorySynchronization

Obtiene o establece un objeto que representa el control de sincronización de directorios para usar con la búsqueda.

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyExtendedDN

Obtiene o establece un valor que indica el formato de los nombres completos.

System_CAPS_pubpropertyFilter

Obtiene o establece un valor que indica la cadena de filtro de formato de protocolo ligero de acceso a directorios (LDAP).

System_CAPS_pubpropertyPageSize

Obtiene o establece un valor que indica el tamaño de página en una búsqueda paginada.

System_CAPS_pubpropertyPropertiesToLoad

Obtiene un valor que indica la lista de propiedades recuperadas durante la búsqueda.

System_CAPS_pubpropertyPropertyNamesOnly

Obtiene o establece un valor que indica si la búsqueda recupera sólo los nombres de atributos a los que se han asignado valores.

System_CAPS_pubpropertyReferralChasing

Obtiene o establece un valor que indica cómo se buscan las referencias.

System_CAPS_pubpropertySearchRoot

Obtiene o establece un valor que indica el nodo de la jerarquía de servicios de dominio de Active Directory donde comienza la búsqueda.

System_CAPS_pubpropertySearchScope

Obtiene o establece un valor que indica el ámbito de la búsqueda que obedece el servidor.

System_CAPS_pubpropertySecurityMasks

Obtiene o establece un valor que indica la búsqueda debe devolver la información de acceso de seguridad para los atributos especificados.

System_CAPS_pubpropertyServerPageTimeLimit

Obtiene o establece un valor que indica la cantidad máxima de tiempo que se debe buscar en el servidor en una página individual de resultados. No es igual que el límite de tiempo para toda la búsqueda.

System_CAPS_pubpropertyServerTimeLimit

El ServerTimeLimit propiedad obtiene o establece un valor que indica la cantidad máxima de tiempo que dedica a buscar en el servidor. Si se alcanza el límite de tiempo, se devuelven sólo las entradas encontradas hasta que seleccione.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertySizeLimit

Obtiene o establece un valor que indica el número máximo de objetos que el servidor devuelve en una búsqueda.

System_CAPS_pubpropertySort

Obtiene o establece un valor que indica la propiedad en el que se ordenan los resultados.

System_CAPS_pubpropertyTombstone

Obtiene o establece un valor que indica si la búsqueda debe devolver también los objetos eliminados que coincidan con el filtro de búsqueda.

System_CAPS_pubpropertyVirtualListView

Obtiene o establece un valor que indica las opciones de vista de lista virtual para la búsqueda.

NombreDescripción
System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar a un proxy que se utiliza para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos administrados que usan el DirectorySearcher objeto y, opcionalmente, libera los recursos no administrados.(Invalida Component.Dispose(Boolean)).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_pubmethodFindAll()

Ejecuta la búsqueda y devuelve una colección de las entradas que se encuentran.

System_CAPS_pubmethodFindOne()

Ejecuta la búsqueda y devuelve únicamente la primera entrada que se encuentra.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del elemento actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

Use un DirectorySearcher objeto 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 servicio de Active Directory (ADSI) proporcionado por el sistema que permite realizar búsquedas de directorio. Un administrador puede realizar, modificar y eliminar los objetos que se encuentran en la jerarquía. Para obtener más información, consulta Using System.DirectoryServices.

Cuando se crea una instancia de DirectorySearcher, especifique la raíz que desea recuperar y una lista opcional de propiedades que se recuperarán. El SearchRoot propiedad le permite establecer propiedades adicionales para realizar las tareas siguientes:

  • Almacenar en caché los resultados de búsqueda en el equipo local. Establecer el CacheResults propiedad true para almacenar la información de directorio en el equipo local. Las actualizaciones son realizadas en esta memoria caché local y se confirman en servicios de dominio de Active Directory sólo cuando el DirectoryEntry.CommitChanges se llama al método.

  • Especificar la longitud de tiempo de búsqueda mediante el ServerTimeLimit propiedad.

  • Recuperar sólo los nombres de atributo. Establecer el PropertyNamesOnly propiedad true para recuperar sólo los nombres de atributos a los que se han asignado valores.

  • Realizar una búsqueda paginada. Establecer el PageSize propiedad 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 el PageSize propiedad a su valor predeterminado de cero.

  • Especifique el número máximo de entradas a devolver, usando la SizeLimit propiedad. Si establece la SizeLimit propiedad a su valor predeterminado de cero, el valor predeterminado del servidor es de 1000 entradas.

System_CAPS_noteNota

Si el número máximo de entradas devueltas y límites de tiempo supera las limitaciones que se establecen en el servidor, la configuración del servidor reemplaza la configuración del componente.

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

System_CAPS_noteNota

Se presupone un conocimiento general de Active Directory Domain Services previo al uso de esta clase. Para obtener más información, consulte la System.DirectoryServices información general.

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: