Bde.DBTables.TDatabase.ApplyUpdates
Delphi
procedure ApplyUpdates(const DataSets: array of TDBDataSet);
C++
void __fastcall ApplyUpdates(TDBDataSet* const *DataSets, const int DataSets_High);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TDatabase |
Beschreibung
Übergibt anstehende zwischengespeicherte Aktualisierungen für die angegebenen Datenmengen an den Datenbankserver.
Durch einen Aufruf von ApplyUpdates können die vorhandenen zwischengespeicherten Aktualisierungen für eine bestimmte Gruppe von geöffneten Datenmengen auf dem Datenbank-Server eingetragen werden. ApplyUpdates wirkt sich nur aus, wenn die Eigenschaft CachedUpdates für die angegebene Datenmenge den Wert True hat.
DataSets ist eine Liste mit den Namen der Datenmengen, deren zwischengespeicherte Aktualisierungen übergeben werden sollen. DataSets muss nicht alle aktuell geöffneten Datenmengen enthalten. ApplyUpdates ruft für jede angegebene Datenmenge die zugehörige ApplyUpdates- und CommitUpdates-Methode auf, um die zwischengespeicherten Aktualisierungen einzutragen.
Das Eintragen der Aktualisierungen erfolgt in einer zweistufigen Operation im Kontext der Transaktionskontrolle der Datenbank-Komponente. Wenn eine Anwendung ApplyUpdates aufruft, werden die folgenden Aktionen ausgeführt:
- Eine Datenbanktransaktion wird begonnen.
- Zwischengespeicherte Aktualisierungen werden in die Datenbank geschrieben (Stufe 1).
Wenn das Schreiben in die Datenbank erfolgreich war, wird folgendermaßen fortgefahren:
- Die Änderungen am Database-Objekt werden eingetragen, und die Transaktion wird beendet.
- Zwischengespeicherte Aktualisierungen (CachedUpdates) werden eingetragen, und der interne Zwischenspeicher wird geleert (Stufe 2).
Wenn das Schreiben in die Datenbank fehlschlägt, werden die Änderungen durch einen Rollback zurückgenommen, und die Transaktion wird beendet.
Dieser zweistufige Ansatz ermöglicht eine wirkungsvolle Fehlerbehandlung speziell bei der Aktualisierung mehrerer Datenmengen, die miteinander in Beziehung stehen (z.B. Datenmengen, die in einem Haupt-/Detailformular verbunden sind).