Objetos DirectoryEntry

En System.DirectoryServices, cada objeto del directorio se representa mediante el objeto DirectoryEntry. DirectoryEntry crea un objeto de entrada en memoria; en realidad, no crea el objeto en el directorio hasta que se llama al método CommitChanges. La ventaja de esto es que puede recuperar información del directorio para obtener acceso desde una aplicación cliente y leer o modificar esa información de manera local antes de volverse a conectar al servidor para guardar la información modificada en el directorio. De este modo, el rendimiento del servidor se mantiene al máximo nivel.

Cada recurso de red se representa en el directorio como un objeto y cada objeto de directorio, tal y como se indicó anteriormente, es representado como una DirectoryEntry en la aplicación cliente.

Los objetos de entrada de directorio tienen las siguientes características:

• Name. Al nombre del objeto también se le denomina nombre distintivo relativo (RDN). El formato del RDN utiliza la sintaxis clave=valor. Por ejemplo, en el siguiente diagrama, el RDN de un objeto de usuario es CN=Jeff Smith. Tenga en cuenta que se han excluido los espacios.
• Parent. Los objetos de la red son jerárquicos y poseen un objeto primario hasta alcanzar el objeto raíz, que es el objeto de dominio, también denominado a veces cabeza de dominio, en la parte superior de la jerarquía.
• Path. La ruta de acceso al objeto de directorio también se denomina nombre distintivo (DN) El nombre distintivo se construye con el nombre de objeto precedido por los nombres de cada objeto primario hasta llegar al objeto raíz. Por ejemplo, en el caso del objeto de usuario CN=Jeff Smith, el DN comienza con el objeto raíz y sigue la ruta de acceso al objeto de usuario, de la siguiente manera: DC=Fabrikam,DC=COM,OU=Sales,CN=Jeff Smith. Las rutas de acceso utilizan una sintaxis definida por la especificación LDAP. Para obtener más información sobre la sintaxis correcta para la ruta de acceso, vea Cadenas de enlace. La ruta de acceso se utiliza en una cadena de enlace creada con el objeto DirectoryEntry.

Si bien la información anterior es aplicable a cualquier objeto de directorio LDAP al que se conecte mediante System.DirectoryServices, determinados aspectos son específicos de los servicios de dominio de Active Directory. Una de las características de los objetos de los servicios de dominio de Active Directory es que deben contener un identificador único global (GUID). Si bien es posible modificar los valores de diferentes atributos del objeto, el GUID no se puede cambiar.

El siguiente ejemplo de código muestra cómo crear una DirectoryEntry y escribir su ruta de acceso, nombre y GUID. En este ejemplo, DirectoryEntry se está enlazando con la raíz del dominio al que el usuario está actualmente conectado.

Imports System.DirectoryServices
'...
Dim entry As New DirectoryEntry()
Console.WriteLine(entry.Path)
Console.WriteLine(entry.Name)
Console.WriteLine(entry.Guid)

using System.DirectoryServices;
//...
DirectoryEntry entry = new DirectoryEntry();
Console.WriteLine(entry.Path);
Console.WriteLine(entry.Name);
Console.WriteLine(entry.Guid);

Consulte también

Referencia

System.DirectoryServices
DirectoryEntry

Conceptos

Introducción a System.DirectoryServices
Cadenas de enlace

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.