Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

DirectoryEntry (Clase)

.NET Framework 4

La clase DirectoryEntry encapsula un nodo u objeto en la jerarquía de Servicios de dominio de Active Directory.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.DirectoryServices.DirectoryEntry

Espacio de nombres:  System.DirectoryServices
Ensamblado:  System.DirectoryServices (en System.DirectoryServices.dll)
C#
C++
F#
VB
Copiar 
[DSDescriptionAttribute("DirectoryEntryDesc")]
[SecurityPermissionAttribute(SecurityAction.Assert, Flags = SecurityPermissionFlag.UnmanagedCode)]
[EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)]
public class DirectoryEntry : Component

El tipo DirectoryEntry expone los siguientes miembros.

  Nombre Descripción
Método público DirectoryEntry() Inicializa una nueva instancia de la clase DirectoryEntry.
Método público DirectoryEntry(Object) Inicializa una nueva instancia de la clase DirectoryEntry que se enlaza al objeto nativo especificado de Servicios de dominio de Active Directory.
Método público DirectoryEntry(String) Inicializa una nueva instancia de la clase DirectoryEntry que enlaza esta instancia al nodo de Servicios de dominio de Active Directory ubicado en la ruta de acceso especificada.
Método público DirectoryEntry(String, String, String) Inicializa una nueva instancia de la clase DirectoryEntry.
Método público DirectoryEntry(String, String, String, AuthenticationTypes) Inicializa una nueva instancia de la clase DirectoryEntry.
Arriba
  Nombre Descripción
Propiedad pública AuthenticationType Obtiene o establece el tipo de autenticación que se va a utilizar.
Propiedad protegida CanRaiseEvents Obtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad pública Children Obtiene las entradas secundarias de este nodo en la jerarquía de Servicios de dominio de Active Directory.
Propiedad pública Container Obtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad protegida DesignMode Obtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegida Events Obtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad pública Guid Obtiene el GUID del objeto DirectoryEntry.
Propiedad pública Name Obtiene el nombre del objeto; el nombre que se le asignó al objeto con el servicio de directorio subyacente.
Propiedad pública NativeGuid Obtiene el GUID del objeto DirectoryEntry, tal como lo ha devuelto el proveedor.
Propiedad pública NativeObject Obtiene el objeto nativo de interfaces de servicios de Active Directory (Active Directory Services Interfaces, ADSI).
Propiedad pública ObjectSecurity Obtiene o establece el descriptor de seguridad de esta entrada.
Propiedad pública Options Obtiene las opciones de esta entrada específicas del proveedor.
Propiedad pública Parent Obtiene la entrada principal de esta entrada en la jerarquía de Servicios de dominio de Active Directory.
Propiedad pública Password Establece la contraseña que se va a utilizar para autenticar el cliente.
Propiedad pública Path Obtiene o establece la ruta de acceso para DirectoryEntry.
Propiedad pública Properties Obtiene las propiedades de Servicios de dominio de Active Directory de este objeto DirectoryEntry.
Propiedad pública SchemaClassName Obtiene el nombre de la clase de esquema para este objeto DirectoryEntry.
Propiedad pública SchemaEntry Obtiene el objeto de esquema de esta entrada.
Propiedad pública Site Obtiene o establece ISite de Component. (Se hereda de Component).
Propiedad pública UsePropertyCache Obtiene o establece un valor que indica si hay que confirmar la caché después de cada operación.
Propiedad pública Username Obtiene o establece el nombre de usuario que se va a utilizar para autenticar el cliente.
Arriba
  Nombre Descripción
