Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

DirectoryEntry, classe

.NET Framework 4

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

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

Espace de noms :  System.DirectoryServices
Assembly :  System.DirectoryServices (dans System.DirectoryServices.dll)
C#
C++
F#
VB
Copier 
[DSDescriptionAttribute("DirectoryEntryDesc")]
[SecurityPermissionAttribute(SecurityAction.Assert, Flags = SecurityPermissionFlag.UnmanagedCode)]
[EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)]
public class DirectoryEntry : Component

Le type DirectoryEntry expose les membres suivants.

  Nom Description
Méthode publique DirectoryEntry() Initialise une nouvelle instance de la classe DirectoryEntry.
Méthode publique 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é.
Méthode publique 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é.
Méthode publique DirectoryEntry(String, String, String) Initialise une nouvelle instance de la classe DirectoryEntry.
Méthode publique DirectoryEntry(String, String, String, AuthenticationTypes) Initialise une nouvelle instance de la classe DirectoryEntry.
Début
  Nom Description
Propriété publique AuthenticationType Obtient ou définit le type d'authentification à utiliser.
Propriété protégée CanRaiseEvents Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component.)
Propriété publique Children Obtient les entrées enfants de ce nœud dans la hiérarchie des services de domaine Active Directory.
Propriété publique Container Obtient le IContainer qui contient Component. (Hérité de Component.)
Propriété protégée DesignMode Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component.)
Propriété protégée Events Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component.)
Propriété publique Guid Obtient le GUID de DirectoryEntry.
Propriété publique Name Obtient le nom de l'objet, tel que nommé dans le service d'annuaire sous-jacent.
Propriété publique NativeGuid Obtient le GUID de DirectoryEntry, tel que retourné par le fournisseur.
Propriété publique NativeObject Obtient l'objet ADSI (Active Directory Service Interfaces) natif.
Propriété publique ObjectSecurity Obtient ou définit le descripteur de sécurité de cette entrée.
Propriété publique Options Obtient les options spécifiques au fournisseur pour cette entrée.
Propriété publique Parent Obtient le parent de cette entrée dans la hiérarchie des services de domaine Active Directory.
Propriété publique Password Définit le mot de passe à utiliser lors de l'authentification du client.
Propriété publique Path Obtient ou définit le chemin d'accès de ce DirectoryEntry.
Propriété publique Properties Obtient les propriétés des services de domaine Active Directory pour cet objet DirectoryEntry.
Propriété publique SchemaClassName Obtient le nom de la classe de schéma pour cet objet DirectoryEntry.
Propriété publique SchemaEntry Obtient l'objet schéma de cette entrée.
Propriété publique Site Obtient ou définit le ISite de Component. (Hérité de Component.)
Propriété publique UsePropertyCache Obtient ou définit une valeur indiquant si le cache doit être validé après chaque opération.
Propriété publique Username Obtient ou définit le nom d'utilisateur à utiliser lors de l'authentification du client.
Début
  Nom Description
Méthode publique Close Ferme l'objet DirectoryEntry et libère les ressources système associées à ce composant.
Méthode publique CommitChanges Enregistre les modifications apportées à une entrée d'annuaire dans le magasin d'annuaires sous-jacent.
Méthode publique CopyTo(DirectoryEntry) Crée une copie de cette entrée en tant qu'enfant du parent spécifié.
Méthode publique 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é.
Méthode publique CreateObjRef 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.)
Méthode publique DeleteTree Supprime cette entrée et sa sous-arborescence entière de la hiérarchie des services de domaine Active Directory.
Méthode publique Dispose() Libère toutes les ressources utilisées par Component. (Hérité de Component.)
Méthode protégée Dispose(Boolean) Libère les ressources, exceptée la mémoire, utilisées par DirectoryEntry. (Substitue Component.Dispose(Boolean).)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publique Membre statique Exists Détermine si le chemin d'accès spécifié représente une entrée réelle dans le service d'annuaire.
Méthode protégée Finalize Libère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération de Component par le garbage collection. (Hérité de Component.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique 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.)
Méthode protégée GetService Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique 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.)
Méthode publique Invoke Appelle une méthode sur l'objet des services de domaine Active Directory natif.
Méthode publique InvokeGet Obtient une propriété à partir de l'objet des services de domaine Active Directory natif.
Méthode publique InvokeSet Définit une propriété sur l'objet des services de domaine Active Directory natif.
Méthode protégée MemberwiseClone() Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée MemberwiseClone(Boolean) Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publique MoveTo(DirectoryEntry) Déplace cet objet DirectoryEntry vers le parent spécifié.
Méthode publique 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.
Méthode publique RefreshCache() Charge les valeurs de propriétés de cet objet DirectoryEntry dans le cache de propriétés.
Méthode publique RefreshCache(String[]) Charge les valeurs des propriétés spécifiées dans le cache de propriétés.
Méthode publique Rename Modifie le nom de cet objet DirectoryEntry.
Méthode publique ToString Retourne String contenant le nom du Component, s'il existe. Cette méthode ne doit pas être substituée. (Hérité de Component.)
Début
  Nom Description
Événement public Disposed Se produit lorsque le composant est supprimé par un appel à la méthode Dispose. (Hérité de Component.)
Début

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 des services de domaine 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 de domaine 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.

Remarque Remarque

Vous êtes supposé posséder des connaissances générales sur les services de domaine Active Directory avant d'utiliser cette classe. Pour plus d'informations, consultez la vue d'ensemble de l'espace de noms System.DirectoryServices.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