Reset 方法 (RDS)

   

根據(jù)指定的排序和篩選屬性對客戶端 Recordset 執(zhí)行排序或篩選操作。

語法

DataControl.Reset(value)

參數(shù)

DataControl   對象變量，代表 RDS.DataControl 對象。

value   可選，布爾型值，如果希望在當(dāng)前的“已篩選”行集合上執(zhí)行篩選操作，則它是值為 True （默認(rèn)值）；False 表示在原始行集合上執(zhí)行篩選操作，并刪除所有以前的篩選操作選項(xiàng)。

說明

SortColumn、SortDirection、FilterValue、FilterCriterion 和 FilterColumn 屬性提供客戶端緩存上的排序和篩選功能。排序功能根據(jù)某列的值將記錄排序。當(dāng)全部 Recordset 保留在緩存中時(shí)，篩選功能根據(jù)查找標(biāo)準(zhǔn)顯示記錄子集。Reset 方法將執(zhí)行查找標(biāo)準(zhǔn)并用可更新的 Recordset 替換當(dāng)前 Recordset。

如果還存在沒有提交的對原始數(shù)據(jù)所做的更改，那么 Reset 方法將失效。首先使用 SubmitChanges 方法將所有改動(dòng)保存在讀/寫 Recordset 中，然后使用 Reset 方法排序或篩選記錄。

如果希望對行集合執(zhí)行多項(xiàng)篩選，可使用 Reset 方法中可選的 Boolean 參數(shù)。下例將說明這一過程：

ADC.SQL = "Select au_lname from authors"

ADC.Refresh      '獲得新的行集合。

ADC.FilterColumn = "au_lname"

ADC.FilterCriterion = "<"

ADC.FilterValue = "'M'"

ADC.Reset         '記錄集現(xiàn)在包含所有姓氏首字母小于“M”的記錄。

ADC.FilterCriterion = ">"

ADC.FilterValue = "'F'"

'不必傳送 True 值，因?yàn)樗菍Ξ?dāng)前的

'“已篩選”記錄集的默認(rèn)篩選條件。

ADC.Reset(TRUE)      '記錄集現(xiàn)在包含所有姓氏首字母

                     '小于“M”且大于“F”的記錄。

ADC.FilterCriterion = ">"

ADC.FilterValue = "'T'"

'對原始記錄集進(jìn)行篩選，放棄以前的篩選選項(xiàng)。

ADC.Reset(FALSE)   '記錄集現(xiàn)在包含所有姓氏首字母

                  '大于 "T" 的記錄。