FireDAC.Comp.DataSet.TFDDataSet.AggregatesActive

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property AggregatesActive: Boolean read FAggregatesActive write SetAggregatesActive default False;

C++

__property bool AggregatesActive = {read=FAggregatesActive, write=SetAggregatesActive, default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Beschreibung

Steuert die automatische Berechnung von Aggregatwerten.

Mit AggregatesActive ermitteln oder setzen Sie das Flag, das die automatische Verwaltung und Berechnung von Aggregatwerten der Datenmenge steuert.

Wenn AggregatesActive False ist (Vorgabe), verwaltet die Datenmenge keine Aggregate. Dadurch kann die Datenmenge große Aktualisierungen der Datenmenge durchführen oder eine große Menge an Daten abrufen, ohne den Overhead des Berechnens von Aggregatwerten, der beim Abrufen oder Bearbeiten von Daten vorkommt. Wenn AggregatesActive True ist, berechnet und verwaltet die Datenmenge alle in der Eigenschaft Aggregates angegebenen Aggregatwerte, die kompatibel mit dem aktuellen Index sind.

Verwenden Sie die Eigenschaft Active des jeweiligen TFDAggregate-Objekts, um Aggregate selektiv zu aktivieren und zu deaktivieren, anstatt sie alle gleichzeitig ein- oder auszuschalten. Diese Objekte sind über die Eigenschaft Aggregates verfügbar.

Wenn in der Anwendung Stapel-Aktualisierungen der Datenmenge vorgenommen werden müssen, dann setzen Sie vor der Aktualisierung AggregatesActive auf False und geben nach der Aktualisierung wieder den Originalwert an. Siehe auch die Methoden BeginBatch und EndBatch.

Beispiel

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

Siehe auch