Reset 方法 (RDS)

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

重要

從Windows 8和Windows Server 2012開始,Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和Windows Server 2012 Compatibility Cookbook以取得詳細資料) 。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 使用 RDS 的應用程式應該移轉至 WCF 資料服務

語法

  
DataControl.Reset(value)  

參數

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

value
選擇性。 如果您想要篩選目前「篩選」資料列集,則為True (預設) 。 False 表示您在原始資料列集上篩選,並移除任何先前的篩選準則選項。

備註

SortColumnSortDirectionFilterValueFilterCriterionFilterColumn屬性會在用戶端快取上提供排序和篩選功能。 排序功能會依單一資料行的值排序記錄。 篩選功能會根據尋找準則顯示記錄的子集,而完整 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)