Objets DirectoryEntry

Dans System.DirectoryServices, chaque objet de l'annuaire est représenté par l'objet DirectoryEntry. DirectoryEntry crée un objet d'entrée en mémoire. Il ne crée pas réellement l'objet dans l'annuaire tant que la méthode CommitChanges n'a pas été appelée. Cela vous permet de récupérer des informations d'annuaire pour un accès depuis une application cliente et de lire et modifier ces informations localement avant de vous reconnecter au serveur afin d'enregistrer les informations modifiées dans l'annuaire. Le serveur continue ainsi à fonctionner de façon optimale.

Chaque ressource réseau est représentée dans l'annuaire en tant qu'objet, et chaque objet d'annuaire, comme indiqué précédemment, est représenté en tant que DirectoryEntry dans l'application cliente.

Les objets d'entrée d'annuaire possèdent les caractéristiques suivantes :

• Name. Le nom de l'objet est également appelé nom unique relatif. Le format du nom unique relatif utilise la syntaxe key=value. Par exemple, dans le diagramme suivant, le nom unique relatif d'un objet utilisateur est CN=Jeff Smith. Notez que les espaces sont exclus.
• Parent. Les objets réseau sont hiérarchiques et ont un objet parent jusqu'à ce que vous atteigniez l'objet racine, qui est l'objet du domaine, parfois appelé tête du domaine, au sommet de la hiérarchie.
• Path. Le chemin d'accès de l'objet d'annuaire est également appelé nom unique. Le nom unique est construit à partir du nom de l'objet précédé par le nom de chaque objet parent jusqu'à l'objet racine. Par exemple, pour l'objet utilisateur CN=Jeff Smith, le nom unique commence par l'objet racine et suit le chemin d'accès de l'objet utilisateur, comme suit : DC=Fabrikam, DC=COM, OU=Sales, CN=Jeff Smith. Les chemins d'accès utilisent une syntaxe définie par la spécification LDAP. Pour plus d'informations sur la syntaxe à utiliser pour le chemin d'accès, voir Chaînes de liaison. Le chemin d'accès est utilisé dans une chaîne de liaison créée avec l'objet DirectoryEntry.

Les informations précédentes s'appliquent à tous les objets d'annuaire LDAP auxquels vous vous connectez à l'aide de System.DirectoryServices. D'autres points sont cependant spécifiques aux services de domaine Active Directory. L'une des caractéristiques des objets des services de domaine Active Directory est qu'ils doivent contenir un identificateur global unique (GUID, Globally Unique Identifier). Contrairement aux valeurs des différents attributs de l'objet, le GUID ne peut pas être modifié.

L'exemple de code suivant indique comment créer un objet DirectoryEntry et écrire son chemin d'accès, son nom et son GUID. Dans cet exemple, DirectoryEntry est lié à la racine du domaine auquel l'utilisateur est actuellement connecté.

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);

Voir aussi

Référence

System.DirectoryServices
DirectoryEntry

Concepts

Mise en route dans System.DirectoryServices
Chaînes de liaison

Send comments about this topic to Microsoft.

Copyright © 2007 par Microsoft Corporation. Tous droits réservés.