共用方式為

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 (預設) 的 Boolean 值。 False 表示您是在原始資料列集上進行篩選，並且會移除任何先前的篩選選項。

備註

SortColumn、SortDirection、FilterValue、FilterCriterion 和 FilterColumn 屬性可在用戶端快取提供排序和篩選功能。 排序功能會依一個資料行的值來排序記錄。 篩選功能會根據尋找準則顯示一部分記錄，而完整 Recordset 會保留在快取中。 Reset 方法會執行準則，並以可更新的 Recordset 取代目前的 Recordset。

如果尚未提交的原始資料有所變更，Reset 方法將會失敗。 首先，使用 SubmitChanges 方法來儲存讀取/寫入 Recordset 中的任何變更，然後使用 Reset 方法來排序或篩選記錄。

如果您想要在資料列集上執行多個篩選，則可以搭配使用選擇性的 Boolean 引數與 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)