Datasnap.Provider.TCustomProvider.BeforeApplyUpdates
Delphi
property BeforeApplyUpdates: TRemoteEvent read FBeforeApplyUpdates write FBeforeApplyUpdates;
C++
__property Datasnap::Dbclient::TRemoteEvent BeforeApplyUpdates = {read=FBeforeApplyUpdates, write=FBeforeApplyUpdates};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| event | protected | Datasnap.Provider.pas Datasnap.Provider.hpp |
Datasnap.Provider | TCustomProvider |
Beschreibung
Wird ausgelöst, bevor der Provider Aktualisierungen von der Client-Datenmenge einträgt.
Mit einer BeforeApplyUpdates-Ereignisbehandlungsroutine antworten Sie auf benutzerdefinierte Informationen von der Client-Datenmenge. BeforeApplyUpdates ist Bestandteil des Mechanismus, anhand dessen eine Client-Datenmenge und ein Remote-Provider Informationen über Aktualisierungen austauschen. Bei einem statuslosen Anwendungsserver können die Client-Datenmenge und der Provider persistente Statusinformationen austauschen.
Wenn die Methode ApplyUpdates der Client-Datenmenge aufgerufen wird, werden die folgenden Ereignisse ausgelöst:
1. Die Client-Datenmenge erhält ein BeforeApplyUpdates-Ereignis, in dem die benutzerdefinierten Informationen in eine OleVariante codiert werden.
2. Der Provider erhält ein BeforeApplyUpdates-Ereignis, das die OleVariante der Client-Datenmenge in dem Parameter OwnerData enthält. Der Provider kann antworten oder die Informationen vor dem Eintragen der Aktualisierungen ändern.
3. Bei einem Datenmengen-Provider trägt der Provider die Aktualisierungen ein und erhält ein OnUpdateError-Ereignis für jeden problematischen Datensatz.
4. Der Provider empfängt ein AfterApplyUpdates-Ereignis, in dem er benutzerdefinierte Informationen in seinen Parameter OwnerData codieren oder auf Informationen antworten kann, die aus der Ereignisbehandlungsroutine für BeforeApplyUpdates stammen.
5. Die Client-Datenmenge erhält ein AfterApplyUpdates-Ereignis, in dem sie auf vom Provider in der Ereignisbehandlungsroutine AfterApplyUpdates gelieferten benutzerdefinierten Informationen antworten kann.
Hinweis: Wenn ApplyUpdates ohne den Parameter OwnerData aufgerufen wird, enthält der Parameter OwnerData beim Eintritt in die Ereignisbehandlungsroutine nil (Delphi) bzw. NULL (C++). Beim Verlassen der Ereignisbehandlungsroutine ApplyUpdates wird der Wert des Parameters nur an die Ereignisbehandlungsroutine AfterApplyUpdates übergeben, aber nicht an den Aufrufer der Methode.
BeforeApplyUpdates ist des Typs Datasnap.DBClient.TRemoteEvent.