SearchResult

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

SearchResult クラス

SearchResult クラスは、DirectorySearcher を使用した検索中に返される Active Directory 階層のノードをカプセル化します。

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

Visual Basic (宣言)

Public Class SearchResult

Visual Basic (使用法)

Dim instance As SearchResult

C#

public class SearchResult

C++

public ref class SearchResult

J#

public class SearchResult

JScript

public class SearchResult

解説

SearchResult クラスのインスタンスは、DirectoryEntry クラスのインスタンスに非常に似ています。DirectoryEntry クラスは新しいオブジェクトにアクセスするたびに Active Directory 階層から情報を取得しますが、SearchResult のデータは DirectorySearcher クラスで実行したクエリが返す SearchResultCollection の中で先に利用できる点が大きな違いです。クエリの DirectorySearcher.PropertiesToLoad コレクションで指定したプロパティだけが、SearchResult で使用できます。

使用例

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

Visual Basic

Imports System
Imports System.DirectoryServices
Imports Microsoft.VisualBasic

Public Class MySample
   Public Shared Sub Main()
      Dim myLDAPPath As String
 = ""
      Try
         ' Create a 'DirectoryEntry' object to search.
         Console.WriteLine("Enter the path ( Ex : 'LDAP://MyServer')")
         myLDAPPath = Console.ReadLine()
         Dim mySearchRoot As New
 DirectoryEntry(myLDAPPath)
         
         Dim myDirectorySearcher As New
 DirectorySearcher(mySearchRoot)
         
         ' Get the first entry of the search.
         Dim mySearchResult As SearchResult
 = myDirectorySearcher.FindOne()
         If Not (mySearchResult Is
 Nothing) Then
            ' 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)
            Dim mySearchResultPath As String
 = mySearchResult.Path
            Console.WriteLine("The path for the 'mySearchResult'
 search result is : {0}" + _
                              ControlChars.Newline, mySearchResultPath)
            ' Get the properties of the 'mySearchResult'.
            Dim myResultPropColl As ResultPropertyCollection
            myResultPropColl = mySearchResult.Properties
            Console.WriteLine("The properties of the 'mySearchResult'
 are :")
            Dim myKey As String
            For Each myKey In
  myResultPropColl.PropertyNames
               Dim tab1 As String
 = "    "
               Console.WriteLine(myKey + " = ")
               Dim myCollection As Object
               For Each myCollection In
  myResultPropColl(myKey)
                  Console.WriteLine(tab1 + myCollection)
               Next myCollection
            Next myKey
            myDirectoryEntry.Dispose()
            mySearchRoot.Dispose()
         Else
            Console.WriteLine("The '" + myLDAPPath + "'
 path not found.")
         End If
      Catch e As Exception
         Console.WriteLine("The '" + myLDAPPath + "'
 path not found.")
         Console.WriteLine("Exception : " & e.Message)
      End Try
   End Sub 'Main
End Class 'MySample
using System;
using System.DirectoryServices;

public class MySample
{
    public static void Main()
    {
        string myLDAPPath = "";
        try
        {
            // Create a 'DirectoryEntry' object to search.
            Console.WriteLine("Enter the path ( Ex : 'LDAP://MyServer')");
            myLDAPPath = Console.ReadLine();

            DirectoryEntry mySearchRoot = new DirectoryEntry(myLDAPPath);
            DirectorySearcher myDirectorySearcher = 
                    new DirectorySearcher(mySearchRoot);

            // Get the first entry of the search.
            SearchResult mySearchResult = myDirectorySearcher.FindOne();

            if ( mySearchResult != null )
            {
                // 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);
                string mySearchResultPath = mySearchResult.Path;
                Console.WriteLine("The path for the 'mySearchResult'
 search "
                        + "result is : {0}\n", mySearchResultPath);

                // Get the properties of the
 'mySearchResult'.
                ResultPropertyCollection myResultPropColl;
                myResultPropColl = mySearchResult.Properties;
                Console.WriteLine("The properties of the "
 + 
                        "'mySearchResult' are :");

                foreach( string myKey in myResultPropColl.PropertyNames)
                {
                    string tab = "    ";
                    Console.WriteLine(myKey + " = ");
                    foreach( Object myCollection in
 myResultPropColl[myKey])
                    {
                        Console.WriteLine(tab + myCollection);
                    }
                }
                mySearchRoot.Dispose();
                myDirectoryEntry.Dispose();
            }
            else
            {
                Console.WriteLine("The '" + myLDAPPath + "'
 path not found.");
            }
        }
        catch(Exception e)
        {
            Console.WriteLine("The '" + myLDAPPath + "'
 path not found.");
            Console.WriteLine("Exception : " + e.Message);
        }
    }

}
#using <mscorlib.dll>
#using <System.dll>
#using <System.Directoryservices.dll>

using namespace System;
using namespace System::Collections;
using namespace System::DirectoryServices;
using namespace stdcli::language;

int main() 
{
    String^ myLDAPPath = "";
    try 
    {
        // Create a 'DirectoryEntry' object to search.
        Console::WriteLine("Enter the path ( Ex : 'LDAP://MyServer')");
        myLDAPPath = Console::ReadLine();
        DirectoryEntry^ mySearchRoot = gcnew DirectoryEntry(myLDAPPath);

        DirectorySearcher^ myDirectorySearcher = gcnew DirectorySearcher(mySearchRoot);

        // Get the first entry of the search.
        SearchResult^ mySearchResult = myDirectorySearcher->FindOne();
        if (mySearchResult) 
        {
            // 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);

            String^ mySearchResultPath = mySearchResult->Path;
            Console::WriteLine("The path for the 'mySearchResult'
 search result is :
                    {0}\n", mySearchResultPath);

            // Get the properties of the 'mySearchResult'.
            ResultPropertyCollection^ myResultPropColl = mySearchResult->Properties;
            Console::WriteLine("The properties of the 'mySearchResult'
 are :");
            IEnumerator^ myEnum = myResultPropColl->PropertyNames->GetEnumerator();
            while (myEnum->MoveNext()) 
            {
                String^ myKey = safe_cast<String^>(myEnum->Current);
                Console::WriteLine("{0} = ", myKey);
                IEnumerator^ myEnum = myResultPropColl->Item[myKey]->GetEnumerator();
                while (myEnum->MoveNext()) 
                {
                    Console::WriteLine("\t{0}", myEnum->Current);
                }
            }
            myDirectoryEntry->Dispose();
            mySearchRoot->Dispose(); 
        } 
        else 
        {
            Console::WriteLine("The '{0}' path not found.",
 myLDAPPath);
        }
    } 
    catch (Exception^ e) 
    {
        Console::WriteLine("The '{0}' path not found.",  myLDAPPath);
        Console::WriteLine("Exception : {0}", e->Message);
    }
}

.NET Framework のセキュリティ

• DirectoryServicesPermission  LinkDemand

継承階層

System.Object
  System.DirectoryServices.SearchResult

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.DirectoryServices 名前空間

SearchResult プロパティ

パブリック プロパティ

	名前	説明
	Path	SearchResult のパスを取得します。
	Properties	このオブジェクトのプロパティの ResultPropertyCollection コレクションを取得します。

参照

関連項目

SearchResult クラス
System.DirectoryServices 名前空間

SearchResult メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetDirectoryEntry	Active Directory 階層から SearchResult に対応する DirectoryEntry を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SearchResult クラス
System.DirectoryServices 名前空間

SearchResult メンバ

SearchResult クラスは、DirectorySearcher を使用した検索中に返される Active Directory 階層のノードをカプセル化します。

SearchResult データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	Path	SearchResult のパスを取得します。
	Properties	このオブジェクトのプロパティの ResultPropertyCollection コレクションを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetDirectoryEntry	Active Directory 階層から SearchResult に対応する DirectoryEntry を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SearchResult クラス
System.DirectoryServices 名前空間