DirectorySearcher.SearchRoot Свойство

Определение

Пространство имен:

System.DirectoryServices

Сборка:

System.DirectoryServices.dll

Пакет:

System.DirectoryServices v8.0.0

Исходный код:

DirectorySearcher.cs

Получает или задает значение, указывающее узел в иерархии доменных служб Active Directory, с которого начинается поиск.

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

Значение свойства

DirectoryEntry

Объект DirectoryEntry в иерархии доменных служб Active Directory Domain, с которого начинается поиск. Значением по умолчанию является пустая ссылка (Nothing в Visual Basic).

Комментарии

Если SearchRoot является пустой ссылкой (Nothing в Visual Basic), для корня поиска устанавливается корень домена, который используется сервером.

Существует несколько способов поиска в глобальном каталоге.

• Перечислите глобальный каталог и выберите первый дочерний элемент.

• Укажите имя сервера. Используйте функцию DsGetDcName для поиска глобального каталога. Дополнительные сведения о функции DsGetDcName см. в разделе DsGetDcName.

• Получите RootDSE глобального каталога и запросите rootNamingContext.

• Используйте глобальный каталог, указав путь поиска, как при использовании ПРОТОКОЛА LDAP. Например, "GC://OU=..., DC=..., DC=...".

• В следующем коде C# показано, как перечислить глобальный каталог и выбрать первый дочерний элемент.

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