Datasnap.Provider.TCustomProvider.Execute

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Execute(const CommandText: OleStr; var Params,  OwnerData: OleVariant); virtual;

C++

virtual void __fastcall Execute(const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TCustomProvider

Beschreibung

Führt eine Abfrage, eine Stored Procedure oder eine benutzerdefinierte SQL-Anweisung aus.

Client-Datenmengen rufen Execute in der Methode AS_Execute der IAppServer-Schnittstelle auf. Als Reaktion darauf, führt der Provider einen SQL-Befehl aus. Wenn der Provider eine Abfrage oder Stored Procedure repräsentiert, die keinen Cursor zurückgibt, bewirkt der Aufruf von Execute, dass der Provider die Abfrage oder Stored Procedure ausführt. Wenn der Aufrufer einen Wert für CommandText bereitstellt, führt Execute gegebenenfalls (siehe unten) diese Anweisung aus.

Vor der Ausführung des entsprechenden Befehls erzeugt Execute ein BeforeExecute-Ereignis. Nach Ausführung dieses Befehls wird ein AfterExecute-Ereignis erzeugt. Abschließend werden die Ausgabeparameter als Wert des Parameters Params zurückgegeben.

CommandText gibt entweder eine SQL-Anweisung, die die SQL-Anweisung einer verbundenen Abfrage ersetzt, oder den Namen einer Stored Procedure an, die die verbundene Stored Procedure ersetzt. Wenn poAllowCommandText in Options nicht enthalten ist, wird dieser Parameter ignoriert.

Beim Eintritt in die Methode stellt Params die Parameterwerte für die Abfrage, Stored Procedure oder für den CommandText-String bereit. Beim Beenden der Methode liefert Params die Ausgabeparameter.

OwnerData enthält benutzerdefinierte Informationen, die von der Ereignisbehandlungsroutine BeforeExecute der Client-Datenmenge an den Provider übergeben werden. Die Daten werden an die Ereignisbehandlungsroutine BeforeExecute des Providers übergeben und von der Ereignisbehandlungsroutine AfterExecute zurückgegeben.

Siehe auch