DirectoryEntry DirectoryEntry DirectoryEntry DirectoryEntry Class

Definición

La clase DirectoryEntry encapsula un nodo u objeto en la jerarquía de Active Directory Domain Services. The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

public ref class DirectoryEntry : System::ComponentModel::Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Herencia
Atributos

Comentarios

Utilice esta clase para enlazar a objetos, o leer y actualizar atributos.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, junto con las clases auxiliares, proporciona compatibilidad para el ciclo de vida de los métodos de administración y navegación.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Estos incluyen crear, eliminar, cambiar el nombre, mover un nodo secundario y enumerar a los elementos secundarios.These include creating, deleting, renaming, moving a child node, and enumerating children. Después de modificar un nodo, debe confirmar los cambios en orden para que se guarden en el árbol.After you modify a node, you must commit your changes in order for them to be saved to the tree. Para obtener más información, vea la propiedad CommitChanges.For more information, see the CommitChanges property.

DirectoryEntry puede utilizarse para tener acceso a las entradas regulares y algunos, pero no todos, información de las entradas de esquema.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

La jerarquía de Active Directory Domain Services contiene varias miles de nodos.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Cada nodo representa un objeto, como una impresora de red o un usuario en un dominio.Each node represents an object, such as a network printer or a user in a domain. Las redes corporativas cambian constantemente a medida que se contratan a nuevos empleados y se agregan objetos como impresoras de red y equipos.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Tecnología de Active Directory Service Interfaces (ADSI) proporciona maneras de agregar mediante programación estos objetos en el árbol de directorios.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Para crear una entrada de directorio en la jerarquía, use el Children propiedad.To create a directory entry in the hierarchy, use the Children property. El 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 que está enlazado actualmente.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. 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 desee asociar al nodo.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. Por ejemplo, es posible que desee usar un esquema denominado "Equipo" para agregar nuevos equipos a la jerarquía.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Esta clase también contiene atributos de almacenamiento en caché, que pueden ser útiles para optimizar el tráfico de red.This class also contains attribute caching, which can be useful for optimizing network traffic. Para usar el atributo de almacenamiento en caché, consulte el UsePropertyCache propiedad.To use attribute caching, see the UsePropertyCache property.

Las clases asociadas con el DirectoryEntry componente se puede usar con cualquiera de los proveedores de servicios de Active Directory Domain Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. Algunos de los proveedores son Internet Information Services (IIS), Protocolo ligero de acceso a directorios (LDAP), Novell NetWare Directory Service (NDS) y WinNT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

Nota

Se supone que tiene un conocimiento general de servicios de dominio de Active Directory antes de usar esta clase.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Para obtener más información, consulte el System.DirectoryServices información general del espacio de nombres.For more information, see the System.DirectoryServices namespace overview.

Constructores

DirectoryEntry() DirectoryEntry() DirectoryEntry() DirectoryEntry()

Inicializa una nueva instancia de la clase DirectoryEntry. Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object)

Inicializa una nueva instancia de la clase DirectoryEntry que enlaza al objeto nativo de Active Directory Domain Services especificado. Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String)

Inicializa una nueva instancia de la clase DirectoryEntry que enlaza esta instancia al nodo de Active Directory Domain Services ubicado en la ruta de acceso especificada. Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String)

Inicializa una nueva instancia de la clase DirectoryEntry. Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes)

Inicializa una nueva instancia de la clase DirectoryEntry. Initializes a new instance of the DirectoryEntry class.

Propiedades

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Obtiene o establece el tipo de autenticación que se va a usar. Gets or sets the type of authentication to use.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento. Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Children Children Children Children

Obtiene las entradas secundarias de este nodo en la jerarquía de Active Directory Domain Services. Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container Container Container Container

Obtiene IContainer que contiene Component. Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño. Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtiene la lista de controladores de eventos asociados a Component. Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Guid Guid Guid Guid

Obtiene el GUID del objeto DirectoryEntry. Gets the GUID of the DirectoryEntry.

Name Name Name Name

Obtiene el nombre del objeto tal y como lo asignó el servicio de directorio subyacente. Gets the name of the object as named with the underlying directory service.

NativeGuid NativeGuid NativeGuid NativeGuid

