DirectoryEntry Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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::Componentpublic class DirectoryEntry : System.ComponentModel.Component[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public 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))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Componenttype DirectoryEntry = class
inherit Component[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))>]
type DirectoryEntry = class
inherit Component[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
inherit Component[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
[<System.DirectoryServices.DSDescription("DirectoryEntryDesc")>]
type DirectoryEntry = class
inherit ComponentPublic Class DirectoryEntry
Inherits Component- Héritage
- Attributs
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() |
Obsolète.
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() |
Obsolète.
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) |
