FireDAC.Comp.Client.TFDCustomSchemaAdapter.ApplyUpdates
Delphi
function ApplyUpdates(AMaxErrors: Integer = -1): Integer;
C++
int __fastcall ApplyUpdates(int AMaxErrors = 0xffffffff);
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomSchemaAdapter |
Beschreibung
Trägt Änderungen für alle Datensätze aus dem zentralisierten Änderungsjournal in die Datenbank ein.
Mit ApplyUpdates können Sie Änderungen für alle Datensätze aus dem zentralisierten Änderungsjournal in die Datenbank eintragen. Diese Funktion gibt die Anzahl der gefundenen Probleme zurück. Das zentralisierte Änderungsjournal sammelt Änderungen aus:
- FireDAC-Datenmengen, deren Eigenschaft SchemaAdapter auf diese TFDCustomSchemaAdapter-Instanz gesetzt ist.
- Tabellenadaptern, deren Eigenschaft SchemaAdapter auf diese TFDCustomSchemaAdapter-Instanz gesetzt ist.
Der Aufruf von ApplyUpdates führt die folgenden Schritte aus:
- Löst ein BeforeApplyUpdate-Ereignis aus.
- Ruft die Datenadapter auf, um SQL-Aktualisierungsanweisungen für jede Zeile zu erzeugen/verwenden und Änderungen in der Datenbank einzutragen.
- Löst ein AfterApplyUpdate-Ereignis aus.
Ruft die Methode Reconcile auf, um Fehler für alle Datensätze, die Fehler beim Schritt 2 auslösen, zu beheben.
Hinweis: Die Methode CommitUpdates ist nicht vorhanden und muss im Programmcode für jede zugeordnete Datenmenge aufgerufen werden.
AMaxErrors gibt die maximale Anzahl von Fehlern an, die FireDAC vor dem vorzeitigen Abbruch der Aktualisierung zulassen sollte. Setzen Sie AMaxErrors auf –1, um anzugeben, dass es keine Beschränkung der Anzahl der Fehler gibt, oder auf 0, um anzugeben, dass kein Fehler zulässig ist.
ApplyUpdates gibt die Anzahl der gefundenen Fehler zurück. Auf Basis dieses Rückgabewerts und des erfolgreichen Setzens von AMaxErrors werden eingetragene Aktualisierungen aus dem zentralisierten Änderungsprotokoll entfernt. Wenn der Aktualisierungsprozess vor dem Eintragen aller Aktualisierungen abgebrochen wird, verbleiben die Aktualisierungen, die nicht eingetragen wurden, in dem Änderungsprotokoll.
ApplyUpdates löst keine Exception aus. In der Anwendung sollten stattdessen fehlerhafte Datensätze mit der Funktion Reconcile und der Ereignisbehandlungsroutine OnReconcileRow oder mit den Eigenschaften FilterChanges und RowError für jede Datenmenge überprüft werden. Weitere Einzelheiten finden Sie im Abschnitt "Überprüfen von Fehlern" unter Zwischenspeichern von Aktualisierungen.
Siehe auch
- FireDAC.Comp.Client.TFDRdbmsDataSet.SchemaAdapter
- FireDAC.Comp.Client.TFDCustomSchemaAdapter.Reconcile
- Zwischenspeichern von Aktualisierungen (FireDAC)
Beispiele
- FireDAC TFDQuery Centralized Cached Updates (Beispiel)