通过

Reset 方法 (RDS)

  • 项目

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

重要

从 Windows 8 和 Windows Server 2012 开始，Windows 操作系统不再包含 RDS 服务器组件（有关更多详细信息，请参阅 Windows 8 和 Windows Server 2012 兼容性实用手册）。 Windows 的未来版本中将移除 RDS 客户端组件。 请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务。

语法

  
DataControl.Reset(value)

参数

DataControl
表示 RDS.DataControl 对象的对象变量。

value
可选。 如果要在当前“已筛选”行集上进行筛选，则为 True（默认）的布尔值。 False 表示对原始行集进行筛选，删除任何以前的筛选器选项。

备注

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

如果对尚未提交的原始数据进行更改，Reset 方法将失败。 首先，使用 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)