(Access) 的 Report.ServerFilter 屬性

使用 ServerFilter 屬性可指定將伺服器篩選套用至 Microsoft Access 專案 (.adp) 或資料庫內的報表時要顯示的記錄子集。讀取/寫入的 String。

語法

運算式。ServerFilter

表達代表 Report 物件的變數。

ServerFilter 屬性是由沒有 WHERE 關鍵字的 WHERE 子句組成的字串運算式。例如，下列 Visual Basic 程式碼會定義並套用篩選，只顯示美國的客戶。

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

若要設定 ServerFilter 屬性，您必須先執行下列其中一個：

在表單的屬性表中設定屬性值。
輸入下列程式碼，在 Visual Basic 中設定屬性：
```
  Forms(0).ServerFilter = "fieldname = value "
```

注意事項

[!注意事項] 設定 ServerFilter 屬性並不會影響 ADO Filter 屬性。

使用 ServerFilter 屬性來儲存篩選，並在稍後套用它。篩選會儲存在建立的物件。當物件開啟時，就會自動載入篩選，但卻不會自動套用篩選。

若要將儲存的篩選套用至表單，您可以選擇工具列上的 [套用伺服器篩選]、選擇 [記錄] 功能表上的 [套用篩選/排序]，或使用宏或 Visual Basic 將ServerFilterByForm屬性設定為True。

套用伺服器篩選 ] 按鈕會指出 ServerFilter 和 ServerFilterByForm 屬性的狀態。直到套用篩選] 按鈕會維持停用。如果目前套用現有的篩選條件 套用伺服器篩選 ] 按鈕會出現在按下。

若要開啟表單時自動套用篩選器，請指定 OnOpen 事件屬性設定是使用 ApplyFilter 巨集指令的巨集或事件程序使用 DoCmd 物件的 ApplyFilter 方法的表單中。不論執行哪項表單都會在 [依表單伺服器篩選] 視窗中開啟。

您只能使用 Visual Basic 將 ServerFilterByForm 屬性設定為 False ，或清除 [依表單篩選] 視窗中的所有篩選準則，然後選擇 [ 套用伺服器篩選] 來移除伺服器篩選。

在表單設計檢視中設定 ServerFilter 屬性時，Access 不會嘗試驗證 SQL 運算式。如果 SQL 運算式無效，則在套用篩選時會發生錯誤。

有關於 Office VBA 或這份文件的問題或意見反應嗎？如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。