Método público Close Cierra el objeto DirectoryEntry y libera todos los recursos del sistema asociados a este componente.
Método público CommitChanges Guarda los cambios que se realizan en una entrada de directorio en el almacén de directorios subyacente.
Método público CopyTo(DirectoryEntry) Crea una copia de esta entrada como entrada secundaria de la entrada principal especificada.
Método público CopyTo(DirectoryEntry, String) Crea una copia de este objeto DirectoryEntry como elemento secundario del objeto DirectoryEntry primario, con el nuevo nombre especificado.
Método público CreateObjRef Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método público DeleteTree Elimina esta entrada y todo el subárbol de la jerarquía de Servicios de dominio de Active Directory.
Método público Dispose() Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegido Dispose(Boolean) Libera los recursos (que no sean de memoria) utilizados por DirectoryEntry. (Invalida a Component.Dispose(Boolean)).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método público Miembro estático Exists Determina si la ruta de acceso especificada representa una entrada real en el servicio de directorio.
Método protegido Finalize Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido GetService Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método público Invoke Llama a un método en el objeto nativo de Servicios de dominio de Active Directory.
Método público InvokeGet Obtiene una propiedad del objeto nativo de Servicios de dominio de Active Directory.
Método público InvokeSet Establece una propiedad en el objeto nativo de Servicios de dominio de Active Directory.
Método protegido MemberwiseClone() Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido MemberwiseClone(Boolean) Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método público MoveTo(DirectoryEntry) Mueve este objeto DirectoryEntry al elemento primario especificado.
Método público MoveTo(DirectoryEntry, String) Mueve este objeto DirectoryEntry al elemento primario especificado y cambia su nombre al valor especificado.
Método público RefreshCache() Carga los valores de las propiedades de este objeto DirectoryEntry en la caché de propiedades.
Método público RefreshCache(String[]) Carga los valores de las propiedades especificadas en la caché de propiedades.
Método público Rename Cambia el nombre de este objeto DirectoryEntry.
Método público ToString Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este método no debe reemplazarse. (Se hereda de Component).
Arriba
  Nombre Descripción
Evento público Disposed Se produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Arriba

Utilice esta clase para enlazar objetos o para leer y actualizar atributos. DirectoryEntry, junto con las clases auxiliares, proporciona compatibilidad con métodos de administración del ciclo de vida y de navegación. Entre estos métodos se incluyen la creación, la eliminación, el cambio de nombre, el desplazamiento de un nodo secundario y la enumeración de nodos secundarios. Después de modificar un nodo, debe confirmar los cambios para que se guarden en el árbol. Para obtener más información, vea la propiedad CommitChanges.

DirectoryEntry puede utilizarse para obtener acceso a las entradas regulares y a parte de la información, pero no toda, relacionada con las entradas de esquema.

La jerarquía de Servicios de dominio de Active Directory contiene varios miles de nodos. Cada nodo representa un objeto como, por ejemplo, una impresora de red o un usuario de un dominio. Las redes corporativas están sometidas a un cambio continuo: a medida que se contratan nuevos empleados, se van agregando objetos como impresoras de red y equipos. La tecnología de interfaces de servicio de Active Directory (Active Directory Service Interfaces, ADSI) proporciona varias formas para agregar estos objetos al árbol de directorios mediante programación.

Para crear una entrada de directorio en la jerarquía, utilice la propiedad Children. La propiedad Children es una colección que proporciona un método Add a través del que pueden agregarse nodos a la colección, directamente debajo del nodo principal al que esté enlazado en la actualidad. Cuando agregue nodos a la colección, debe especificar el nombre del nuevo nodo y el nombre de la plantilla de esquemas que desee asociar al nodo. Por ejemplo, para agregar nuevos equipos a la jerarquía podría utilizar un esquema con el título "Equipo".

Esta clase también incluye el almacenamiento de atributos en caché, que puede resultar de utilidad para optimizar el tráfico de red. Para utilizar el almacenamiento de atributos en caché, vea la propiedad UsePropertyCache.

Las clases asociadas al componente DirectoryEntry pueden utilizarse con cualquiera de los proveedores de Servicios de dominio de Active Directory. Entre los proveedores actuales se encuentran: Internet Information Services (IIS), Protocolo ligero de acceso a directorios (LDAP), servicios de directorio NetWare de Novell (NDS) y WinNT.

Nota 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 acerca del espacio de nombres System.DirectoryServices.

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos 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.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes