FireDAC.Comp.DataSet.TFDDataSet.BeginBatch
Delphi
procedure BeginBatch(ARegular: Boolean = False);
C++
void __fastcall BeginBatch(bool ARegular = false);
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDDataSet |
Beschreibung
Optimiert die Datenmengenfunktionalität für Stapelaktualisierungen.
Mit der Methode BeginBatch können Sie ressourcenaufwendige Operationen deaktivieren und die Datenmenge so einrichten, dass Aktualisierungen mit maximaler Ausführungsgeschwindigkeit ausgeführt werden. Der Aufruf von BeginBatch deaktiviert:
- Die Aktualisierung von datensensitiven Steuerelementen.
- Die Aktualisierung von Einschränkungen.
- Die Wartung von Aggregaten.
- Das Anzeigen von Wartecursors.
- Die ähnlich ressourcenaufwendige Verarbeitung in DatS-Objekten, die nicht durch APIs der Datenmenge gesteuert wird.
Wenn ein Stapelalgorithmus die Methode Delete aufruft, dann setzen Sie AWithDelete
auf True. Sie dürfen Refresh nicht in einem Stapel aufrufen. Die Aufrufe von BeginBatch dürfen nicht verschachtelt sein, obwohl FireDAC keine Exceptions bei nachfolgenden Aufrufen auslöst. Rufen Sie nach Abschluss der Aktualisierungen die Methode EndBatch auf.
Beispiel
FDQuery1.BeginBatch;
try
FDQuery1.AppendRecord([...]);
FDQuery1.AppendRecord([...]);
FDQuery1.AppendRecord([...]);
......
finally
FDQuery1.EndBatch;
end;