Datasnap.Provider.TCustomResolver.ApplyUpdates
Delphi
function ApplyUpdates(const Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer): OleVariant; virtual;
C++
virtual System::OleVariant __fastcall ApplyUpdates(const System::OleVariant &Delta, int MaxErrors, /* out */ int &ErrorCount);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Datasnap.Provider.pas Datasnap.Provider.hpp |
Datasnap.Provider | TCustomResolver |
Beschreibung
Trägt die von einem Provider empfangenen Aktualisierungen ein.
Provider rufen ApplyUpdates auf, um die von einer Client-Datenmenge oder einem XML-Broker erhaltenen Aktualisierungen einzutragen.
Die Methode ApplyUpdates erzeugt ein OnUpdateData-Ereignis für den zugehörigen Provider und trägt anschließend die im Parameter Delta übergebenen Aktualisierungen ein. Aktualisierungen, die nicht eingetragen werden konnten, werden in einem OleVariant-Wert zurückgegeben.
Der Parameter Delta bezeichnet ein Delta-Paket, das die einzutragenden Einfügungen, Löschungen und Änderungen enthält. MaxErrors gibt an, wie viele Fehler auftreten dürfen, bis der Aktualisierungsvorgang abgebrochen wird. ErrorCount gibt die Anzahl der Fehler zurück, die bei der Aktualisierung aufgetreten sind. Ist ErrorCount größer als MaxErrors, wird für alle bereits durchgeführten Aktualisierungen ein Rollback durchgeführt und der Aktualisierungsvorgang abgebrochen. Dasselbe gilt, wenn ein OnUpdateError-Ereignis den Wert rrAbort liefert.
Wenn der Provider über eine Ereignisbehandlungsroutine für OnUpdateError verfügt, wird diese automatisch aufgerufen, wenn ein Datensatz in Delta nicht aktualisiert werden kann. In der Ereignisbehandlungsroutine für OnUpdateError können Fehlerbedingungen beseitigt und die Aktualisierung erneut durchgeführt werden, bevor die Datensätze an die Client-Datenmenge oder den XML-Broker zurückgegeben werden.