Reset メソッド (RDS)

[アーティクル]
01/19/2017

指定した並べ替えプロパティとフィルタープロパティに基づいて、クライアント側 Recordset で並べ替えまたはフィルターを実行します。

大事な

Windows 8 および Windows Server 2012 以降では、RDS サーバーコンポーネントは Windows オペレーティングシステムに含まれません (詳細については、Windows 8 と Windows Server 2012 の互換性クックブックを参照してください)。 RDS クライアントコンポーネントは、将来のバージョンの Windows で削除される予定です。新しい開発作業ではこの機能を使用しないでください。現在この機能を使用しているアプリケーションを変更することを計画してください。 RDS を使用するアプリケーションは、WCF Data Serviceに移行する必要があります。

構文

  
DataControl.Reset(value)

パラメーター

DataControl の
RDS を表すオブジェクト変数。DataControl オブジェクト。

値の
随意。現在の "フィルター処理された" 行セットでフィルター処理する場合 True (既定値) である ブール 値。 False は、以前のフィルターオプションを削除して、元の行セットでフィルター処理することを示します。

備考

SortColumn、SortDirection、FilterValue、FilterCriterion、および FilterColumn プロパティは、クライアント側キャッシュでの並べ替えとフィルター処理の機能を提供します。並べ替え機能は、1 つの列の値でレコードを並べ替えます。フィルター処理機能では、検索条件に基づいてレコードのサブセットが表示されますが、レコードセットの完全なはキャッシュに保持されます。 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)

次の方法で共有

Reset メソッド (RDS)

構文

パラメーター

備考

適用対象

関連項目

その他のリソース