Exportar (0) Imprimir
Expandir todo

DirectoryEntry (Clase)

Actualización: noviembre 2007

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

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

[DSDescriptionAttribute("DirectoryEntryDesc")]
[SecurityPermissionAttribute(SecurityAction.Assert, Flags = SecurityPermissionFlag.UnmanagedCode)]
[EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)]
public class DirectoryEntry : Component
/** @attribute DSDescriptionAttribute("DirectoryEntryDesc") */
/** @attribute SecurityPermissionAttribute(SecurityAction.Assert, Flags = SecurityPermissionFlag.UnmanagedCode) */
/** @attribute EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted = true) */
/** @attribute DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true) */
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 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.

z9cddzaa.alert_note(es-es,VS.90).gifNota:

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.

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

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.

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.

.NET Framework

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft