¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
DirectoryEntry (Clase)
Collapse the table of content
Expand the table of content
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

DirectoryEntry (Clase)

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)

[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.

  NombreDescripción
Método públicoDirectoryEntry()Inicializa una nueva instancia de la clase DirectoryEntry.
Método públicoDirectoryEntry(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úblicoDirectoryEntry(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úblicoDirectoryEntry(String, String, String)Inicializa una nueva instancia de la clase DirectoryEntry.
Método públicoDirectoryEntry(String, String, String, AuthenticationTypes)Inicializa una nueva instancia de la clase DirectoryEntry.
Arriba

  NombreDescripción
Propiedad públicaAuthenticationTypeObtiene o establece el tipo de autenticación que se va a utilizar.
Propiedad protegidaCanRaiseEventsObtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad públicaChildrenObtiene las entradas secundarias de este nodo en la jerarquía de Servicios de dominio de Active Directory.
Propiedad públicaContainerObtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad protegidaDesignModeObtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegidaEventsObtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad públicaGuidObtiene el GUID de DirectoryEntry.
Propiedad públicaNameObtiene el nombre del objeto; el nombre que se le asignó al objeto con el servicio de directorio subyacente.
Propiedad públicaNativeGuidObtiene el GUID del objeto DirectoryEntry, tal como lo ha devuelto el proveedor.
Propiedad públicaNativeObjectObtiene el objeto nativo de interfaces de servicios de Active Directory (Active Directory Services Interfaces, ADSI).
Propiedad públicaObjectSecurityObtiene o establece el descriptor de seguridad de esta entrada.
Propiedad públicaOptionsObtiene las opciones de esta entrada específicas del proveedor.
Propiedad públicaParentObtiene la entrada principal de esta entrada en la jerarquía de Servicios de dominio de Active Directory.
Propiedad públicaPasswordEstablece la contraseña que se va a utilizar para autenticar el cliente.
Propiedad públicaPathObtiene o establece la ruta de acceso para DirectoryEntry.
Propiedad públicaPropertiesObtiene las propiedades de Servicios de dominio de Active Directory de este objeto DirectoryEntry.
Propiedad públicaSchemaClassNameObtiene el nombre de la clase de esquema para este objeto DirectoryEntry.
Propiedad públicaSchemaEntryObtiene el objeto de esquema de esta entrada.
Propiedad públicaSiteObtiene o establece ISite de Component. (Se hereda de Component).
Propiedad públicaUsePropertyCacheObtiene o establece un valor que indica si hay que confirmar la caché después de cada operación.
Propiedad públicaUsernameObtiene o establece el nombre de usuario que se va a utilizar para autenticar el cliente.
Arriba

  NombreDescripción
Método públicoCloseCierra el objeto DirectoryEntry y libera todos los recursos del sistema asociados a este componente.
Método públicoCommitChangesGuarda los cambios que se realizan en una entrada de directorio en el almacén de directorios subyacente.
Método públicoCopyTo(DirectoryEntry)Crea una copia de esta entrada como entrada secundaria de la entrada principal especificada.
Método públicoCopyTo(DirectoryEntry, String)Crea una copia de este objeto DirectoryEntry como elemento secundario del objeto DirectoryEntry primario, con el nuevo nombre especificado.
Método públicoCreateObjRefCrea 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úblicoDeleteTreeElimina esta entrada y todo el subárbol de la jerarquía de Servicios de dominio de Active Directory.
Método públicoDispose()Libera todos los recursos utilizados por Component. (Se hereda de Component).
Método protegidoDispose(Boolean)Libera los recursos (que no sean de memoria) utilizados por DirectoryEntry. (Invalida a Component.Dispose(Boolean)).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoMiembro estáticoExistsDetermina si la ruta de acceso especificada representa una entrada real en el servicio de directorio.
Método protegidoFinalizeLibera 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úblicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetServiceDevuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoInvokeLlama a un método en el objeto nativo de Servicios de dominio de Active Directory.
Método públicoInvokeGetObtiene una propiedad del objeto nativo de Servicios de dominio de Active Directory.
Método públicoInvokeSetEstablece una propiedad en el objeto nativo de Servicios de dominio de Active Directory.
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoMoveTo(DirectoryEntry)Mueve este objeto DirectoryEntry al elemento primario especificado.
Método públicoMoveTo(DirectoryEntry, String)Mueve este objeto DirectoryEntry al elemento primario especificado y cambia su nombre al valor especificado.
Método públicoRefreshCache()Carga los valores de propiedades de este objeto DirectoryEntry en la caché de propiedades.
Método públicoRefreshCache(String[])Carga los valores de las propiedades especificadas en la caché de propiedades.
Método públicoRenameCambia el nombre de este objeto DirectoryEntry.
Método públicoToStringDevuelve 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

  NombreDescripción
Evento públicoDisposedSe 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.

NotaNota

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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft