DirectoryEntry Classe

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paquet:

System.DirectoryServices v8.0.0

Source:

DirectoryEntry.cs

La classe DirectoryEntry 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 la lecture et la mise à jour d’attributs. DirectoryEntry, ainsi que les classes d’assistance, fournit une prise en charge des méthodes de navigation et de gestion du cycle de vie. Il s’agit notamment de la création, de la suppression, du renommage, du déplacement d’un nœud enfant et de 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 à certaines informations, mais pas toutes, à partir d’entrées de schéma.

La hiérarchie 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 de nouveaux employés sont embauchés et que des objets tels que des imprimantes réseau et des ordinateurs sont ajoutés. La technologie ACTIVE Directory Service Interfaces (ADSI) 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, par le biais de 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 n’importe quel fournisseur de services services de domaine Active Directory. Certains des fournisseurs actuels sont Internet Information Services (IIS), LDAP (Lightweight Directory Access Protocol), NDS (Novell NetWare Directory Service) et WinNT.

Notes

Il est supposé que vous avez une compréhension générale de 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

DirectoryEntry()	Initialise une nouvelle instance de la classe DirectoryEntry.
DirectoryEntry(Object)	Initialise une nouvelle instance de la classe DirectoryEntry qui est liée à l'objet des services de domaine Active Directory natif spécifié.
DirectoryEntry(String)	Initialise une nouvelle instance de la classe DirectoryEntry qui lie cette instance au nœud des services de domaine Active Directory figurant dans le chemin d’accès spécifié.
DirectoryEntry(String, String, String)	Initialise une nouvelle instance de la classe DirectoryEntry.
DirectoryEntry(String, String, String, AuthenticationTypes)	Initialise une nouvelle instance de la classe DirectoryEntry.

Propriétés

AuthenticationType	Obtient ou définit le type d'authentification à utiliser.
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Children	Obtient les entrées enfants de ce nœud dans la hiérarchie des services de domaine Active Directory.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
Guid	Obtient le GUID de DirectoryEntry.
Name	Obtient le nom de l'objet, tel que nommé dans le service d'annuaire sous-jacent.
NativeGuid	Obtient le GUID de DirectoryEntry, tel que retourné par le fournisseur.
NativeObject	Obtient l'objet ADSI (Active Directory Service Interfaces) natif.
ObjectSecurity	Obtient ou définit le descripteur de sécurité de 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 au moment de l'authentification du client.
Path	Obtient ou définit le chemin d’accès de ce DirectoryEntry.
Properties	Obtient les propriétés des services de domaine Active Directory pour cet objet DirectoryEntry.
SchemaClassName	Obtient le nom de la classe de schéma pour cet objet DirectoryEntry.
SchemaEntry	Obtient l'objet schéma de cette entrée.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
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 pour l'authentification du client.

Méthodes

Close()	Ferme l'objet DirectoryEntry et libère 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)	Crée une copie de cette entrée en tant qu'enfant du parent spécifié.
CopyTo(DirectoryEntry, String)	Crée une copie de cet objet DirectoryEntry comme enfant de l'objet DirectoryEntry parent spécifié, avec le nouveau nom indiqué.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
DeleteTree()	Supprime cette entrée et sa sous-arborescence entière de la hiérarchie des services de domaine Active Directory.
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources, exceptée la mémoire, utilisées par DirectoryEntry.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Exists(String)	Détermine si le chemin d’accès spécifié représente une entrée réelle dans le service d’annuaire.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Invoke(String, Object[])	Appelle une méthode sur l'objet des services de domaine Active Directory natif.
InvokeGet(String)	Obtient une propriété à partir de l'objet des services de domaine Active Directory natif.
InvokeSet(String, Object[])	Définit une propriété sur l'objet des services de domaine Active Directory natif.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
MoveTo(DirectoryEntry)	Déplace cet objet DirectoryEntry vers le parent spécifié.
MoveTo(DirectoryEntry, String)	Déplace cet objet DirectoryEntry vers le parent spécifié et modifie son nom en lui affectant la valeur spécifiée.
RefreshCache()	Charge les valeurs de propriétés de cet objet DirectoryEntry 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 objet DirectoryEntry.
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)