SearchResult.GetDirectoryEntry メソッド

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

SearchResult.GetDirectoryEntry メソッド

Active Directory 階層から SearchResult に対応する DirectoryEntry を取得します。

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

Visual Basic (宣言)

Public Function GetDirectoryEntry As
 DirectoryEntry

Visual Basic (使用法)

Dim instance As SearchResult
Dim returnValue As DirectoryEntry

returnValue = instance.GetDirectoryEntry

C#

public DirectoryEntry GetDirectoryEntry ()

C++

public:
DirectoryEntry^ GetDirectoryEntry ()

J#

public DirectoryEntry GetDirectoryEntry ()

JScript

public function GetDirectoryEntry () : DirectoryEntry

戻り値
SearchResult に対応する DirectoryEntry。

解説

DirectorySearcher を通じて返されるエントリではなく、ライブ エントリを参照する場合や、返されたオブジェクトでメソッドを呼び出す場合は、GetDirectoryEntry を使用します。

メモ
DirectorySearcher で返された SearchResult ごとに GetDirectoryEntry を呼び出すと、時間がかかることがあります。

使用例

次の例は、SearchResult の例の抜粋です。元の例は、目的のパスを持つ新しい DirectoryEntry オブジェクトを作成し、FindOne メソッドを使用して検索を実行します。この例では、検索を実行した後、GetDirectoryEntry メソッドを使用して、検索結果に示されるライブ ディレクトリ エントリを取得します。

Visual Basic

' Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
Dim myDirectoryEntry As DirectoryEntry = mySearchResult.GetDirectoryEntry()
Console.WriteLine(ControlChars.Newline + "The name of the
 'myDirectoryEntry' " + _
            "directory entry that corresponds to the "
 + _
            "'mySearchResult' search result is : {0}" + _
            ControlChars.Newline, myDirectoryEntry.Name)

// Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
DirectoryEntry myDirectoryEntry = 
                           mySearchResult.GetDirectoryEntry();
Console.WriteLine("\nThe name of the 'myDirectoryEntry'
 " +
                  "directory entry that corresponds to the "
 +
                  "'mySearchResult' search result is : {0}\n"
,
                  myDirectoryEntry.Name);

// Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
DirectoryEntry^ myDirectoryEntry = mySearchResult->GetDirectoryEntry();
Console::WriteLine(
    String::Concat("\nThe name of the
 'myDirectoryEntry' ",
    "directory entry that corresponds to the ",
    "'mySearchResult' search result is : {0}\n"),
    myDirectoryEntry->Name);

プラットフォーム

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

参照

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