DirectorySearcher.SearchRoot Proprietà

Definizione

Spazio dei nomi:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacchetto:

System.DirectoryServices v8.0.0

Origine:

DirectorySearcher.cs

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; }

member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

Valore della proprietà

DirectoryEntry

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

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);