DirectorySearcher.Filter プロパティ

定義

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

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };
public string Filter { get; set; }
public string? Filter { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSFilter")]
public string Filter { get; set; }
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
member this.Filter : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.DirectoryServices.DSDescription("DSFilter")>]
member this.Filter : string with get, set
[<System.DirectoryServices.DSDescription("DSFilter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set
[<System.DirectoryServices.DSDescription("DSFilter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set
Public Property Filter As String

プロパティ値

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

属性

注釈

フィルターでは、次のガイドラインが使用されます。

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

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

  3. 複合式は、プレフィックス演算子 & と |で形成されます。 たとえば、"(&(objectClass=user)(lastName= Davis))" です。 もう 1 つの例は、"(&(objectClass=printer)(|(building=42)(building=43)))"

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

協定世界時タイム ゾーンにない場合は、(Z を指定する代わりに) 協定世界時に差分値を追加して、タイム ゾーンに従って時刻を指定できます。 差分は、differential = Coordinated Universal Time- Local に基づいています。 差分を指定するには、yyyymmddhhmmss[+/-]hhmm の形式を使用します。 たとえば、"1999 年 3 月 23 日午後 8 時 52 分 58 分" ニュージーランド標準時 (差分は 12 時間) は"19990323205258.0+1200" と指定されます。

LDAP 検索文字列形式の詳細については、「 検索フィルター構文」を参照してください。

適用対象