通过

筛选项目

  • 项目

本主题描述指定 Outlook 各对象支持的筛选器中的属性时适用的通用规则。 有关指定属性的条件以完成筛选器的详细信息，请参阅 筛选器语法 部分中的主题。

筛选器是一个条件或一组条件，可应用于一组项，以获取满足指定条件的一部分项。 Outlook 支持使用 Microsoft Jet 查询语言语法或 DAV 搜索和定位 (DASL) 语法的筛选器。 请注意，Jet 查询语言语法与 Microsoft Jet Expression Service 支持的语法相同，因此名为 Jet 查询语言。

例如，可以筛选“联系人”文件夹中的联系人项目，以获取居住在加拿大的联系人的列表。 在这种情况下，你将对 HomeAddressCountry 属性进行筛选。 以 Jet 筛选器表示的筛选器将为 "[HomeAddressCountry] = 'Canada'"。

Outlook 可通过下列入口点提供筛选：

入口点 Jet 筛选器支持 DASL 筛选器支持
Application.AdvancedSearch 否 是
Folder.GetTable 是 是
Items.Find 是 是。 请注意，如果在筛选器中使用 查询关键字ci_phrasematch 或 ci_startswith ，将收到错误。
Items.Restrict 是 是
Search.GetTable 否 是
Table.FindRow 是 是。 请注意，如果在筛选器中使用 查询关键字ci_phrasematch 或 ci_startswith ，将收到错误。
Table.Restrict 是 是
View.Filter 否 是

注意

[!注释] 筛选器必须包含使用 Jet 或 DASL 语法的查询，但不得包含混合使用这两种语法的查询。

属性说明符

使用上述任一入口点在 Jet 筛选器或 DASL 筛选器中指定属性时，请遵循以下准则。

Jet 筛选器 DASL 筛选器
适用的属性 大多数的显式内置属性和自定义项目级属性；有关不受支持的属性，请参阅相应方法的主题。 大多数带有和不带有显式字符串名称的内置属性和自定义项目级属性；有关不受支持的属性，请参阅相应方法的主题。
引用属性

  • 通过显式字符串名称引用。

  • 显式内置属性只可通过其英语名称引用，而不能使用任何其他本地化语言。

  • 自定义属性可以按英语或本地化语言的名称引用。

 通过命名空间引用。
引用格式

  • 用方括号（“[”“]”）括起显式字符串名称。

  • 属性名称不区分大小写。

  • 显式内置属性不允许使用空格。

  • 自定义属性允许使用空格。

  • 所有 DASL 查询均以区分大小写的前缀“@SQL=”开头（Application.AdvancedSearch 的 DASL 查询除外）。

  • 通过命名空间引用的属性两端必须加上双引号。

  • 命名空间引用的属性区分大小写。

  • 如果自定义属性的名称中存在空格，必须用“%20”替换空格。 通常，URL 编码会按照与 URL 相同的方式应用到 DASL 查询中的字符。
错误条件 如果未定义筛选器中的自定义属性，或者筛选器为空、包含无效的参数或无法分析，则返回错误。 如果未定义筛选器中的自定义属性，或者筛选器为空、包含无效的参数或无法分析，则返回错误。

筛选器语法

筛选器的语法取决于要筛选的属性类型。 以下主题提供了有关如何基于特定属性类型构造筛选器的详细信息：

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。