DirectorySearcher.Filter プロパティ

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

DirectorySearcher.Filter プロパティ

LDAP 書式のフィルタ文字列を示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Filter As
 String

Visual Basic (使用法)

Dim instance As DirectorySearcher
Dim value As String

value = instance.Filter

instance.Filter = value

C#

public string Filter { get;
 set; }

C++

public:
property String^ Filter {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Filter ()

/** @property */
public void set_Filter (String value)

JScript

public function get Filter
 () : String

public function set Filter
 (value : String)

プロパティ値
"(objectClass=user)" などの LDAP 書式の検索フィルタ文字列。既定は "(objectClass=*)" で、すべてのオブジェクトを取得します。

解説

フィルタは次のガイドラインを使用します。

1. 文字列はかっこで囲む必要があります。

2. 式には関係演算子、<、<=、=、>=、および > を使用できます。たとえば、"(objectClass=user)" のようにします。または、"(lastName>=Davis)" とします。

3. 複合式は、前置演算子の & と | で記述します。たとえば、"(&(objectClass=user)(lastName= Davis))" のようにします。または、"(&(objectClass=printer)(|(building=42)(building=43)))" のようにします。

フィルタに ADS_UTC_TIME 型の属性が含まれる場合、その値は yymmddhhmmssZ の書式にする必要があります。y、m、d、h、m、および s は、それぞれ年、月、日、時間、分、および秒を表します。秒 (ss) の値は省略できます。最後の文字 Z は、時差がないことを意味します。この書式では、"1999 年 5 月 13 日 10:20:00 A.M." は "990513102000Z" になります。Active Directory は、世界協定時刻 (グリニッジ標準時と同じ) で日付と時刻を格納することに注意してください。時差なしで時刻を指定した場合は、GMT 時間で時刻を指定したことになります。

世界協定時刻のタイム ゾーン外の場合は、(Z を指定する代わりに) 世界協定時刻に対する時差の値を追加して、現地のタイム ゾーンに従って時刻を指定できます。時差は、時差 = 世界協定時刻 - 現地時刻として計算します。時差を指定するには、書式 yymmddhhmmss [+/-] hhmm を使用します。たとえば、ニュージーランド標準時刻 (時差は 12 時間) での "1999 年 3 月 23 日 8:52:58 P.M." は、"19990323205258.0+1200" のように指定します。

LDAP 検索文字列の形式の詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library) の「Search Filter Syntax」を参照してください。

プラットフォーム

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 名前空間