英語で読む

次の方法で共有


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 は、元の行セットでフィルター処理し、以前のフィルター オプションを削除することを示します。

注釈

SortColumnSortDirectionFilterValueFilterCriterionFilterColumn プロパティでは、クライアント側キャッシュで並べ替えとフィルター処理の機能を提供します。 並べ替え機能では、レコードを 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".  

適用対象

DataControl オブジェクト (RDS)

参照

FilterColumn、FilterCriterion、FilterValue、SortColumn、SortDirection の各プロパティと Reset メソッドの例 (VBScript)
SubmitChanges メソッド (RDS)