DirectorySearcher.SearchRoot Właściwość

Definicja

Przestrzeń nazw:

System.DirectoryServices

Zestaw:

System.DirectoryServices.dll

Pakiet:

System.DirectoryServices v8.0.0

Źródło:

DirectorySearcher.cs

Pobiera lub ustawia wartość wskazującą węzeł w hierarchii Active Directory Domain Services, w której rozpoczyna się wyszukiwanie.

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

Wartość właściwości

DirectoryEntry

DirectoryEntry Obiekt w hierarchii Active Directory Domain Services, w której rozpoczyna się wyszukiwanie. Wartość domyślna to odwołanie o wartości null (Nothing w Visual Basic).

Uwagi

Jeśli SearchRoot jest odwołaniem o wartości null (Nothing w Visual Basic), katalog główny wyszukiwania jest ustawiony na katalog główny domeny, z którą aktualnie korzysta serwer.

Istnieje kilka sposobów wyszukiwania w wykazie globalnym:

• Wyliczenie wykazu globalnego i wybranie pierwszego elementu podrzędnego.

• Określ nazwę serwera. Użyj funkcji DsGetDcName, aby znaleźć wykaz globalny. Aby uzyskać więcej informacji na temat funkcji DsGetDcName, zobacz DsGetDcName.

• Pobierz element RootDSE wykazu globalnego i poproś o "rootNamingContext".

• Użyj wykazu globalnego, określając ścieżkę wyszukiwania tak, jakby używała protokołu LDAP. Na przykład "GC://OU=..., DC=..., DC=...".

• Poniższy kod w języku C# pokazuje, jak wyliczyć wykaz globalny i wybrać pierwsze dziecko.

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