Datasnap.DBClient.TCustomClientDataSet.BeforeGetRecords
Delphi
property BeforeGetRecords: TRemoteEvent read FBeforeGetRecords write FBeforeGetRecords;
C++
__property TRemoteEvent BeforeGetRecords = {read=FBeforeGetRecords, write=FBeforeGetRecords};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | protected | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Description
Se produit avant que l'ensemble de données client récupère un paquet de données du fournisseur.
Ecrivez un gestionnaire d'événements BeforeGetRecords pour envoyer des informations personnalisées au fournisseur de l'ensemble de données client. BeforeGetRecords fait partie du mécanisme par lequel un ensemble de données client et un fournisseur échangent des informations sur la récupération de données. 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'ensemble de données client récupère des données provenant du serveur d'application, les événements suivants se produisent :
1. L'ensemble de données client reçoit un événement BeforeGetRecords, 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 BeforeGetRecords, dans lequel il peut répondre à ces informations ou les modifier avant de créer un paquet de données.
3. Le fournisseur génère le paquet de données.
4. Le fournisseur reçoit un événement AfterGetRecords, 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 BeforeGetRecords.
5. L'ensemble de données client reçoit un événement AfterGetRecords, dans lequel il peut répondre aux informations personnalisées renvoyées par le gestionnaire d'événements AfterGetRecords du fournisseur.
BeforeGetRecords est un gestionnaire d'événements du type Datasnap.DBClient.TRemoteEvent.