Reset 方法 （RDS）

根據指定的排序和篩選屬性，在用戶端 Recordset 上執行排序或篩選。

重要

從 Windows 8 和 Windows Server 2012 開始，RDS 伺服器元件已不再包含在 Windows 作業系統中（如需詳細資訊，請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook）。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能，並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。

語法

  
DataControl.Reset(value)  

參數

DataControl
代表 RDS 的物件變數。DataControl 物件。

值
自選。 如果您想要篩選目前「已篩選」數據列集， 布爾值 True （預設值）。 False 表示您篩選原始數據列集，並移除任何先前的篩選選項。

言論

SortColumn、SortDirection、FilterValue、FilterCriterion和 FilterColumn 属性，可在用戶端快取上提供排序和篩選功能。 排序功能會依一個數據行的值來排序記錄。 篩選功能會根據尋找準則顯示記錄的子集，而快取中會維護完整的 Recordset。 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）