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

[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }

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 網域服務 階層中物件。 預設是 null 參考（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);