FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode

• 親: TFDFetchOptions

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 を使ってユーザーからアクセスすることができます。 RecordCountMode では、データセットに対して削除/追加されたレコードを追跡します。 ライブ データ ウィンドウ モードの TFDTable には適用できません。 オーバーヘッドが生じません。 エンド ユーザーにとって使いやすい値が得られます。
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 を使用するのをやめてください。

関連項目

• Data.DB.TDataSet.RecordCount
• FireDAC.Stan.Option.TFDFetchOptions.Mode