Report.ServerFilter 属性 (Access)

使用 ServerFilter 属性指定在将服务器筛选器应用于 Microsoft Access 项目 (.adp) 或数据库中的报表时要显示的记录子集。读/写 String。

语法

表达式。ServerFilter

表达一个代表 Report 对象的变量。

服务器过滤器 属性是字符串表达式，包含 WHERE 子句没有 WHERE 关键字。例如，以下 Visual Basic 代码定义并应用筛选器，以便仅显示来自美国的客户。

Me.ServerFilter = "Country = 'USA'" 
Me.Refresh

若要设置了 ServerFilter 属性，您必须首先:

在窗体的属性表中设置该属性值。
通过键入以下代码在 Visual Basic 中设置属性：
```
  Forms(0).ServerFilter = "fieldname = value "
```

注意

[!注释] 设置了 ServerFilter 属性不起作用的 ADO 筛选器 属性上。

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

若要将保存的筛选器应用于窗体，可以在工具栏上选择“应用服务器筛选器”，在“记录”菜单上选择“应用筛选器/排序”，或使用宏或 Visual Basic 将 ServerFilterByForm 属性设置为 True。

应用服务器筛选 按钮表示中止和筛选属性的状态。要应用筛选器之前该按钮一直保持禁用状态。如果当前应用了一个现有的筛选，则 应用服务器筛选 按钮被按下。

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

只能通过使用 Visual Basic 将 ServerFilterByForm 属性设置为 False 或清除“服务器筛选依据窗体”窗口中的所有筛选条件来删除服务器筛选器，然后选择“ 应用服务器筛选器”。

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

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