DirectoryEntry Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
La clase DirectoryEntry encapsula un nodo u objeto en la jerarquía de Active Directory Domain Services.
public ref class DirectoryEntry : System::ComponentModel::Componentpublic class DirectoryEntry : System.ComponentModel.Component[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public 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))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Componenttype DirectoryEntry = class
inherit Component[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))>]
type DirectoryEntry = class
inherit Component[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
inherit Component[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
[<System.DirectoryServices.DSDescription("DirectoryEntryDesc")>]
type DirectoryEntry = class
inherit ComponentPublic Class DirectoryEntry
Inherits Component- Herencia
- Atributos
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() |
Obsoletos.
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() |
Obsoletos.
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) |
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de