Datasnap.Midas.IAppServerDisp.AS_Execute

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche


Delphi

procedure AS_Execute(const ProviderName: OleStr; const CommandText: OleStr;  var Params: OleVariant; var OwnerData: OleVariant); dispid 20000006;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure automated Datasnap.Midas.pas Datasnap.Midas IAppServerDisp

Beschreibung

Führt die Abfrage oder Stored Procedure aus, die mit einem bestimmten Provider verknüpft ist.

Verwenden Sie AS_Execute , um ein Ausführungsbefehl mit einem angegebenen Parametersatz an einen externen Provider zu übergeben. AS_Execute ruft die Methode AS_Execute des angegebenen Providers auf, nachdem alle Parameter zugewiesen wurden. Ausgabeparameter, die aus der Ausführung einer Abfrage oder Stored Procedure resultieren, werden im Parameter Params zurückgegeben.

Die Methode AS_Execute des Providers erzeugt ein Ereignis BeforeExecute, übergibt den Befehl an die zugeordnete Datenmenge und erzeugt dann ein Ereignis AfterExecute. Die Datenmenge muss eine Abfrage oder Stored Procedure repräsentieren, die keinen Cursor zurückgibt.

Der Parameter ProviderName gibt den Namen der Provider-Komponente an, die der Abfrage oder Stored Procedure zugeordnet ist.

CommandText gibt eine optionale SQL-Anweisung (die den SQL-Code der Abfrage ersetzt) oder den Namen einer Stored Procedure (der die Stored Procedure der Datenmenge ersetzt) an. Dieser Parameter wird ignoriert, wenn poAllowCommandText in die Eigenschaft Options des Providers nicht enthalten wird.

Der Parameter Params codiert alle Parameter für die Abfrage oder Stored Procedure und gibt alle Ausgabeparameter zurück. Mit Hilfe der Routine PackageParams können Sie einen geeignet codierten Wert für Params aus einem TParams-Objekt erstellen. Mit der Routine UnpackParams können Sie Params in ein TParams-Objekt entschlüsseln.

Der Parameter OwnerData enthält benutzerdefinierte Daten, die als ein Argument für die BeforeExecute- und AfterExecute-Ereignisbehandlungsroutinen des Providers verwendet werden. Die Daten stammen aus der Ereignisbehandlungsroutine für BeforeExecute der Client-Datenmenge. Der Wert, der in OwnerData zurückgegeben wird, wird an die AfterExecute-Ereignisbehandlungsroutine der Client-Datenmenge übergeben.

Siehe auch