DirectoryEntry (Clase)
TOC
Collapse the table of content
Expand the table of content

DirectoryEntry (Clase)

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

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

public class DirectoryEntry : Component
public class DirectoryEntry extends Component
public class DirectoryEntry extends Component

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 desplazamiento. 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 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 Active Directory. Entre los proveedores actuales se encuentran: Servicios de Internet Information Server (IIS), Protocolo ligero de acceso a directorios (LDAP), servicios de directorio NetWare de Novell (NDS) y WinNT.

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

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

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft