DirectoryEntry Clase

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Paquete:

System.DirectoryServices v8.0.0

Source:

DirectoryEntry.cs

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

public ref class DirectoryEntry : System::ComponentModel::Component

[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component

[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

Herencia

Object

MarshalByRefObject

Component

DirectoryEntry

Atributos

TypeConverterAttribute

Comentarios

Use esta clase para enlazar a objetos o leer y actualizar atributos. DirectoryEntry, junto con las clases auxiliares, proporciona compatibilidad con los métodos de navegación y administración del ciclo de vida. Entre ellas se incluyen la creación, eliminación, cambio de nombre, movimiento de un nodo secundario y enumeración de elementos 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 se puede usar para acceder a entradas normales y algunas, pero no todas, información de entradas de esquema.

La jerarquía de Servicios de dominio de Active Directory contiene hasta varios miles de nodos. Cada nodo representa un objeto, como una impresora de red o un usuario de un dominio. Las redes corporativas cambian constantemente a medida que se contratan nuevos empleados y se agregan objetos como impresoras de red y equipos. La tecnología de interfaces de servicio de Active Directory (ADSI) proporciona maneras de agregar mediante programación estos objetos al árbol de directorios.

Para crear una entrada de directorio en la jerarquía, use la Children propiedad . La Children propiedad es una colección que proporciona un Add método, a través del cual se agrega un nodo a la colección directamente debajo del nodo primario al que está enlazado actualmente. Al agregar un nodo a la colección, debe especificar un nombre para el nuevo nodo y el nombre de una plantilla de esquema que desea asociar con el nodo. Por ejemplo, puede usar un esquema titulado "Equipo" para agregar nuevos equipos a la jerarquía.

Esta clase también contiene el almacenamiento en caché de atributos, que puede ser útil para optimizar el tráfico de red. Para usar el almacenamiento en caché de atributos, consulte la UsePropertyCache propiedad .

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

Nota

Se supone que tiene conocimientos generales de Servicios de dominio de Active Directory antes de usar esta clase. Para obtener más información, consulte la introducción al System.DirectoryServices espacio de nombres.

Constructores

DirectoryEntry()	Inicializa una nueva instancia de la clase DirectoryEntry.
DirectoryEntry(Object)	Inicializa una nueva instancia de la clase DirectoryEntry que enlaza al objeto nativo de Servicios de dominio de Active Directory especificado.
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.
DirectoryEntry(String, String, String)	Inicializa una nueva instancia de la clase DirectoryEntry.
DirectoryEntry(String, String, String, AuthenticationTypes)	Inicializa una nueva instancia de la clase DirectoryEntry.

Propiedades

AuthenticationType	Obtiene o establece el tipo de autenticación que se va a usar.
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Children	Obtiene las entradas secundarias de este nodo en la jerarquía de Active Directory Domain Services.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
Guid	Obtiene el GUID del objeto DirectoryEntry.
Name	Obtiene el nombre del objeto tal y como lo asignó el servicio de directorio subyacente.
NativeGuid	Obtiene el GUID del objeto DirectoryEntry tal y como lo devolvió el proveedor.
NativeObject	Obtiene el objeto nativo de interfaces de servicios de Active Directory (ADSI).
ObjectSecurity	Obtiene o establece el descriptor de seguridad para esta entrada.
Options	Obtiene las opciones específicas del proveedor para esta entrada.
Parent	Obtiene el elemento primario de esta entrada en la jerarquía de Active Directory Domain Services.
Password	Establece la contraseña que se va a usar para autenticar el cliente.
Path	Obtiene o establece la ruta de acceso de este objeto DirectoryEntry.
Properties	Obtiene las propiedades de Servicios de dominio de Active Directory para este objeto DirectoryEntry.
SchemaClassName	Obtiene el nombre de la clase de esquema para este objeto DirectoryEntry.
SchemaEntry	Obtiene el objeto de esquema para esta entrada.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
UsePropertyCache	Obtiene o establece un valor que indica si hay que confirmar la caché después de cada operación.
Username	Obtiene o establece el nombre de usuario que se va a usar para autenticar el cliente.

Métodos

Close()	Cierra el objeto DirectoryEntry y libera todos los recursos del sistema asociados a este componente.
CommitChanges()	Guarda los cambios que se realizan en una entrada de directorio en el almacén de directorios subyacente.
CopyTo(DirectoryEntry)	Crea una copia de esta entrada como entrada secundaria de la entrada primaria especificada.
CopyTo(DirectoryEntry, String)	Crea una copia de este objeto DirectoryEntry como elemento secundario del objeto DirectoryEntry primario, con el nuevo nombre especificado.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
DeleteTree()	Elimina esta entrada y todo el subárbol de la jerarquía de Servicios de dominio de Active Directory.
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos (que no sean de memoria) usados por el objeto DirectoryEntry.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Exists(String)	Determina si la ruta de acceso especificada representa una entrada real en el servicio de directorio.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Invoke(String, Object[])	Llama a un método en el objeto nativo de Servicios de dominio de Active Directory.
InvokeGet(String)	Obtiene una propiedad del objeto nativo de Active Directory Domain Services.
InvokeSet(String, Object[])	Establece una propiedad en el objeto nativo de Servicios de dominio de Active Directory.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
MoveTo(DirectoryEntry)	Mueve este objeto DirectoryEntry al elemento primario especificado.
MoveTo(DirectoryEntry, String)	Mueve este objeto DirectoryEntry al elemento primario especificado y cambia su nombre por el valor especificado.
RefreshCache()	Carga los valores de propiedad de este objeto DirectoryEntry en la caché de propiedades.
RefreshCache(String[])	Carga los valores de las propiedades especificadas en la caché de propiedades.
Rename(String)	Cambia el nombre de este objeto DirectoryEntry.
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)