Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
DirectoryEntry, classe
Collapse the table of content
Expand the table of content

DirectoryEntry, classe

La classe DirectoryEntry encapsule un nœud ou un objet de la hiérarchie Active Directory.

Espace de noms : System.DirectoryServices
Assembly : System.DirectoryServices (dans system.directoryservices.dll)

public class DirectoryEntry : Component
public class DirectoryEntry extends Component
public class DirectoryEntry extends Component

Utilisez cette classe pour la liaison à des objets ou la lecture et la mise à jour des attributs. À l'instar des classes d'assistance, DirectoryEntry fournit une prise en charge des méthodes de navigation et de gestion de cycle de vie. Il s'agit notamment de la création, la suppression, le déplacement ou le changement de nom d'un nœud enfant et l'énumération des enfants. Après avoir modifié un nœud, vous devez valider vos modifications afin que celles-ci soient enregistrées dans l'arborescence. Pour plus d'informations, consultez la propriété CommitChanges.

Vous pouvez utiliser DirectoryEntry pour accéder aux entrées courantes et à certaines informations d'entrées de schéma.

La hiérarchie Active Directory peut contenir plusieurs milliers de nœuds. Chaque nœud représente un objet, tel une imprimante de réseau ou un utilisateur dans un domaine. Les réseaux d'entreprise changent sans cesse, avec l'ajout de nouveaux employés et de nouveaux objets tels que des imprimantes et des ordinateurs sur le réseau. La technologie ADSI (Active Directory Service Interfaces) fournit plusieurs façons d'ajouter ces objets par programme à l'arborescence.

Utilisez la propriété Children pour créer une entrée d'annuaire dans la hiérarchie. La propriété Children est une collection qui fournit une méthode Add par le biais de laquelle vous ajoutez un nœud à la collection, juste au-dessous du nœud parent auquel vous êtes actuellement lié. Lors de l'ajout d'un nœud à la collection, vous devez spécifier le nom du nouveau nœud, ainsi que le nom du modèle de schéma à associer à ce dernier. Par exemple, il est possible d'utiliser un schéma nommé « Ordinateur » pour ajouter de nouveaux ordinateurs à la hiérarchie.

Cette classe comporte également la mise en cache des attributs, une fonctionnalité qui peut s'avérer utile pour l'optimisation du trafic réseau. Pour utiliser la mise en cache des attributs, consultez la propriété UsePropertyCache.

Vous pouvez utiliser les classes associées au composant DirectoryEntry avec n'importe quel fournisseur de services Active Directory. Parmi les fournisseurs actuels figurent les services IIS (Internet Information Services), LDAP (Lightweight Directory Access Protocol, NDS (Novell NetWare Directory Service) et Windows NT.

RemarqueRemarque

Il est supposé que vous vous êtes familiarisé avec Active Directory avant de commencer à utiliser ces classes. Pour plus d'informations, consultez la vue d'ensemble de l'espace de noms System.DirectoryServices.

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.DirectoryServices.DirectoryEntry

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft