次の方法で共有


DirectorySearcher クラス

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

この型のすべてのメンバの一覧については、DirectorySearcher メンバ を参照してください。

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

Public Class DirectorySearcher
   Inherits Component
[C#]
public class DirectorySearcher : Component
[C++]
public __gc class DirectorySearcher : public Component
[JScript]
public class DirectorySearcher extends Component

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

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

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

  • ローカル コンピュータに検索結果をキャッシュするかどうか。ローカル コンピュータにディレクトリ情報を格納するには、 CacheResults プロパティを true に設定します。 DirectoryEntry.CommitChanges メソッドを呼び出した場合にだけ、このローカル キャッシュは更新され、Active Directory にコミットされます。
  • 検索を実行する時間。検索時間を指定するには、 ServerTimeLimit プロパティを使用します。
  • 属性名だけを取得するかどうか。値が割り当てられている属性の名前だけを取得するには、 PropertyNamesOnly プロパティを true に設定します。
  • ページ検索を実行するかどうか。ページ検索で返される最大のオブジェクト数を指定するには、 PageSize プロパティを設定します。ページ検索を実行しない場合は、 PageSize プロパティを既定のゼロに設定します。
  • 返される最大のエントリ数。返される最大のエントリ数を指定するには、 SizeLimit プロパティを設定します。 SizeLimit プロパティを既定のゼロに設定すると、サーバーが決定する既定の 1000 エントリに設定されます。

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

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

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

必要条件

名前空間: System.DirectoryServices

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Directoryservices (System.Directoryservices.dll 内)

参照

DirectorySearcher メンバ | System.DirectoryServices 名前空間 | DirectoryEntry | DirectoryEntries | PropertyCollection | PropertyValueCollection | ReferralChasingOption | SearchResultCollection | SearchResult | ResultPropertyCollection | ResultPropertyValueCollection | SearchScope | SortDirection | SortOption