DirectorySearcher.SearchRoot プロパティ

.NET Framework クラス ライブラリ リファレンス

DirectorySearcher.SearchRoot プロパティ

検索を開始する Active Directory 階層のノードを示す値を取得または設定します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文

Visual Basic (宣言)

Public Property SearchRoot As
 DirectoryEntry

Visual Basic (使用法)

Dim instance As DirectorySearcher
Dim value As DirectoryEntry

value = instance.SearchRoot

instance.SearchRoot = value

C#

public DirectoryEntry SearchRoot { get; set;
 }

C++

public:
property DirectoryEntry^ SearchRoot {
    DirectoryEntry^ get ();
    void set (DirectoryEntry^ value);
}

J#

/** @property */
public DirectoryEntry get_SearchRoot ()

/** @property */
public void set_SearchRoot (DirectoryEntry
 value)

JScript

public function get SearchRoot
 () : DirectoryEntry

public function set SearchRoot
 (value : DirectoryEntry)

プロパティ値
検索を開始する Active Directory 階層の DirectoryEntry オブジェクト。既定値が null 参照 (Visual Basic の場合は Nothing) です。

解説

SearchRoot が null 参照 (Visual Basic の場合は Nothing) の場合、検索ルートはサーバーが現在使用しているドメインのルートに設定されます。

グローバル カタログを検索するには、複数の方法があります。

• グローバル カタログを列挙し、最初の子を選択します。

• サーバー名を指定します。DsGetDcName 関数を使用して、グローバル カタログを検索します。DsGetDcName 関数の詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja) にある "DsGetDcName" のトピックを参照してください。

• グローバル カタログの RootDSE を取得し、"rootNamingContext" を要求します。

• グローバル カタログを使用して、LDAP を使用するときのように検索パスを指定します。たとえば、"GC://OU=..., DC=..., DC=..." のようにします。

• グローバル カタログを列挙し、最初の子を選択する方法を次の C# コードに示します。

  C#

  DirectoryEntry entry = new DirectoryEntry("GC://forestname");
  IEnumerator ie = entry.Children.GetEnumerator();
  ie.MoveNext();
  entry = (DirectoryEntry)ie.Current;
  DirectorySearcher search = new DirectorySearcher(entry);
  

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DirectorySearcher クラス
DirectorySearcher メンバ
System.DirectoryServices 名前空間