Datasnap.DBClient.TRemoteEvent

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

C++

typedef void __fastcall (__closure *TRemoteEvent)(System::TObject* Sender, System::OleVariant &OwnerData);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
typedef public Datasnap.DBClient.hpp Datasnap.DBClient Datasnap.DBClient

Beschreibung

TRemoteEvent ist der Typ für Ereignisbehandlungsroutinen, die benutzerdefinierte Informationen an oder von einem Provider übergeben.

TRemoteEvent ist der Typ für Ereignisbehandlungsroutinen, die Client-Anwendungen und Providern die Anpassung der über ein IAppServer-Interface auftretenden Kommunikation ermöglichen. Vor jedem an einen Provider gerichteten IAppServer-Aufruf erhält die Client-Datenmenge ein Ereignis des Typs TRemoteEvent, in dem sie benutzerdefinierte Informationen als OleVariant zurückgeben kann. Wenn das IAppServer-Interface den Befehl an den Ziel-Provider übergibt, erhält der Provider ein Ereignis des Typs TRemoteEvent, in dem er vor Ausführung des Befehls auf die eingehenden Informationen reagieren oder diese ändern kann. Nach Ausführung des Befehls erhält der Provider ein weiteres Ereignis desselben Typs, in dem er erneut die benutzerdefinierte Informationen überprüfen und diese an die Client-Datenmenge zurückgeben kann. Schließlich erhält die Client-Datenmenge die zurückgegebenen Informationen in einer TRemoteEvent-Ereignisbehandlungsroutine oder als Parameter für die Methode.

Sender ist die Client-Datenmenge oder der Provider, der das Ereignis erhält.

OwnerData sind die vom Anwendungsentwickler definierten benutzerdefinierten Informationen.

  • In BeforeXXX-Ereignissen von Client-Datenmengen ist dieser Parameter nur für die Ausgabe verfügbar, damit er an den Provider gesendet werden kann.
  • In BeforeXXX-Ereignissen von Providern gibt dieser Parameter die von dem BeforeXXX-Ereignis der Client-Datenmenge gesendeten Informationen an und gibt die an das AfterXXX-Ereignis des Providers übergebenen Informationen zurück.
  • Im Ereignis AfterXXX des Providers gibt dieser Parameter Information aus dem Ereignis BeforeXXX des Providers (oder der Client-Datenmenge) an und gibt die an das AfterXXX-Ereignis der Datenmenge übergebenen Informationen zurück.
  • In AfterXXX-Ereignissen der Client-Datenmenge ist dieser Parameter nur für die Eingabe verfügbar und enthält die vom Provider zurückgegebenen Informationen.

Hinweis: Der Parameter OwnerData ist ein OleVariant. Daher kann er einen einzelnen Datenwert, ein Interface oder ein Variant-Array enthalten. Siehe den Beispiel-Link für eine Möglichkeit mehrere Werte in den Parameter OwnerData zu packen.