全部显示

在 Visual Basic 中，ApplyFilter 方法执行 ApplyFilter 操作。

expression.ApplyFilter(FilterName, WhereCondition)

expression     必需。返回“应用于”列表中的一个对象的表达式。

FilterName     可选 Variant 型。字符串表达式，表示当前数据库中筛选或查询的有效名称。使用该方法应用服务器筛选时，FilterName 参数必须为空。

WhereCondition     可选 Variant 型。字符串表达式，表示不包括单词 WHERE 的有效 SQL WHERE 子句。

说明

有关该操作及其参数如何使用的详细信息，请参阅该操作主题。

应用的筛选和 WHERE 条件成为窗体的 Filter 属性设置或报表的 ServerFilter 属性设置。

必须至少包含 ApplyFilter 方法的两个参数之一。如果同时对两个参数输入值，WhereCondition 参数将应用于筛选。

WhereCondition 参数的最大长度为 32,768 个字符（而在“宏”窗口中，Where Condition 操作参数的最大长度为 256 个字符）。

如果指定 WhereCondition 参数但保留 FilterName 参数为空，则必须包含 FilterName 参数的逗号。

示例

下面的示例使用 ApplyFilter 方法仅显示“姓氏”字段中包含 King 的记录。

DoCmd.ApplyFilter , "LastName = 'King'"