API:SimpleDS.TSimpleDataSet.BeforeRowRequest
Delphi
property BeforeRowRequest: TRemoteEvent read FBeforeRowRequest write FBeforeRowRequest;
C++
__property BeforeRowRequest;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
event | published | SimpleDS.pas SimpleDS.hpp |
SimpleDS | TSimpleDataSet |
Description
Se produit avant que l'ensemble de données client récupère les nouvelles informations sur l'enregistrement en cours.
SimpleDS.TSimpleDataSet.BeforeRowRequest hérite de Datasnap.DBClient.TCustomClientDataSet.BeforeRowRequest. Tout le contenu en-dessous de cette ligne se réfère à Datasnap.DBClient.TCustomClientDataSet.BeforeRowRequest.
Se produit avant que l'ensemble de données client récupère les nouvelles informations sur l'enregistrement en cours.
Ecrivez un gestionnaire d'événements BeforeRowRequest pour envoyer des informations personnalisées au fournisseur de l'ensemble de données client. BeforeRowRequest 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 informations de détail sur l'enregistrement en cours ou rafraîchit l'enregistrement actuel, les événements suivants se produisent :
1. L'ensemble de données client reçoit un événement BeforeRowRequest, dans lequel il peut coder des informations personnalisées (dans un OleVariant transmis au fournisseur comme paramètre OwnerData
).
2. Le fournisseur sur le serveur d'application reçoit un événement BeforeRowRequest, dans lequel il peut répondre à ces informations ou les modifier avant de consulter les informations requises.
3. Le fournisseur crée un paquet delta contenant les informations requises.
4. Le fournisseur reçoit un événement AfterRowRequest, 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 BeforeRowRequest.
5. L'ensemble de données client reçoit un événement AfterRowRequest, dans lequel il peut répondre aux informations personnalisées renvoyées par le gestionnaire d'événements AfterRowRequest du fournisseur.
BeforeRowRequest est un gestionnaire d'événements du type Datasnap.DBClient.TRemoteEvent.