DirectorySearcher.SearchRoot Vlastnost

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

DirectorySearcher.cs

Získá nebo nastaví hodnotu označující uzel v hierarchii Active Directory Domain Services, kde začíná hledání.

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

Hodnota vlastnosti

DirectoryEntry

Objekt DirectoryEntry v hierarchii Active Directory Domain Services, kde vyhledávání začíná. Výchozí hodnota je odkaz s hodnotou null (Nothing v jazyce Visual Basic).

Poznámky

Pokud SearchRoot je odkaz null (Nothing v jazyce Visual Basic), kořen vyhledávání je nastaven na kořen domény, kterou váš server aktuálně používá.

V globálním katalogu můžete hledat několika způsoby:

• Zadejte výčet globálního katalogu a vyberte první podřízené položky.

• Zadejte název serveru. K vyhledání globálního katalogu použijte funkci DsGetDcName. Další informace o funkci DsGetDcName najdete v tématu DsGetDcName.

• Získejte rootDSE globálního katalogu a požádejte o rootNamingContext.

• Použijte globální katalog a zadejte vyhledávací cestu, jako by se používal protokol LDAP. Například "GC://OU=..., DC=..., DC=...".

• Následující kód jazyka C# ukazuje, jak vytvořit výčet globálního katalogu a vybrat první podřízený kód.

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