共用方式為


DirectorySearcher.SearchRoot 屬性

定義

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

屬性值

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

適用於