FireDAC.Comp.Client.TFDQuery.AggregatesActive
Delphi
property AggregatesActive;
C++
__property AggregatesActive = {default=0};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
property | published | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDQuery |
説明
集計値の自動計算を制御します。
FireDAC.Comp.Client.TFDQuery.AggregatesActive は FireDAC.Comp.DataSet.TFDDataSet.AggregatesActive を継承しています。以下の内容はすべて FireDAC.Comp.DataSet.TFDDataSet.AggregatesActive を参照しています。
集計値の自動計算を制御します。
AggregatesActive を使用して、データセットの集計値の自動保守と自動計算を制御するフラグを取得または設定することができます。
AggregatesActive が False(デフォルト)の場合、データセットは集計を保守しません。そのため、データセットでは取得時またはデータ編集時に発生する集計値を計算するオーバーヘッドなしで、大規模なデータセット更新や大量のデータ取得を実行することができます。AggregatesActive が True の場合、データセットは現在のインデックスと互換である Aggregates プロパティで指定されたすべての集計値を計算し、保守します。
一度にすべての集計を扱うのではなく、個別の集計を有効または無効にするには、個別の TFDAggregate オブジェクトの Active プロパティを使用します。これらのオブジェクトは Aggregates プロパティを通じて利用できます。
アプリケーションでデータセットに対するバッチ更新を行う必要があれば、更新の前に AggregatesActive を False に設定し、更新が終わったら元の値に戻してください。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;