FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode

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

Delphi 

property RecordCountMode: TFDRecordCountMode read GetRecordcountMode  write SetRecordCountMode stored IsRCMS default cmVisible;

C++ 

__property TFDRecordCountMode RecordCountMode = {read=GetRecordcountMode, write=SetRecordCountMode, stored=IsRCMS, default=0};

プロパティ

種類 可視性 ソース ユニット 親
property published
FireDAC.Stan.Option.pas
FireDAC.Stan.Option.hpp
 FireDAC.Stan.Option TFDFetchOptions

説明

結果セット内のレコードの数え方を制御します。


RecordCountMode プロパティを使用して、TFDDataSet が結果セット内のレコード数を数える方法を制御することができます。

モード

説明

cmVisible

RecordCount は、TDataSet ナビゲーション インターフェイスを通じて現在アクセスできるレコードの数を返します。たとえば、これらのレコードはすべて、関連する TDBGrid を使ってユーザーからアクセスすることができます。

cmFetched

RecordCount は、現時点で取得済みのレコードの数を返します。

  • RecordCountMode では、データセットに対して削除/追加されたレコードを追跡します。
  • ライブ データ ウィンドウ モードの TFDTable には適用できません。
  • オーバーヘッドが生じません。
  • エンド ユーザーにとって使いやすい値ではなく、現在のデータセットの "重さ" が得られます。

cmTotal

RecordCount は、レコードの数（コマンドで返される数）を返します。そのために、FireDAC では SELECT COUNT(*) FROM (<元の SQL コマンド テキスト>) を発行します。

  • RecordCountMode では、データセットに対して削除/追加されたレコードを追跡しません。最新の RecordCountMode を取得するには、Refresh メソッドを呼び出します。
  • ライブ データ ウィンドウ モードの TFDTable に適用できます。
  • データセットを開くときにオーバーヘッドが発生します。
  • データセット レコードが削除/挿入されない限り、ほぼ正確なレコード数が得られます。

デフォルト値は cmVisible です。

メモ： RecordCountMode が cmTotal の場合に、MySQL から "Commands out of sync; you can't run this command now"（コマンドが同期していません。現在はこのコマンドを実行できません）というエラーが返されることがあります。その場合には、Mode を fmFetchAll に設定するか、cmTotal を使用するのをやめてください。

関連項目

「http://docwiki.embarcadero.com/Libraries/Rio/j/index.php?title=FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode&oldid=558537」から取得