DoCmd.SetFilter 方法 (Access)

集进行 方法用于将筛选器应用于活动数据表、 窗体、 报表或表中的记录。

语法

表达式SetFilter (FilterNameWhereConditionControlName)

expression:表示 DoCmd 对象的变量。

参数

名称 必需/可选 数据类型 说明
FilterName 可选 Variant 如果提供该参数,则会将查询或筛选器的名称另存为查询。 此参数或 WhereCondition 参数是必需的。
WhereCondition 可选 Variant 如果提供该参数,则为可限制数据表、窗体、报表或表中记录的 SQL WHERE 子句。
ControlName 可选 Variant 如果提供该参数,则为与要筛选的子窗体或子报表相对应的控件的名称。 如果为空,则筛选当前对象。

备注

运行此方法时,将对处于活动状态且具有焦点的表、窗体、报表或数据表(如查询结果)应用筛选器。

活动对象的 Filter 属性用于保存 WhereCondition 参数,并在以后应用它。 筛选器与在其中创建筛选器的对象一起保存。 在打开对象时会自动加载筛选器,但不会自动应用筛选器。

若要在打开对象时自动应用筛选器,请将 FilterOnLoad 属性设置为 True

示例

下面的代码示例筛选活动对象,以便仅显示以“NWTB”开头的记录。

DoCmd.SetFilter WhereCondition:="[Product Code] Like ""NWTB*"""

支持和反馈

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