DirectorySearcher.SearchRoot Свойство

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

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

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

Атрибуты

DSDescriptionAttribute

Комментарии

Если 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);  
  

Применяется к