DirectoryEntry Classe

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Source:

DirectoryEntry.cs

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

public ref 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))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

Héritage

Object

MarshalByRefObject

Component

DirectoryEntry

Attributs

TypeConverterAttribute

Remarques

Utilisez cette classe pour la liaison à des objets, ou pour lire et mettre à jour des attributs. DirectoryEntry, ainsi que des classes d’assistance, fournit une prise en charge de la gestion du cycle de vie et des méthodes de navigation. Celles-ci incluent la création, la suppression, le changement de nom, le déplacement d’un nœud enfant et l’énumération d’enfants. Après avoir modifié un nœud, vous devez valider vos modifications pour qu’elles soient enregistrées dans l’arborescence. Pour plus d’informations, consultez la propriété CommitChanges().

DirectoryEntry peut être utilisé pour accéder aux entrées régulières et à certains, mais pas tous, des informations provenant d’entrées de schéma.

La hiérarchie des services de domaine Active Directory contient jusqu’à plusieurs milliers de nœuds. Chaque nœud représente un objet, tel qu’une imprimante réseau ou un utilisateur dans un domaine. Les réseaux d’entreprise changent constamment à mesure que les nouveaux employés sont embauchés et que des objets tels que les imprimantes réseau et les ordinateurs sont ajoutés. La technologie ADSI (Active Directory Service Interfaces) permet d’ajouter par programmation ces objets à l’arborescence d’annuaires.

Pour créer une entrée de répertoire dans la hiérarchie, utilisez la Children propriété. La Children propriété est une collection qui fournit une Add méthode, via laquelle vous ajoutez un nœud à la collection directement sous le nœud parent auquel vous êtes actuellement lié. Lorsque vous ajoutez un nœud à la collection, vous devez spécifier un nom pour le nouveau nœud et le nom d’un modèle de schéma que vous souhaitez associer au nœud. Par exemple, vous pouvez utiliser un schéma intitulé « Ordinateur » pour ajouter de nouveaux ordinateurs à la hiérarchie.

Cette classe contient également la mise en cache des attributs, qui peut être utile pour optimiser le trafic réseau. Pour utiliser la mise en cache des attributs, consultez la UsePropertyCache propriété.

Les classes associées au DirectoryEntry composant peuvent être utilisées avec l’un des fournisseurs de services de domaine Active Directory. Certains fournisseurs actuels sont Internet Information Services (IIS), LDAP (Lightweight Directory Access Protocol), Novell NetWare Directory Service (NDS) et WinNT.

Note

Il est supposé que vous avez une compréhension générale des services de domaine Active Directory avant d’utiliser cette classe. Pour plus d’informations, consultez la vue d’ensemble de l’espace System.DirectoryServices de noms.

Constructeurs

Nom	Description
DirectoryEntry()	Initialise une nouvelle instance de la classe DirectoryEntry.
DirectoryEntry(Object)	Initialise une nouvelle instance de la DirectoryEntry classe qui se lie à l’objet Active Directory Domain Services natif spécifié.
DirectoryEntry(String, String, String, AuthenticationTypes)	Initialise une nouvelle instance de la classe DirectoryEntry.
DirectoryEntry(String, String, String)	Initialise une nouvelle instance de la classe DirectoryEntry.
DirectoryEntry(String)	Initialise une nouvelle instance de la DirectoryEntry classe qui lie cette instance au nœud dans les services de domaine Active Directory situés sur le chemin d’accès spécifié.

Propriétés

Nom	Description
AuthenticationType	Obtient ou définit le type d’authentification à utiliser.
Children	Obtient les entrées enfants de ce nœud dans la hiérarchie des services de domaine Active Directory.
Guid	Obtient le GUID du DirectoryEntry.
Name	Obtient le nom de l’objet nommé avec le service d’annuaire sous-jacent.
NativeGuid	Obtient le GUID du DirectoryEntryfournisseur, tel qu’il est retourné par le fournisseur.
NativeObject	Obtient l’objet ADSI (Active Directory Service Interfaces) natif.
ObjectSecurity	Obtient ou définit le descripteur de sécurité pour cette entrée.
Options	Obtient les options spécifiques au fournisseur pour cette entrée.
Parent	Obtient le parent de cette entrée dans la hiérarchie des services de domaine Active Directory.
Password	Définit le mot de passe à utiliser lors de l’authentification du client.
Path	Obtient ou définit le chemin d’accès pour ce DirectoryEntry.
Properties	Obtient les propriétés des services de domaine Active Directory pour cet DirectoryEntry objet.
SchemaClassName	Obtient le nom de la classe de schéma pour cet DirectoryEntry objet.
SchemaEntry	Obtient l’objet de schéma de cette entrée.
UsePropertyCache	Obtient ou définit une valeur indiquant si le cache doit être validé après chaque opération.
Username	Obtient ou définit le nom d’utilisateur à utiliser lors de l’authentification du client.

Méthodes

Nom	Description
Close()	Ferme l’objet DirectoryEntry et libère toutes les ressources système associées à ce composant.
CommitChanges()	Enregistre les modifications apportées à une entrée d’annuaire dans le magasin d’annuaires sous-jacent.
CopyTo(DirectoryEntry, String)	Crée une copie de cet DirectoryEntry objet, en tant qu’enfant de l’objet parent DirectoryEntry spécifié, avec le nouveau nom spécifié.
CopyTo(DirectoryEntry)	Crée une copie de cette entrée en tant qu’enfant du parent spécifié.
DeleteTree()	Supprime cette entrée et sa sous-arborescence entière de la hiérarchie des services de domaine Active Directory.
Dispose(Boolean)	Supprime les ressources (autres que la mémoire) utilisées par le DirectoryEntry.
Exists(String)	Détermine si le chemin spécifié représente une entrée réelle dans le service d’annuaire.
Invoke(String, Object[])	Appelle une méthode sur l’objet Services de domaine Active Directory natif.
InvokeGet(String)	Obtient une propriété de l’objet Services de domaine Active Directory natif.
InvokeSet(String, Object[])	Définit une propriété sur l’objet Services de domaine Active Directory natif.
MoveTo(DirectoryEntry, String)	Déplace cet DirectoryEntry objet vers le parent spécifié et remplace son nom par la valeur spécifiée.
MoveTo(DirectoryEntry)	Déplace cet DirectoryEntry objet vers le parent spécifié.
RefreshCache()	Charge les valeurs de propriété pour cet DirectoryEntry objet dans le cache de propriétés.
RefreshCache(String[])	Charge les valeurs des propriétés spécifiées dans le cache de propriétés.
Rename(String)	Modifie le nom de cet DirectoryEntry objet.