Datasnap.Provider.TCustomProvider.ApplyUpdates
Delphi
function ApplyUpdates(const Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer): OleVariant; overload;
function ApplyUpdates(const Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer; var OwnerData: OleVariant): OleVariant; overload;
C++
System::OleVariant __fastcall ApplyUpdates(const System::OleVariant &Delta, int MaxErrors, /* out */ int &ErrorCount)/* overload */;
System::OleVariant __fastcall ApplyUpdates(const System::OleVariant &Delta, int MaxErrors, /* out */ int &ErrorCount, System::OleVariant &OwnerData)/* overload */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Datasnap.Provider.pas Datasnap.Provider.hpp |
Datasnap.Provider | TCustomProvider |
Beschreibung
Trägt als Delta-Pakete erhaltene Aktualisierungen ein.
Mit ApplyUpdates tragen Sie die in einem Delta-Paket enthaltenen Aktualisierungen ein. ApplyUpdates erzeugt ein BeforeApplyUpdates-Ereignis, trägt die Aktualisierungen ein und erzeugt dann ein AfterApplyUpdates-Ereignis.
Im Parameter Delta wird das Delta-Paket festgelegt.
Der Parameter MaxErrors gibt die Maximalanzahl der Fehler an, die auftreten dürfen, bevor die Aktualisierung abgebrochen wird. Wenn MaxErrors den Wert –1 enthält, versucht der Provider, alle Aktualisierungen einzutragen.
ErrorCount gibt die Anzahl der während der Aktualisierung aufgetretenen Fehler an.
Der Parameter OwnerData liefert benutzerdefinierte Informationen, die an die Ereignisbehandlungsroutine BeforeApplyUpdates übergeben werden. Der Parameter gibt von dieser Ereignisbehandlungsroutine bereitgestellte Informationen zurück.
ApplyUpdates liefert ein Datenpaket mit Aktualisierungen als eine OleVariante zurück, die nicht in die Datenbank übertragen werden konnten.
Anmerkung: ApplyUpdates erzeugt immer die Ereignisse BeforeApplyUpdates und AfterApplyUpdates, auch wenn Sie die Syntax ohne den Parameter OwnerData verwenden. In diesem Fall ist der Wert von OwnerData beim Eintritt in die Ereignisbehandlungsroutine BeforeApplyUpdates nil (Delphi) bzw. NULL (C++). Beim Verlassen der Ereignisbehandlungsroutine AfterApplyUpdates wird dieser Wert verworfen.
Warnung: Bei Memofeldern kann der Provider nicht feststellen, ob eine Aktualisierung zu einem Konflikt mit den Änderungen eines anderen Benutzers führt. Der Server findet diese Konflikte nicht und kann sie deshalb auch nicht als Fehler in ErrorCount zählen.