DirectoryEntry DirectoryEntry DirectoryEntry DirectoryEntry Class

Définition

La classe DirectoryEntry encapsule un nœud ou un objet dans la hiérarchie des services de domaine Active Directory.The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

public ref class DirectoryEntry : System::ComponentModel::Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Héritage
Attributs

Remarques

Utilisez cette classe pour la liaison à des objets ou de lecture et de la mise à jour des attributs.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, ainsi que des classes d’assistance, prend en charge du cycle de vie des méthodes de navigation et de gestion.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. Ceux-ci incluent la création, la suppression, changement de nom, déplacement d’un nœud enfant et l’énumération des enfants.These include creating, deleting, renaming, moving a child node, and enumerating children. Après avoir modifié un nœud, vous devez valider vos modifications afin de les enregistrer à l’arborescence.After you modify a node, you must commit your changes in order for them to be saved to the tree. Pour plus d'informations, consultez la propriété CommitChanges.For more information, see the CommitChanges property.

DirectoryEntry peut être utilisé pour accéder aux entrées courantes et informations certains, mais pas tous, à partir des entrées de schéma.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

La hiérarchie des Services de domaine Active Directory contient jusqu'à plusieurs milliers de nœuds.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Chaque nœud représente un objet, tel qu’une imprimante réseau ou un utilisateur dans un domaine.Each node represents an object, such as a network printer or a user in a domain. Réseaux d’entreprise changent constamment de nouveaux employés embauchés et objets tels que des imprimantes réseau et les ordinateurs sont ajoutés.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. La technologie Active Directory Service Interfaces (ADSI) offre des moyens pour ajouter par programmation ces objets à l’arborescence de répertoires.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Pour créer une entrée d’annuaire dans la hiérarchie, utilisez le Children propriété.To create a directory entry in the hierarchy, use the Children property. Le Children propriété est une collection qui fournit un Add méthode, par le biais duquel vous ajoutez un nœud à la collection directement en dessous du nœud parent auquel vous êtes actuellement lié.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. 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.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. Par exemple, vous souhaiterez peut-être utiliser un schéma intitulé « Ordinateur » pour ajouter de nouveaux ordinateurs à la hiérarchie.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Cette classe contient également la mise en cache de l’attribut, qui peut être utile pour optimiser le trafic réseau.This class also contains attribute caching, which can be useful for optimizing network traffic. Pour utiliser la mise en cache de l’attribut, consultez le UsePropertyCache propriété.To use attribute caching, see the UsePropertyCache property.

Les classes associées à la DirectoryEntry composant peut être utilisé avec un des fournisseurs de services Active Directory Domain Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. Parmi les fournisseurs actuels sont Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS) et Windows NT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and 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.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Pour plus d’informations, consultez le System.DirectoryServices vue d’ensemble de l’espace de noms.For more information, see the System.DirectoryServices namespace overview.

Constructeurs

DirectoryEntry() DirectoryEntry() DirectoryEntry() DirectoryEntry()

Initialise une nouvelle instance de la classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object) 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é.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String) 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é.Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String)

Initialise une nouvelle instance de la classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes)

Initialise une nouvelle instance de la classe DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

Propriétés

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Obtient ou définit le type d'authentification à utiliser.Gets or sets the type of authentication to use.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Children Children Children Children

Obtient les entrées enfants de ce nœud dans la hiérarchie des services de domaine Active Directory.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Guid Guid Guid Guid

Obtient le GUID de DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name Name Name Name

Obtient le nom de l'objet, tel que nommé dans le service d'annuaire sous-jacent.Gets the name of the object as named with the underlying directory service.

NativeGuid NativeGuid NativeGuid NativeGuid

Obtient le GUID de DirectoryEntry, tel que retourné par le fournisseur.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject NativeObject NativeObject NativeObject

Obtient l'objet ADSI (Active Directory Service Interfaces) natif.Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity ObjectSecurity ObjectSecurity ObjectSecurity

Obtient ou définit le descripteur de sécurité de cette entrée.Gets or sets the security descriptor for this entry.

Options Options Options Options

Obtient les options spécifiques au fournisseur pour cette entrée.Gets the provider-specific options for this entry.

Parent Parent Parent Parent

Obtient le parent de cette entrée dans la hiérarchie des services de domaine Active Directory.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password Password Password Password

Définit le mot de passe à utiliser au moment de l'authentification du client.Sets the password to use when authenticating the client.

Path Path Path Path

Obtient ou définit le chemin d’accès de ce DirectoryEntry.Gets or sets the path for this DirectoryEntry.

Properties Properties Properties Properties

Obtient les propriétés des services de domaine Active Directory pour cet objet DirectoryEntry.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName SchemaClassName SchemaClassName SchemaClassName

Obtient le nom de la classe de schéma pour cet objet DirectoryEntry.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry SchemaEntry SchemaEntry SchemaEntry

Obtient l'objet schéma de cette entrée.Gets the schema object for this entry.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
UsePropertyCache UsePropertyCache UsePropertyCache UsePropertyCache

Obtient ou définit une valeur indiquant si le cache doit être validé après chaque opération.Gets or sets a value indicating whether the cache should be committed after each operation.

Username Username Username Username

Obtient ou définit le nom d'utilisateur à utiliser pour l'authentification du client.Gets or sets the user name to use when authenticating the client.

Méthodes

Close() Close() Close() Close()

Ferme l'objet DirectoryEntry et libère les ressources système associées à ce composant.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges() CommitChanges() CommitChanges() CommitChanges()

Enregistre les modifications apportées à une entrée d'annuaire dans le magasin d'annuaires sous-jacent.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry)

Crée une copie de cette entrée en tant qu'enfant du parent spécifié.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) 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é.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeleteTree() DeleteTree() DeleteTree() DeleteTree()

Supprime cette entrée et sa sous-arborescence entière de la hiérarchie des services de domaine Active Directory.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources, exceptée la mémoire, utilisées par DirectoryEntry.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Exists(String) Exists(String) Exists(String) Exists(String)

Détermine si le chemin d’accès spécifié représente une entrée réelle dans le service d’annuaire.Determines if the specified path represents an actual entry in the directory service.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[])

Appelle une méthode sur l'objet des services de domaine Active Directory natif.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String) InvokeGet(String) InvokeGet(String) InvokeGet(String)

Obtient une propriété à partir de l'objet des services de domaine Active Directory natif.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[])

Définit une propriété sur l'objet des services de domaine Active Directory natif.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry)

Déplace cet objet DirectoryEntry vers le parent spécifié.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) 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.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache() RefreshCache() RefreshCache() RefreshCache()

Charge les valeurs de propriétés de cet objet DirectoryEntry dans le cache de propriétés.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[])

Charge les valeurs des propriétés spécifiées dans le cache de propriétés.Loads the values of the specified properties into the property cache.

Rename(String) Rename(String) Rename(String) Rename(String)

Modifie le nom de cet objet DirectoryEntry.Changes the name of this DirectoryEntry object.

ToString() ToString() ToString() ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(Inherited from Component)

Événements

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Sécurité

DirectoryServicesPermission
LinkDemand

S’applique à