FireDAC.Comp.DataSet.TFDDataSet.BeginBatch

• Übergeordnet: TFDDataSet

Delphi

procedure BeginBatch(ARegular: Boolean = False);

C++

void __fastcall BeginBatch(bool ARegular = false);

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;

Siehe auch

• FireDAC.Comp.DataSet.TFDDataSet.EndBatch