Datasnap.DBClient.TRemoteEvent
Delphi
TRemoteEvent = procedure(Sender: TObject; var OwnerData: OleVariant) of object;
C++
typedef void __fastcall (__closure *TRemoteEvent)(System::TObject* Sender, System::OleVariant &OwnerData);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
type typedef |
public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | Datasnap.DBClient |
Description
TRemoteEvent est le type des gestionnaires d'événements qui transmettent les informations personnalisées d'un fournisseur, ou vers un fournisseur.
TRemoteEvent est le type des gestionnaires d'événements qui permettent aux applications client et aux fournisseurs de personnaliser la communication qui a lieu sur une interface IAppServer. Avant chaque appel à IAppServer qui est dirigé vers un fournisseur, l'ensemble de données client reçoit un événement du type TRemoteEvent où il peut renvoyer des informations personnalisées sous forme d'un OleVariant. Quand l'interface IAppServer passe la commande au fournisseur cible, le fournisseur reçoit un événement du type TRemoteEvent où il peut répondre ou modifier les informations entrantes avant que la commande ne soit exécutée. Après l'exécution de la commande, le fournisseur reçoit un autre événement du même type, où il peut encore une fois revoir les informations personnalisées et les renvoyer à l'ensemble de données client. Enfin, l'ensemble de données client reçoit les informations renvoyées dans un gestionnaire d'événements TRemoteEvent ou en tant que paramètre de la méthode.
Sender est l'ensemble de données client ou le fournisseur qui reçoit l'événement :
OwnerData représente les informations personnalisées définies par le développeur d'applications.
- Dans les événements "BeforeXXX" de l'ensemble de données client, ce paramètre est en sortie seulement et il peut être envoyé au fournisseur.
- Dans les événements "BeforeXXX" du fournisseur, ce paramètre entre en tant qu'informations envoyées par l'événement "BeforeXXX" de l'ensemble de données client et renvoie les informations passées à l'événement "AfterXXX" du fournisseur.
- Dans l'événement "AfterXXX" du fournisseur, ce paramètre entre en tant qu'informations de l'événement "BeforeXXX" du fournisseur (ou de l'ensemble de données client) et renvoie les informations passées à l'événement "AfterXXX" de l'ensemble de données client.
- Dans les événements "AfterXXX" de l'ensemble de données client, ce paramètre est en entrée seulement et contient les informations renvoyées par le fournisseur.
Remarque : OwnerData est un OleVariant. En tant que tel, il peut contenir une seule valeur de donnée, une interface ou un tableau de variants. Reportez-vous au lien de l'exemple pour savoir comment packager plusieurs valeurs dans le paramètre OwnerData.