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

属性值

以 LDAP 格式表示的搜索筛选器,如“(objectClass=user)”。 默认值为“(objectClass=*)”,它检索所有对象。

属性

注解

筛选器使用以下准则:

  1. 字符串必须括在括号中。

  2. 表达式可以使用关系运算符: <、 <=、=、=、 >=和 >。 例如“ (objectClass=user) ”。 另一个示例是“ (lastName>=Davis) ”。

  3. 复合表达式由前缀运算符 & 和 |构成。 例如“ (& (objectClass=user) (lastName= Davis) ) ”。 另一个示例是“ (& (objectClass=printer) (| (building=42) (building=43) ) ) ”。

当筛选器包含ADS_UTC_TIME类型的属性时,其值必须为 yyyymmddhmmsSZ 格式,其中 y、m、d、h、m 和 s 分别表示年、月、日、小时、分钟和秒。 秒 (ss) 值是可选的。 最后一个字母 Z 表示没有时间差。 在此格式中,“1999 年 5 月 13 日上午 10:20:00”变为“19990513102000Z”。 请注意,Active Directory 域服务将日期和时间存储为协调世界时 (格林威治平均时间) 。 如果指定没有时差的时间,则以 GMT 时间为单位指定时间。

如果不在协调世界时区中,则可以向协调世界时 (添加差异值,而不是指定 Z) 根据时区指定时间。 差异基于以下内容:差异 = 协调世界时 - 本地。 若要指定差异,请使用以下格式:yyyymmddhmmss[+/-]hhmm。 例如,“1999 年 3 月 23 日晚上 8:52:58”新西兰标准时间 (差异为 12 小时,) 指定为“19990323205258.0+1200”。

有关 LDAP 搜索字符串格式的详细信息,请参阅搜索筛选器语法

适用于