Cette documentation est archivée et n’est pas conservée.

DirectorySearcher, classe

Exécute des requêtes dans Active Directory.

Espace de noms : System.DirectoryServices
Assembly : System.DirectoryServices (dans system.directoryservices.dll)

public class DirectorySearcher : Component
public class DirectorySearcher extends Component
public class DirectorySearcher extends Component

Utilisez un objet DirectorySearcher pour exécuter des recherches et des requêtes dans une hiérarchie 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 Utilisation de 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. Les mises à jour sont effectuées dans ce cache local et validées dans Active Directory uniquement lorsque vous appelez la méthode DirectoryEntry.CommitChanges.

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

RemarqueRemarque

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.

RemarqueRemarque

Il est supposé que vous vous êtes familiarisé avec Active Directory avant de commencer à utiliser ces classes. Pour plus d'informations, consultez la vue d'ensemble System.DirectoryServices.

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

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: