API:SimpleDS.TSimpleDataSet.BeforeExecute
Delphi
property BeforeExecute: TRemoteEvent read FBeforeExecute write FBeforeExecute;
C++
__property BeforeExecute;
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 exécute une requête ou une procédure stockée du fournisseur.
SimpleDS.TSimpleDataSet.BeforeExecute hérite de Datasnap.DBClient.TCustomClientDataSet.BeforeExecute. Tout le contenu en-dessous de cette ligne se réfère à Datasnap.DBClient.TCustomClientDataSet.BeforeExecute.
Se produit avant que l'ensemble de données client exécute une requête ou une procédure stockée du fournisseur.
Ecrivez un gestionnaire d'événements BeforeExecute pour envoyer des informations personnalisées au fournisseur de l'ensemble de données client. BeforeExecute fait partie du mécanisme par lequel un ensemble de données client et un fournisseur échangent des informations lorsqu'une commande SQL est explicitement exécutée par l'ensemble de données du fournisseur. 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 Execute 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 BeforeExecute, 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 BeforeExecute, dans lequel il peut répondre à ces informations ou les modifier avant d'exécuter la requête ou la procédure stockée.
3. Le fournisseur exécute la commande appropriée (soit la commande fournie par la propriété CommandText soit la commande associée à l'ensemble de données, telle qu'une requête ou une procédure stockée).
4. Le fournisseur reçoit un événement AfterExecute, 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 BeforeExecute.
5. L'ensemble de données client défait des packages tous les paramètres de sortie provenant du fournisseur et les met dans la propriété Params puis reçoit un événement AfterExecute, dans lequel il peut répondre aux informations personnalisées renvoyées par le gestionnaire d'événements AfterExecute du fournisseur.
BeforeExecute est un gestionnaire d'événements du type Datasnap.DBClient.TRemoteEvent.