在 Visual Basic 中,ApplyFilter 方法執(zhí)行 ApplyFilter 操作。
expression.ApplyFilter(FilterName, WhereCondition)
expression 必需。返回“應(yīng)用于”列表中的一個(gè)對(duì)象的表達(dá)式。
FilterName 可選 Variant 型。字符串表達(dá)式,表示當(dāng)前數(shù)據(jù)庫(kù)中篩選或查詢的有效名稱。使用該方法應(yīng)用服務(wù)器篩選時(shí),FilterName 參數(shù)必須為空。
WhereCondition 可選 Variant 型。字符串表達(dá)式,表示不包括單詞 WHERE 的有效 SQL WHERE 子句。
有關(guān)該操作及其參數(shù)如何使用的詳細(xì)信息,請(qǐng)參閱該操作主題。
應(yīng)用的篩選和 WHERE 條件成為窗體的 Filter 屬性設(shè)置或報(bào)表的 ServerFilter 屬性設(shè)置。
必須至少包含 ApplyFilter 方法的兩個(gè)參數(shù)之一。如果同時(shí)對(duì)兩個(gè)參數(shù)輸入值,WhereCondition 參數(shù)將應(yīng)用于篩選。
WhereCondition 參數(shù)的最大長(zhǎng)度為 32,768 個(gè)字符(而在“宏”窗口中,Where Condition 操作參數(shù)的最大長(zhǎng)度為 256 個(gè)字符)。
如果指定 WhereCondition 參數(shù)但保留 FilterName 參數(shù)為空,則必須包含 FilterName 參數(shù)的逗號(hào)。
下面的示例使用 ApplyFilter 方法僅顯示“姓氏”字段中包含 King 的記錄。
DoCmd.ApplyFilter , "LastName = 'King'"