Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

DirectoryEntry, classe

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)

[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.

  NomDescription
Méthode publiqueDirectoryEntry()Initialise une nouvelle instance de la classe DirectoryEntry.
Méthode publiqueDirectoryEntry(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 publiqueDirectoryEntry(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 publiqueDirectoryEntry(String, String, String)Initialise une nouvelle instance de la classe DirectoryEntry.
Méthode publiqueDirectoryEntry(String, String, String, AuthenticationTypes)Initialise une nouvelle instance de la classe DirectoryEntry.
Début

  NomDescription
Propriété publiqueAuthenticationTypeObtient ou définit le type d'authentification à utiliser.
Propriété protégéeCanRaiseEventsObtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component.)
Propriété publiqueChildrenObtient les entrées enfants de ce nœud dans la hiérarchie des services de domaine Active Directory.
Propriété publiqueContainerObtient le IContainer qui contient Component. (Hérité de Component.)
Propriété protégéeDesignModeObtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component.)
Propriété protégéeEventsObtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component.)
Propriété publiqueGuidObtient l'GUID du DirectoryEntry.
Propriété publiqueNameObtient le nom de l'objet, tel que nommé dans le service d'annuaire sous-jacent.
Propriété publiqueNativeGuidObtient le GUID de DirectoryEntry, tel que retourné par le fournisseur.
Propriété publiqueNativeObjectObtient l'objet ADSI (Active Directory Service Interfaces) natif.
Propriété publiqueObjectSecurityObtient ou définit le descripteur de sécurité de cette entrée.
Propriété publiqueOptionsObtient les options spécifiques au fournisseur pour cette entrée.
Propriété publiqueParentObtient le parent de cette entrée dans la hiérarchie des services de domaine Active Directory.
Propriété publiquePasswordDéfinit le mot de passe à utiliser lors de l'authentification du client.
Propriété publiquePathObtient ou définit le chemin d'accès de ce DirectoryEntry.
Propriété publiquePropertiesObtient les propriétés des services de domaine Active Directory pour cet objet DirectoryEntry.
Propriété publiqueSchemaClassNameObtient le nom de la classe de schéma pour cet objet DirectoryEntry.
Propriété publiqueSchemaEntryObtient l'objet schéma de cette entrée.
Propriété publiqueSiteObtient ou définit le ISite de Component. (Hérité de Component.)
Propriété publiqueUsePropertyCacheObtient ou définit une valeur indiquant si le cache doit être validé après chaque opération.
Propriété publiqueUsernameObtient ou définit le nom d'utilisateur à utiliser lors de l'authentification du client.
Début

  NomDescription
Méthode publiqueCloseFerme l'objet DirectoryEntry et libère les ressources système associées à ce composant.
Méthode publiqueCommitChangesEnregistre les modifications apportées à une entrée d'annuaire dans le magasin d'annuaires sous-jacent.
Méthode publiqueCopyTo(DirectoryEntry)Crée une copie de cette entrée en tant qu'enfant du parent spécifié.
Méthode publiqueCopyTo(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 publiqueCreateObjRefCré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 publiqueDeleteTreeSupprime cette entrée et sa sous-arborescence entière de la hiérarchie des services de domaine Active Directory.
Méthode publiqueDispose()Libère toutes les ressources utilisées par Component. (Hérité de Component.)
Méthode protégéeDispose(Boolean)Libère les ressources, exceptée la mémoire, utilisées par DirectoryEntry. (Substitue Component.Dispose(Boolean).)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueMembre statiqueExistsDé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éeFinalizeLibè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 publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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éeGetServiceRetourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient 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 publiqueInvokeAppelle une méthode sur l'objet des services de domaine Active Directory natif.
Méthode publiqueInvokeGetObtient une propriété à partir de l'objet des services de domaine Active Directory natif.
Méthode publiqueInvokeSetDéfinit une propriété sur l'objet des services de domaine Active Directory natif.
Méthode protégéeMemberwiseClone()Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publiqueMoveTo(DirectoryEntry)Déplace cet objet DirectoryEntry vers le parent spécifié.
Méthode publiqueMoveTo(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 publiqueRefreshCache()Charge les valeurs de propriétés de cet objet DirectoryEntry dans le cache de propriétés.
Méthode publiqueRefreshCache(String[])Charge les valeurs des propriétés spécifiées dans le cache de propriétés.
Méthode publiqueRenameModifie le nom de cet objet DirectoryEntry.
Méthode publiqueToStringRetourne String contenant le nom du Component, s'il existe. Cette méthode ne doit pas être substituée. (Hérité de Component.)
Début

  NomDescription
Événement publicDisposedSe 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 de répertoires.

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.

RemarqueRemarque

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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft