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

Active Directory 網域服務階層架構中的 DirectoryEntry 物件，是搜尋開始的位置。 預設為 null 參考 (在 Visual Basic 中為 Nothing)。

備註

如果 SearchRoot 是 Visual Basic) 中的 null 參考 (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);