FireDAC.Comp.DataSet.TFDDataSet.SetRange

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

procedure SetRange(const AStartValues, AEndValues: array of const;
AStartExclusive: Boolean = False; AEndExclusive: Boolean = False);

C++

void __fastcall SetRange(const System::TVarRec *AStartValues, const int AStartValues_High, const System::TVarRec *AEndValues, const int AEndValues_High, bool AStartExclusive = false, bool AEndExclusive = false);

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

説明

範囲の開始値と終了値を設定し、適用します。


SetRange を使用すると、データセットの範囲の開始値と終了値を指定して、範囲を適用することができます。

AStartValues では、インデックス付きフィールド値の範囲の開始を設定します。AEndValues では、インデックス付きフィールド値の範囲の終了を設定します。SetRange は以下の処理を行います。

  1. データセットの状態を dsSetKey にします。
  2. これまでに指定されている範囲の開始値と終了値があれば消去します。
  3. 範囲の開始値と終了値を設定します。
  4. データセットに範囲を適用します。

現在のデータセット レコードが新しい範囲に含まれていれば、SetRange を呼び出した後にはそのレコードが現在のレコードになります。そうでなければ、現在の位置は範囲内の最初のレコードに設定されます。

AStartValues または AEndValues に含まれる要素の数が現在のインデックスのフィールド数よりも小さい場合、残りのエントリは NULL に設定されます。

FDQuery1.IndexFieldNames := 'CUST_NO';
FDQuery1.SetRange([100], [200]);

関連項目