Datasnap.Provider.TCustomProvider.BeforeApplyUpdates

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property BeforeApplyUpdates: TRemoteEvent read FBeforeApplyUpdates write FBeforeApplyUpdates;

C++

__property Datasnap::Dbclient::TRemoteEvent BeforeApplyUpdates = {read=FBeforeApplyUpdates, write=FBeforeApplyUpdates};

Propriétés

Type Visibilité  Source Unité  Parent
event protected
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TCustomProvider

Description

Se produit avant que le fournisseur n'applique les mises à jour à partir d'un ensemble de données client.

Ecrivez un gestionnaire d'événements BeforeApplyUpdates pour répondre aux informations personnalisées d'un ensemble de données client. BeforeApplyUpdates fait partie du procédé par lequel un fournisseur et un ensemble de données client communiquent des informations sur les mises à jour. Lorsque le fournisseur fait partie d'un serveur d'applications sans état, ce procédé permet au fournisseur et à l'ensemble de données client de communiquer des informations d'état persistantes.

Lorsque la méthode ApplyUpdates de l'ensemble de données client est appelée, les événements suivants se produisent :

1. L'ensemble de données client reçoit un événement BeforeApplyUpdates, dans lequel il peut coder des informations personnalisées dans un OleVariant.

2. Le fournisseur reçoit un événement BeforeApplyUpdates, dans lequel l'OleVariant de l'ensemble de données client apparaît en tant que paramètre OwnerData. Le fournisseur peut répondre à ces informations, ou les modifier, avant d'appliquer les mises à jour.

3. Si le fournisseur est un fournisseur d'ensemble de données, il applique les mises à jour et reçoit un événement OnUpdateError pour tous les enregistrements posant problème.

4. Le fournisseur reçoit un événement AfterApplyUpdates, dans lequel il peut coder des informations personnalisées (dans son paramètre OwnerData) ou répondre aux informations provenant du gestionnaire d'événements BeforeApplyUpdates.

5. L'ensemble de données client reçoit un événement AfterApplyUpdates, dans lequel il peut répondre aux informations personnalisées renvoyées par le fournisseur dans son gestionnaire d'événements AfterApplyUpdates.

Remarque :  Si ApplyUpdates est appelée sans le paramètre OwnerData, le paramètre OwnerData vaut nil (Delphi) ou NULL (C++) à l'entrée du gestionnaire d'événements et sa valeur (en sortie) est uniquement transmise au gestionnaire d'événements AfterApplyUpdates et n'est pas renvoyée à l'appelant.

BeforeApplyUpdates est du type Datasnap.DBClient.TRemoteEvent.

Voir aussi