Reset メソッド (RDS)
クライアント側の 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 オブジェクトを表すオブジェクト変数。
value
省略可能。 現在の "フィルター処理された" 行セットでフィルター処理する場合、True (既定値) になるブール値です。 False は、元の行セットでフィルター処理し、以前のフィルター オプションを削除することを示します。
注釈
SortColumn、SortDirection、FilterValue、FilterCriterion、FilterColumn プロパティでは、クライアント側キャッシュで並べ替えとフィルター処理の機能を提供します。 並べ替え機能では、レコードを 1 つの列の値順に並べ替えます。 フィルター処理機能を使用すると、検索条件に基づいてレコードのサブセットが表示されますが、完全な Recordset はキャッシュに保持されます。 Reset メソッドは、条件を実行し、現在の Recordset を更新可能な Recordset に置き換えます。
送信されていない元のデータに変更がある場合、Reset メソッドは失敗します。 まず、SubmitChanges メソッドを使用して、読み取り/書き込みの Recordset に変更を保存してから、Reset メソッドを使用してレコードを並べ替えるかフィルター処理します。
行セットに対して複数のフィルターを実行する場合は、Reset メソッドでオプションの Boolean 引数を使用できます。 以下の例は、その方法を示しています。
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".
適用対象
参照
FilterColumn、FilterCriterion、FilterValue、SortColumn、SortDirection の各プロパティと Reset メソッドの例 (VBScript)
SubmitChanges メソッド (RDS)