FireDAC.Comp.DataSet.TFDDataSet.SetRange
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 は以下の処理を行います。
- データセットの状態を
dsSetKey
にします。 - これまでに指定されている範囲の開始値と終了値があれば消去します。
- 範囲の開始値と終了値を設定します。
- データセットに範囲を適用します。
現在のデータセット レコードが新しい範囲に含まれていれば、SetRange を呼び出した後にはそのレコードが現在のレコードになります。そうでなければ、現在の位置は範囲内の最初のレコードに設定されます。
AStartValues
または AEndValues
に含まれる要素の数が現在のインデックスのフィールド数よりも小さい場合、残りのエントリは NULL に設定されます。
例
FDQuery1.IndexFieldNames := 'CUST_NO';
FDQuery1.SetRange([100], [200]);