FireDAC.Comp.Client.TFDMetaInfoQuery.AggregatesActive

提供:RAD Studio API Documentation

Delphi

property AggregatesActive: Boolean read FAggregatesActive write SetAggregatesActive default 0;

C++

__property AggregatesActive = {default=0};

プロパティ

種類 可視性 ソース ユニット
property published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDMetaInfoQuery

説明

集計値の自動計算を制御します。 {{#multireplace:FireDAC.Comp.Client.TFDMetaInfoQuery.AggregatesActive|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:FireDAC.Comp.DataSet.TFDDataSet.AggregatesActive|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:FireDAC.Comp.DataSet.TFDDataSet.AggregatesActive|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。


集計値の自動計算を制御します。


AggregatesActive を使用して、データセットの集計値の自動保守と自動計算を制御するフラグを取得または設定することができます。

AggregatesActiveFalse(デフォルト)の場合、データセットは集計を保守しません。そのため、データセットでは取得時またはデータ編集時に発生する集計値を計算するオーバーヘッドなしで、大規模なデータセット更新や大量のデータ取得を実行することができます。AggregatesActiveTrue の場合、データセットは現在のインデックスと互換である Aggregates プロパティで指定されたすべての集計値を計算し、保守します。

一度にすべての集計を扱うのではなく、個別の集計を有効または無効にするには、個別の TFDAggregate オブジェクトの Active プロパティを使用します。これらのオブジェクトは Aggregates プロパティを通じて利用できます。

アプリケーションでデータセットに対するバッチ更新を行う必要があれば、更新の前に AggregatesActiveFalse に設定し、更新が終わったら元の値に戻してください。BeginBatch メソッドおよび EndBatch メソッドも参照してください。

 var
   lPrevAggsActive: Boolean;
 ...
 lPrevAggsActive := FDQuery1.AggregatesActive;
 FDQuery1.AggregatesActive := False;
 try
   // perform updates here, without calculating and reading client aggregates
 finally
   FDQuery1.AggregatesActive := lPrevAggsActive;
 end;

関連項目