重置方法 (RDS)

根据指定的排序和筛选器属性,在客户端 Recordset 执行排序或筛选。

重要

从 Windows 8 和 Windows Server 2012 开始,RDS 服务器组件不再包含在 Windows 操作系统中(有关详细信息,请参阅 Windows 8 和 Windows Server 2012 兼容性指南)。 RDS 客户端组件将在将来的 Windows 版本中删除。 避免在新开发工作中使用此功能,并计划修改当前使用此功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务。

语法

  
DataControl.Reset(value)  

参数

DataControl
一个表示 RDS 的对象变量。DataControl 对象。

值
自选。 如果要筛选当前“筛选”行集,则 布尔 值,该值 True(默认值)。 False 指示筛选原始行集,删除任何以前的筛选器选项。

言论

SortColumn、SortDirection、FilterValue、FilterCriterion,FilterColumn 属性在客户端缓存上提供排序和筛选功能。 排序功能按一列的值对记录进行排序。 筛选功能根据查找条件显示记录的子集,而缓存中维护完整的 记录集。 Reset 方法将执行条件,并将当前 Recordset 替换为可更新的 Recordset。

如果对尚未提交的原始数据进行更改,重置 方法将失败。 首先,使用 SubmitChanges 方法保存 Recordset的读/写更改,然后使用 Reset 方法对记录进行排序或筛选。

如果要对行集执行多个筛选器,可以将可选的 布尔 参数与 Reset 方法一起使用。 以下示例演示如何执行此操作:

ADC.SQL = "Select au_lname from authors"  
ADC.Refresh    ' Get the new rowset.  
  
ADC.FilterColumn = "au_lname"  
ADC.FilterCriterion = "<"  
ADC.FilterValue = "'M'"  
ADC.Reset         ' Rowset now has all Last Names < "M".  
  
ADC.FilterCriterion = ">"  
ADC.FilterValue = "'F'"  
' Passing True is not necessary, because it is the   
' default filter on the current "filtered" rowset.  
ADC.Reset(TRUE)     ' Rowset now has all Last   
                    ' Names < "M" and > "F".  
  
ADC.FilterCriterion = ">"  
ADC.FilterValue = "'T'"  
' Filter on the original rowset, throwing out the  
' previous filter options.  
ADC.Reset(FALSE)   ' Rowset now has all Last Names > "T".  

适用于

DataControl 对象 (RDS)

另请参阅

FilterColumn、FilterCriterion、FilterValue、SortColumn 和 SortDirection 属性和 Reset 方法示例 (VBScript)
SubmitChanges 方法 (RDS)