API:Datasnap.DBClient.TClientDataSet.BeforeApplyUpdates

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property BeforeApplyUpdates: TRemoteEvent read FBeforeApplyUpdates write FBeforeApplyUpdates;

C++

__property BeforeApplyUpdates;

Propriétés

Type Visibilité  Source Unité  Parent
event published
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TClientDataSet

Description

Se produit avant que l'ensemble de données client applique les mises à jour sur le serveur distant.

Datasnap.DBClient.TClientDataSet.BeforeApplyUpdates hérite de Datasnap.DBClient.TCustomClientDataSet.BeforeApplyUpdates. Tout le contenu en-dessous de cette ligne se réfère à Datasnap.DBClient.TCustomClientDataSet.BeforeApplyUpdates.

Se produit avant que l'ensemble de données client applique les mises à jour sur le serveur distant.

Ecrivez un gestionnaire d'événements BeforeApplyUpdates pour envoyer des informations personnalisées au fournisseur de l'ensemble de données client. BeforeApplyUpdates fait partie d'un procédé par lequel un ensemble de données client et un fournisseur échangent des informations sur les mises à jour. Lors de l'utilisation d'un fournisseur sur un serveur d'application sans état, ce mécanisme permet à l'ensemble de données client et au fournisseur d'échanger des informations persistantes sur l'état.

Lorsque l'application appelle la méthode ApplyUpdates de l'ensemble de données client, 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 transmis au fournisseur comme paramètre OwnerData).

2. Le fournisseur reçoit un événement BeforeApplyUpdates, dans lequel il peut répondre à ces informations ou les modifier avant d'appliquer les mises à jour.

3. Le fournisseur 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 gestionnaire d'événements AfterApplyUpdates du fournisseur.

BeforeApplyUpdates est un gestionnaire d'événements du type Datasnap.DBClient.TRemoteEvent.

Voir aussi