DirectorySearcher.SearchRoot Właściwość

Definicja

Przestrzeń nazw:

System.DirectoryServices

Zestaw:

System.DirectoryServices.dll

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

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

Wartość właściwości

DirectoryEntry

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

Atrybuty

DSDescriptionAttribute

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órego obecnie 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 wyrażenie "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# przedstawia sposób wyliczania wykazu globalnego i wybierania pierwszego elementu podrzędnego.

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