Obtiene el GUID del objeto DirectoryEntry tal y como lo devolvió el proveedor. Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject NativeObject NativeObject NativeObject

Obtiene el objeto nativo de interfaces de servicios de Active Directory (ADSI). Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity ObjectSecurity ObjectSecurity ObjectSecurity

Obtiene o establece el descriptor de seguridad para esta entrada. Gets or sets the security descriptor for this entry.

Options Options Options Options

Obtiene las opciones específicas del proveedor para esta entrada. Gets the provider-specific options for this entry.

Parent Parent Parent Parent

Obtiene el elemento primario de esta entrada en la jerarquía de Active Directory Domain Services. Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password Password Password Password

Establece la contraseña que se va a usar para autenticar el cliente. Sets the password to use when authenticating the client.

Path Path Path Path

Obtiene o establece la ruta de acceso de este objeto DirectoryEntry. Gets or sets the path for this DirectoryEntry.

Properties Properties Properties Properties

Obtiene las propiedades de Active Directory Domain Services para este objeto DirectoryEntry. Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName SchemaClassName SchemaClassName SchemaClassName

Obtiene el nombre de la clase de esquema para este objeto DirectoryEntry. Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry SchemaEntry SchemaEntry SchemaEntry

Obtiene el objeto de esquema para esta entrada. Gets the schema object for this entry.

Site Site Site Site

Obtiene o establece el ISite de Component. Gets or sets the ISite of the Component.

(Inherited from Component)
UsePropertyCache UsePropertyCache UsePropertyCache UsePropertyCache

Obtiene o establece un valor que indica si hay que confirmar la caché después de cada operación. Gets or sets a value indicating whether the cache should be committed after each operation.

Username Username Username Username

Obtiene o establece el nombre de usuario que se va a usar para autenticar el cliente. Gets or sets the user name to use when authenticating the client.

Métodos

Close() Close() Close() Close()

Cierra el objeto DirectoryEntry y libera todos los recursos del sistema asociados a este componente. Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges() CommitChanges() CommitChanges() CommitChanges()

Guarda los cambios que se realizan en una entrada de directorio en el almacén de directorios subyacente. Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry)

Crea una copia de esta entrada como entrada secundaria de la entrada primaria especificada. Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String)

Crea una copia de este objeto DirectoryEntry como elemento secundario del objeto DirectoryEntry primario, con el nuevo nombre especificado. Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeleteTree() DeleteTree() DeleteTree() DeleteTree()

Elimina esta entrada y todo el subárbol de la jerarquía de Active Directory Domain Services. Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa Component. Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos (que no sean de memoria) usados por el objeto DirectoryEntry. Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
Exists(String) Exists(String) Exists(String) Exists(String)

Determina si la ruta de acceso especificada representa una entrada real en el servicio de directorio. Determines if the specified path represents an actual entry in the directory service.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container. Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[])

Llama a un método en el objeto nativo de Active Directory Domain Services. Calls a method on the native Active Directory Domain Services object.

InvokeGet(String) InvokeGet(String) InvokeGet(String) InvokeGet(String)

Obtiene una propiedad del objeto nativo de Active Directory Domain Services. Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[])

Establece una propiedad en el objeto nativo de Active Directory Domain Services. Sets a property on the native Active Directory Domain Services object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry)

Mueve este objeto DirectoryEntry al elemento primario especificado. Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String)

Mueve este objeto DirectoryEntry al elemento primario especificado y cambia su nombre por el valor especificado. Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache() RefreshCache() RefreshCache() RefreshCache()

Carga los valores de propiedad de este objeto DirectoryEntry en la caché de propiedades. Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[])

Carga los valores de las propiedades especificadas en la caché de propiedades. Loads the values of the specified properties into the property cache.

Rename(String) Rename(String) Rename(String) Rename(String)

Cambia el nombre de este objeto DirectoryEntry. Changes the name of this DirectoryEntry object.

ToString() ToString() ToString() ToString()

Devuelve una String que contiene el nombre del Component, si existe. Returns a String containing the name of the Component, if any. Este método no se debe invalidar. This method should not be overridden.

(Inherited from Component)

Eventos

Disposed Disposed Disposed Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose(). Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Seguridad

DirectoryServicesPermission
LinkDemand

Se aplica a