Reset 方法 (RDS)

根据指定的排序和筛选属性对客户端 Recordset 执行排序或筛选操作。

语法

DataControl.Reset(value)

参数

DataControl   对象变量，代表 RDS.DataControl 对象。

value   可选，布尔型值，如果希望在当前的“已筛选”行集合上执行筛选操作，则它是值为 True （默认值）；False 表示在原始行集合上执行筛选操作，并删除所有以前的筛选操作选项。

说明

SortColumn、SortDirection、FilterValue、FilterCriterion 和 FilterColumn 属性提供客户端缓存上的排序和筛选功能。排序功能根据某列的值将记录排序。当全部 Recordset 保留在缓存中时，筛选功能根据查找标准显示记录子集。Reset 方法将执行查找标准并用可更新的 Recordset 替换当前 Recordset。

如果还存在没有提交的对原始数据所做的更改，那么 Reset 方法将失效。首先使用 SubmitChanges 方法将所有改动保存在读/写 Recordset 中，然后使用 Reset 方法排序或筛选记录。

如果希望对行集合执行多项筛选，可使用 Reset 方法中可选的 Boolean 参数。下例将说明这一过程：

ADC.SQL = "Select au_lname from authors"
ADC.Refresh      '获得新的行集合。

ADC.FilterColumn = "au_lname"
ADC.FilterCriterion = "<"
ADC.FilterValue = "'M'"
ADC.Reset         '记录集现在包含所有姓氏首字母小于“M”的记录。

ADC.FilterCriterion = ">"
ADC.FilterValue = "'F'"
'不必传送 True 值，因为它是对当前的
'“已筛选”记录集的默认筛选条件。
ADC.Reset(TRUE)      '记录集现在包含所有姓氏首字母
                     '小于“M”且大于“F”的记录。

ADC.FilterCriterion = ">"
ADC.FilterValue = "'T'"
'对原始记录集进行筛选，放弃以前的筛选选项。
ADC.Reset(FALSE)   '记录集现在包含所有姓氏首字母
                  '大于 "T" 的记录。