DirectorySearcher.SearchRoot 属性

定义

命名空间:

System.DirectoryServices

程序集:

System.DirectoryServices.dll

包:

System.DirectoryServices v8.0.0

Source:

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

Active Directory 域服务层次结构中的 DirectoryEntry 对象，从该对象处开始搜索。 默认为空引用（在 Visual Basic 中为 Nothing）。

注解

如果 SearchRoot 是 Visual Basic) 中的空引用 (Nothing ，则搜索根设置为服务器当前正在使用的域的根目录。

可通过多种方式在全局目录中进行搜索：

• 枚举全局编录并选择第一个子目录。

• 指定服务器名称。 使用 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);