DirectorySearcher 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.
Effectue des requêtes sur les services de domaine Active Directory.
public ref class DirectorySearcher : System::ComponentModel::Componentpublic class DirectorySearcher : System.ComponentModel.Component[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Componenttype DirectorySearcher = class
inherit Component[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
inherit ComponentPublic Class DirectorySearcher
Inherits Component- Héritage
- Attributs
Remarques
Utilisez un DirectorySearcher objet pour rechercher et effectuer des requêtes sur une hiérarchie Active Directory Domain Services à l’aide du protocole LDAP (Lightweight Directory Access Protocol). LDAP est le seul fournisseur ADSI (Active Directory Service Interfaces) fourni par le système qui prend en charge la recherche d’annuaires. Un administrateur peut effectuer, modifier et supprimer des 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 et une liste facultative de propriétés à récupérer. La SearchRoot propriété vous permet de définir des propriétés supplémentaires pour effectuer les tâches suivantes :
Cachez les résultats de recherche sur l’ordinateur local. Définissez la CacheResults propriété pour
truestocker les informations d’annuaire sur l’ordinateur local. Les mises à jour sont apportées à ce cache local et validées dans Les services de domaine Active Directory uniquement lorsque la DirectoryEntry.CommitChanges méthode est appelée.Spécifiez la durée de recherche à l’aide de la ServerTimeLimit propriété.
Récupérez uniquement les noms d’attributs. Définissez la PropertyNamesOnly propriété pour
truerécupérer uniquement les noms des attributs auxquels les valeurs ont été affectées.Effectuez une recherche paginée. Définissez la PageSize propriété pour spécifier le nombre maximal d’objets retournés dans une recherche paginée. Si vous ne souhaitez pas effectuer de recherche paginée, définissez la PageSize propriété sur sa valeur par défaut zéro.
Spécifiez le nombre maximal d’entrées à retourner, à l’aide de la SizeLimit propriété. Si vous définissez la SizeLimit propriété sur sa valeur par défaut de zéro, la valeur par défaut déterminée par le serveur est de 1 000 entrées.
Note
Si le nombre maximal d’entrées retournées et les limites de temps dépassent les limitations définies sur le serveur, les paramètres du serveur remplacent les paramètres du composant.
Pour obtenir la liste des valeurs de propriété initiales d’une instance de la DirectorySearcher classe, consultez le DirectorySearcher() constructeur.
Note
Il est supposé que vous avez une compréhension générale des services de domaine Active Directory avant d’utiliser cette classe. Pour plus d’informations, consultez la vue d’ensemble System.DirectoryServices .
Constructeurs
| Nom | Description |
|---|---|
| DirectorySearcher() |
Initialise une nouvelle instance de la DirectorySearcher classe avec des valeurs par défaut. |
| DirectorySearcher(DirectoryEntry, String, String[], SearchScope) |
Initialise une nouvelle instance de la DirectorySearcher classe avec la racine de recherche, le filtre de recherche, les propriétés à récupérer et l’étendue de recherche spécifiées. |
| DirectorySearcher(DirectoryEntry, String, String[]) |
Initialise une nouvelle instance de la DirectorySearcher classe avec la racine de recherche, le filtre de recherche et les propriétés spécifiés à récupérer. |
| DirectorySearcher(DirectoryEntry, String) |
Initialise une nouvelle instance de la DirectorySearcher classe avec la racine de recherche et le filtre de recherche spécifiés. |
| DirectorySearcher(DirectoryEntry) |
Initialise une nouvelle instance de la DirectorySearcher classe à l’aide de la racine de recherche spécifiée. |
| DirectorySearcher(String, String[], SearchScope) |
Initialise une nouvelle instance de la DirectorySearcher classe avec le filtre de recherche, les propriétés à récupérer et l’étendue de recherche spécifiés. |
| DirectorySearcher(String, String[]) |
Initialise une nouvelle instance de la DirectorySearcher classe avec le filtre de recherche et les propriétés spécifiés à récupérer. |
| DirectorySearcher(String) |
Initialise une nouvelle instance de la DirectorySearcher classe avec le filtre de recherche spécifié. |
Propriétés
| Nom | Description |
|---|---|
| Asynchronous |
Obtient ou définit une valeur qui indique si la recherche est effectuée de façon asynchrone. |
| 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. |
| CacheResults |
Obtient ou définit une valeur indiquant si le résultat est mis en cache sur l’ordinateur client. |
| CanRaiseEvents |
Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component) |
| ClientTimeout |
Obtient ou définit la durée maximale pendant laquelle le client attend que le serveur retourne les résultats. Si le serveur ne répond pas dans ce délai, la recherche est abandonnée et aucun résultat n’est retourné. |
| Container |
Obtient le IContainer fichier qui contient le Component. (Hérité de Component) |
| DerefAlias |
Obtient ou définit une valeur indiquant comment les alias d’objets trouvés pendant une recherche doivent être résolus. |
| DesignMode |
Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component) |
| DirectorySynchronization |
Obtient ou définit un objet qui représente le contrôle de synchronisation d’annuaires à utiliser avec la recherche. |
| Events |
Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component) |
| ExtendedDN |
Obtient ou définit une valeur qui indique le format des noms uniques. |
| Filter |
Obtient ou définit une valeur indiquant la chaîne de filtre de format LDAP (Lightweight Directory Access Protocol). |
| PageSize |
Obtient ou définit une valeur indiquant la taille de page dans une recherche paginée. |
| PropertiesToLoad |
Obtient une valeur indiquant la liste des propriétés à récupérer pendant la recherche. |
| PropertyNamesOnly |
Obtient ou définit une valeur indiquant si la recherche récupère uniquement les noms des attributs auxquels les valeurs ont été affectées. |
| ReferralChasing |
Obtient ou définit une valeur indiquant comment les références sont poursuivies. |
| SearchRoot |
Obtient ou définit une valeur indiquant le nœud dans la hiérarchie des services de domaine Active Directory où la recherche démarre. |
| SearchScope |
Obtient ou définit une valeur indiquant l’étendue de la recherche observée par le serveur. |
| 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. |
| ServerPageTimeLimit |
Obtient ou définit une valeur indiquant la durée maximale pendant laquelle le serveur doit rechercher une page de résultats individuelle. Ce n’est pas le même que la limite de temps pour l’ensemble de la recherche. |
| ServerTimeLimit |
La ServerTimeLimit propriété obtient ou définit une valeur indiquant le temps maximal passé par le serveur à effectuer une recherche. Si la limite de temps est atteinte, seules les entrées trouvées jusqu’à ce point sont retournées. |
| Site |
Obtient ou définit le ISiteComponent. (Hérité de Component) |
| SizeLimit |
Obtient ou définit une valeur indiquant le nombre maximal d’objets retournés par le serveur dans une recherche. |
| Sort |
Obtient ou définit une valeur indiquant la propriété sur laquelle les résultats sont triés. |
| Tombstone |
Obtient ou définit une valeur indiquant si la recherche doit également retourner des objets supprimés qui correspondent au filtre de recherche. |
| VirtualListView |
Obtient ou définit une valeur indiquant les options d’affichage de liste virtuelle pour la recherche. |
Méthodes
| Nom | Description |
|---|---|
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par le Component. (Hérité de Component) |
| Dispose(Boolean) |
Libère les ressources managées utilisées par l’objet DirectorySearcher et, éventuellement, libère des ressources non managées. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindAll() |
Exécute la recherche et retourne une collection des entrées trouvées. |
| FindOne() |
Exécute la recherche et retourne uniquement la première entrée trouvée. |
| GetHashCode() |
Sert 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 actuel 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 le Component ou par son Container. (Hérité de Component) |
| GetType() |
Obtient la 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) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| ToString() |
Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component) |
Événements
| Nom | Description |
|---|---|
| Disposed |
Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component) |
