Datasnap.Midas.IAppServer.AS_Execute

Übergeordnet: IAppServer

Delphi

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

C++

virtual HRESULT __safecall AS_Execute(const System::WideString ProviderName, const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData) = 0 ;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	Datasnap.Midas.pas Datasnap.Midas.hpp	Datasnap.Midas	IAppServer

Beschreibung

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

Mit AS_Execute kann ein Ausführungsbefehl mit bestimmten Parametern an einen externen Provider übergeben werden. AS_Execute ruft die Methode AS_Execute des Providers auf und übergibt ihr die angegebenen Parameter. Ausgabeparameter werden im Parameter Params zurückgegeben.

Die Methode AS_Execute des Providers generiert das Ereignis BeforeExecute, übergibt den Befehl an die zugeordnete Datenmenge und generiert dann das 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 oder den Namen einer Stored Procedure an, die den SQL-Code der Abfrage bzw. die Stored Procedure der Datenmenge ersetzt. Der Parameter wird ignoriert, wenn die Eigenschaft Options nicht das Flag poAllowCommandText enthält.

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 ein TParams-Objekt mit den gewünschten Parameterwerten erstellen. Mit der Routine Unpackparams können Sie Params in ein TParams-Objekt decodieren.

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