DirectorySearcher クラス

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

DirectorySearcher クラス

Active Directory に対してクエリを実行します。

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

Visual Basic (宣言)

Public Class DirectorySearcher
    Inherits Component

Visual Basic (使用法)

Dim instance As DirectorySearcher

C#

public class DirectorySearcher : Component

C++

public ref class DirectorySearcher : public
 Component

J#

public class DirectorySearcher extends Component

JScript

public class DirectorySearcher extends
 Component

解説

LDAP (Lightweight Directory Access Protocol) で Active Directory 階層を検索し、クエリを実行するには、DirectorySearcher オブジェクトを使用します。LDAP は、ディレクトリの検索をサポートしている唯一のシステム指定の ADSI (Active Directory Service Interfaces) プロバイダです。管理者は、階層に見つかったオブジェクトを作成、変更、および削除できます。詳細については、「System.DirectoryServices の使用」を参照してください。

DirectorySearcher のインスタンスを作成する場合は、取得するルートと、取得するプロパティの省略できるリストを指定します。SearchRoot プロパティにより、追加のプロパティを設定して次のタスクを実行できます。

• ローカル コンピュータに検索結果をキャッシュします。ローカル コンピュータにディレクトリ情報を格納するには、CacheResults プロパティを true に設定します。DirectoryEntry.CommitChanges メソッドを呼び出した場合にだけ、このローカル キャッシュは更新され、Active Directory にコミットされます。

• ServerTimeLimit プロパティを使用して、検索時間の長さを指定します。

• 属性名だけを取得します。値が割り当てられている属性の名前だけを取得するには、PropertyNamesOnly プロパティを true に設定します。

• ページ検索を実行します。ページ検索で返される最大のオブジェクト数を指定するには、PageSize プロパティを設定します。ページ検索を実行しない場合は、PageSize プロパティを既定のゼロに設定します。

• SizeLimit プロパティを使用して、返されるエントリの最大数を指定します。SizeLimit プロパティを既定のゼロに設定した場合、サーバーが決定する既定値は 1000 エントリです。

メモ
返されるエントリの最大数と時間制限が、サーバーで設定された制限を越える場合は、サーバーの設定がコンポーネントの設定をオーバーライドします。

DirectorySearcher クラスのインスタンスの初期プロパティ値の一覧については、DirectorySearcher コンストラクタのトピックを参照してください。

メモ
このクラスを使用するには、Active Directory の一般的な知識が必要です。詳細については、System.DirectoryServices の概要を参照してください。

.NET Framework のセキュリティ

• DirectoryServicesPermission  LinkDemand

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.DirectoryServices.DirectorySearcher

スレッド セーフ

この型の 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

参照

関連項目
DirectorySearcher メンバ
System.DirectoryServices 名前空間
DirectoryEntries クラス
DirectoryEntry クラス
DirectorySearcher
DirectorySearcher クラス
DirectorySearcher クラス
PropertyCollection
PropertyValueCollection
ReferralChasingOption
SearchResultCollection
SearchResult
ResultPropertyValueCollection
ResultPropertyValueCollection
SearchScope
SortDirection
SortOption
System.DirectoryServices