Condividi tramite


DirectorySearcher.SearchRoot Proprietà

Definizione

Ottiene o imposta un valore che indica il nodo della gerarchia dei Servizi di dominio Active Directory in cui viene avviata la ricerca.

public:
 property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }
[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
[<System.DirectoryServices.DSDescription("DSSearchRoot")>]
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
Public Property SearchRoot As DirectoryEntry

Valore della proprietà

Il DirectoryEntry oggetto nella gerarchia dei Servizi di dominio Active Directory in cui inizia la ricerca. Il valore predefinito è un riferimento null (Nothing in Visual Basic).

Attributi

Commenti

Se SearchRoot è un riferimento Null (Nothing in Visual Basic), la radice di ricerca viene impostata sulla radice del dominio attualmente utilizzato dal server.

Esistono diversi modi per eseguire ricerche nel catalogo globale:

  • Enumera il catalogo globale e seleziona il primo elemento figlio.

  • Specificare il nome del server. Usare la funzione DsGetDcName per trovare il catalogo globale. Per altre informazioni sulla funzione DsGetDcName, vedere DsGetDcName.

  • Ottenere RootDSE del catalogo globale e richiedere "rootNamingContext".

  • Usare il catalogo globale, specificando un percorso di ricerca come se si usa LDAP. Ad esempio, "GC://OU=..., DC=..., DC=...".

  • Il codice C# seguente illustra come enumerare il catalogo globale e selezionare il primo elemento figlio.

    DirectoryEntry entry = new DirectoryEntry("GC://forestname");  
    IEnumerator ie = entry.Children.GetEnumerator();  
    ie.MoveNext();  
    entry = (DirectoryEntry)ie.Current;  
    DirectorySearcher search = new DirectorySearcher(entry);  
    

Si applica a