Impostazione dell'ambito di ricerca

Per aumentare le prestazioni della ricerca, limitare l'ambito a un singolo oggetto o sottoinsieme di oggetti. A questo scopo, l'oggetto DirectorySearcher fornisce la proprietà SearchScope.

L'ambito della ricerca può essere impostato in tre modi diversi:

• Base. Viene eseguita la ricerca nell'oggetto associato e viene restituito solo quell'oggetto se corrisponde ai criteri specificati. Ad esempio, in caso di associazione al dominio, la ricerca riguarderà tutto il dominio e restituirà solo l'oggetto associato.
• OneLevel. Viene eseguita la ricerca in tutti gli oggetti contenuti allo stesso livello dell'oggetto associato. Ad esempio, in caso di associazione a un gruppo, la ricerca riguarderà tutti i gruppi o altri oggetti che sono allo stesso livello di quel gruppo.
• Subtree. Viene eseguita la ricerca in tutti gli oggetti contenuti nella sottostruttura dell'oggetto associato, compreso l'oggetto base. Ad esempio, in caso di associazione a un server, la ricerca riguarderà tutti gli oggetti nella gerarchia che sono allo stesso livello o a un livello inferiore rispetto al server. È il valore predefinito. Se si esegue una ricerca di sincronizzazione della directory con un oggetto DirectorySynchronization, nell'applicazione dovrà essere specificato un ambito Subtree.

Nella figura seguente viene illustrato come ognuno di questi ambiti soddisfa la gerarchia dei domini.

Nell'esempio di codice C# riportato di seguito viene illustrato come utilizzare la proprietà SearchScope per eseguire ricerche in una sottostruttura.

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.

Vedere anche

Riferimenti

System.DirectoryServices
DirectorySearcher
SearchScope
DirectorySynchronization

Concetti

Ricerca nella directory

Send comments about this topic to Microsoft.

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.