FireDAC.Stan.Option.TFDFetchOptions.RecsSkip
Delphi
property RecsSkip: Integer read GetRecsSkip write SetRecsSkip
C++
__property int RecsSkip = {read=GetRecsSkip, write=SetRecsSkip, stored=IsESS, default=-1};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
property | published | FireDAC.Stan.Option.pas FireDAC.Stan.Option.hpp |
FireDAC.Stan.Option | TFDFetchOptions |
説明
取得対象の最初のレコードのオフセットを制御します。
RecsSkip を使用して、1 つの結果セットの先頭から何件のレコードをスキップするかを指定することができます。既に準備の済んだデータセットの RecsSkip を変更するには、アプリケーションで Disconnect メソッドを先に呼び出す必要があります。
FireDAC は、最初の RecsSkip 件のレコードを破棄し、RecsSkip+1 番目以降のレコードを返します。0 以下の値はスキップしないことを意味します。RecsSkip プロパティと RecsMax プロパティを組み合わせると、結果セットのページングを実装することができます。これは Web アプリケーションで有益です。また、アプリケーションで LIMIT エスケープ関数を使用することもできます。両方が指定された場合に優先度が高いのは LIMIT です。
DBMS によっては、RecsMax および RecsSkip が、サーバー側で結果セットを制限する SELECT 文の句(TOP、LIMIT など)に変換される場合があります。DBMS でそのような句がサポートされていない場合には、クライアント側で制限がかけられます。
デフォルト値は -1 です。