FireDAC.Stan.Option.TFDFetchOptions.RecsSkip

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

Delphi

property RecsSkip: Integer read GetRecsSkip write SetRecsSkip  stored IsESS default -1;

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 です。

関連項目