Form.Filter 属性 (Access)

使用 Filter 属性可以指定在将筛选器应用于窗体、报表、查询或表时要显示的记录子集。 读/写 String。

语法

表达式.Filter

expression：表示 Form 对象的变量。

备注

如果您想要指定 Microsoft Access 项目 (.adp) 中的服务器筛选数据的服务器上，使用 服务器过滤器 属性。

Filter 属性是一个字符串表达式，由不带 WHERE 关键字的 WHERE 子句组成。 例如，以下 Visual Basic 代码定义并应用筛选器，以便仅显示来自美国的客户。

Me.Filter = "Country = 'USA'" 
Me.FilterOn = True

注意

设置 Filter 属性对 ADO Filter 属性没有影响。

使用 Filter 属性保存筛选器并在以后应用它。 筛选器将与创建它们的对象一起保存。 当打开该对象时，它们将自动加载，但不会自动应用。

创建新对象时，它将继承创建它的表或查询的 RecordSource、 Filter、 OrderBy 和 OrderByOn 属性。

若要将保存的筛选器应用于窗体、查询或表，可以在工具栏上选择“应用筛选器”，在“记录”菜单上选择“应用筛选器/排序”，或使用宏或 Visual Basic 将 FilterOn 属性设置为 True。 对于报表，可以在报表的属性表中通过将 FilterOn 属性设置为 YES 来应用筛选器。

“应用筛选”按钮指示 Filter 和 FilterOn 属性的状态。 应用筛选之前，该按钮始终处于禁用状态。 如果当前已应用了一个现有筛选器，应用筛选按钮将显示为按下状态。

当窗体打开时自动应用筛选器，指定的窗体，或者可以使用 ApplyFilter 操作的宏或事件过程，可以使用 ApplyFilterDoCmd 对象的方法的 OnOpen 事件属性设置中。

可以通过选择按下的“应用筛选器”按钮、选择“记录”菜单上的“删除筛选器/排序”或使用 Visual Basic 将 FilterOn 属性设置为 False 来删除筛选器。

如果窗体设计视图中设置有 Filter 属性，则 Microsoft Access 不会尝试验证 SQL 表达式。 如果 SQL 表达式无效，则会在应用筛选器时发生错误。

支持和反馈

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