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

DirectorySearcher, classe

.NET Framework 4

Effectue des requêtes sur des services de domaine Active Directory.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.DirectoryServices.DirectorySearcher

Espace de noms :  System.DirectoryServices
Assembly :  System.DirectoryServices (dans System.DirectoryServices.dll)
C#
C++
F#
VB
Copier 
[DSDescriptionAttribute("DirectorySearcherDesc")]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)]
public class DirectorySearcher : Component

Le type DirectorySearcher expose les membres suivants.

  Nom Description
Méthode publique DirectorySearcher() Initialise une nouvelle instance de la classe DirectorySearcher avec des valeurs par défaut.
Méthode publique DirectorySearcher(DirectoryEntry) Initialise une nouvelle instance de la classe DirectorySearcher à l'aide de la racine de recherche spécifiée.
Méthode publique DirectorySearcher(String) Initialise une nouvelle instance de la classe DirectorySearcher avec le filtre de recherche spécifié.
Méthode publique DirectorySearcher(DirectoryEntry, String) Initialise une nouvelle instance de la classe DirectorySearcher avec la racine et le filtre de recherche spécifiés.
Méthode publique DirectorySearcher(String, String[]) Initialise une nouvelle instance de la classe DirectorySearcher avec le filtre de recherche et les propriétés à récupérer spécifiés.
Méthode publique DirectorySearcher(DirectoryEntry, String, String[]) Initialise une nouvelle instance de la classe DirectorySearcher avec la racine de recherche, le filtre de recherche et les propriétés à récupérer spécifiés.
Méthode publique DirectorySearcher(String, String[], SearchScope) Initialise une nouvelle instance de la classe DirectorySearcher avec le filtre de recherche, les propriétés à récupérer et la zone de recherche spécifiés.
Méthode publique DirectorySearcher(DirectoryEntry, String, String[], SearchScope) Initialise une nouvelle instance de la classe DirectorySearcher avec la racine de recherche, le filtre de recherche, les propriétés à récupérer et la zone de recherche spécifiés.
Début
  Nom Description
