DirectorySearcher.SearchRoot 屬性

定義

命名空間:

System.DirectoryServices

組件:

System.DirectoryServices.dll

取得或設定值，表示 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; }

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 網域服務階層架構中的 DirectoryEntry 物件，是搜尋開始的位置。 預設為 null 參考 (在 Visual Basic 中為 Nothing)。

屬性

DSDescriptionAttribute

備註

如果 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);