Définition de la zone de recherche
Pour optimiser les performances de la recherche, vous pouvez limiter la zone de recherche à un seul objet ou à un seul sous-ensemble d'objets. Pour cette tâche, DirectorySearcher fournit la propriété SearchScope.
La zone de recherche peut être définie à l'aide de l'un des trois paramètres suivants :
- Base. La recherche porte sur l'objet lié et retourne cet objet uniquement s'il correspond au critère de recherche. Par exemple, si vous êtes lié au domaine, la recherche porte sur la totalité du domaine et retourne uniquement l'objet lié.
- OneLevel. La recherche porte sur tous les objets contenus dans le même niveau que l'objet lié. Par exemple, si vous êtes lié à un groupe, la recherche porte sur tous les groupes ou tous les autres objets situés au même niveau que ce groupe.
- Subtree. La recherche porte sur tous les objets contenus dans la sous-arborescence de l'objet lié, y compris sur l'objet de base. Par exemple, si vous êtes lié à un serveur, la recherche porte sur tous les objets de la hiérarchie situés au même niveau que ce serveur ou en dessous. Il s'agit de la valeur par défaut. Si vous effectuez une recherche de synchronisation d'annuaires avec un objet DirectorySynchronization, l'application doit spécifier la zone de recherche Subtree.
L'illustration suivante montre comment chaque zone de recherche s'adapte à la hiérarchie de votre domaine.
.gif)
L'exemple de code C# suivant montre comment utiliser la propriété SearchScope pour effectuer une recherche dans une sous-arborescence.
DirectoryEntry entry = new DirectoryEntry("LDAP://CN=users,DC=fabrikam,DC=com");
DirectorySearcher mySearcher = new DirectorySearcher(entry);
mySearcher.SearchScope = SearchScope.Subtree;
mySearcher.Filter = "(&(objectClass=user)(anr=test*))";
SearchResultCollection ResEnt = mySearcher.FindAll();
{
// Handle results.
}
// Handle exceptions.
Voir aussi
Référence
System.DirectoryServices
DirectorySearcher
SearchScope
DirectorySynchronization
Concepts
Send comments about this topic to Microsoft.
Copyright © 2007 par Microsoft Corporation. Tous droits réservés.