Propriété publique Asynchronous Obtient ou définit une valeur qui indique si la recherche est réalisée de manière asynchrone.
Propriété publique AttributeScopeQuery Obtient ou définit le nom complet LDAP de l'attribut de nom unique dans lequel effectuer une recherche. Un seul attribut peut être utilisé pour ce type de recherche.
Propriété publique CacheResults Obtient ou définit une valeur indiquant si le résultat est mis en cache sur l'ordinateur client.
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 ClientTimeout Obtient ou définit le délai maximal durant lequel le client attend le retour des résultats par le serveur. Si le serveur ne répond pas avant l'expiration de ce délai, la recherche est abandonnée et aucun résultat n'est retourné.
Propriété publique Container Obtient le IContainer qui contient Component. (Hérité de Component.)
Propriété publique DerefAlias Obtient ou définit une valeur indiquant de quelle manière les alias d'objets qui sont trouvés au cours d'une recherche doivent être résolus.
Propriété protégée DesignMode Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component.)
Propriété publique DirectorySynchronization Obtient ou définit un objet qui représente le contrôle de synchronisation d'annuaires à utiliser avec la recherche.
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 ExtendedDN Obtient ou définit une valeur qui indique le format des noms uniques.
Propriété publique Filter Obtient ou définit une valeur indiquant la chaîne de filtrage au format LDAP (Lightweight Directory Access Protocol).
Propriété publique PageSize Obtient ou définit une valeur indiquant la taille de la page dans une recherche paginée.
Propriété publique PropertiesToLoad Obtient une valeur indiquant la liste de propriétés à récupérer au cours de la recherche.
Propriété publique PropertyNamesOnly Obtient ou définit une valeur indiquant si la recherche récupère uniquement les noms des attributs auxquels des valeurs ont été assignées.
Propriété publique ReferralChasing Obtient ou définit une valeur indiquant comment les références sont repérées.
Propriété publique SearchRoot Obtient ou définit une valeur qui indique le nœud dans la hiérarchie des services de domaine Active Directory où la recherche démarre.
Propriété publique SearchScope Obtient ou définit une valeur indiquant la zone de recherche observée par le serveur.
Propriété publique SecurityMasks Obtient ou définit une valeur indiquant quelles informations d'accès de sécurité pour les attributs spécifiés doivent être retournées par la recherche.
Propriété publique ServerPageTimeLimit Obtient ou définit une valeur indiquant la durée maximale pendant laquelle le serveur doit rechercher une page individuelle de résultats. Il ne s'agit pas du délai de la recherche entière.
Propriété publique ServerTimeLimit La propriété ServerTimeLimit obtient ou définit une valeur indiquant la durée maximale de la recherche par le serveur. Une fois ce délai atteint, seules les entrées trouvées jusqu'à cet instant sont retournées.
Propriété publique Site Obtient ou définit le ISite de Component. (Hérité de Component.)
Propriété publique SizeLimit Obtient ou définit une valeur indiquant le nombre maximal d'objets retournés par le serveur au cours d'une recherche.
Propriété publique Sort Obtient ou définit une valeur indiquant la propriété sur laquelle les résultats sont stockés.
Propriété publique Tombstone Obtient ou définit une valeur indiquant si la recherche doit également retourner les objets supprimés qui correspondent au filtre de recherche.
Propriété publique VirtualListView Obtient ou définit une valeur indiquant les options de vue de liste virtuelle de la recherche.
Début
  Nom Description
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 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 managées utilisées par l'objet DirectorySearcher et libère éventuellement les ressources non managées. (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 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 FindAll Exécute la recherche et retourne une collection contenant les entrées trouvées.
Méthode publique FindOne Exécute la recherche et retourne uniquement la première entrée trouvée.
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 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 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 un objet DirectorySearcher pour effectuer des recherches et exécuter des requêtes sur une hiérarchie de services de domaine Active Directory à l'aide du protocole LDAP (Lightweight Directory Access Protocol). LDAP est le seul fournisseur ADSI fourni par le système capable de prendre en charge les recherches dans les annuaires. Un administrateur peut créer, modifier ou supprimer les objets trouvés dans la hiérarchie. Pour plus d'informations, consultez Using System.DirectoryServices.

Lorsque vous créez une instance de DirectorySearcher, vous spécifiez la racine à récupérer, ainsi qu'une liste facultative de propriétés à récupérer. La propriété SearchRoot vous permet de définir des propriétés supplémentaires afin d'effectuer les tâches suivantes :

  • Mettre en cache les résultats de la recherche sur l'ordinateur local. Affectez la valeur true à la propriété CacheResults pour enregistrer les informations d'annuaire sur l'ordinateur local. Des mises à jour sont effectuées sur ce cache local et validées dans les services de domaine Active Directory seulement lorsque la méthode DirectoryEntry.CommitChanges est appelée.

  • Spécifier la durée de la recherche à l'aide de la propriété ServerTimeLimit.

  • Récupérer uniquement les noms d'attributs. Affectez la valeur true à la propriété PropertyNamesOnly pour récupérer uniquement les noms des attributs auxquels des valeurs ont été assignées.

  • Exécuter une recherche paginée. Définissez la propriété PageSize afin de spécifier le nombre maximal d'objets à retourner dans une recherche paginée. Si une recherche paginée n'est pas nécessaire, affectez la valeur par défaut zéro à la propriété PageSize.

  • Indiquer le nombre maximal d'entrées à retourner à l'aide de la propriété SizeLimit. Si vous affectez sa valeur par défaut zéro à la propriété SizeLimit, la valeur par défaut déterminée par le serveur est de 1000 entrées.

Remarque Remarque

Si les valeurs spécifiées pour le nombre maximal d'entrées retournées et la durée de la recherche sont supérieures aux limites définies sur le serveur, les paramètres du serveur se substituent à ceux du composant.

Pour obtenir la liste des valeurs initiales des propriétés d'une instance de la classe DirectorySearcher, consultez le constructeur DirectorySearcher().

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 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
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Confidentialité