Datasnap.Win.TConnect.TLocalConnection.AS_Execute

Übergeordnet: TLocalConnection

Delphi

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

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	protected	Datasnap.Win.TConnect.pas Datasnap.Win.TConnect.hpp	Datasnap.Win.TConnect	TLocalConnection

Beschreibung

Führt die mit einem angegebenen Provider verbundene Abfrage oder Stored Procedure aus.

Mit AS_Execute kann ein Ausführungsbefehl mit bestimmten Parametern an einen externen Provider übergeben werden. AS_Execute ruft die Methode AS_Execute des angegebenen Providers auf, nachdem die Parameter übergeben wurden. Ausgabeparameter, die das Ergebnis der Ausführung einer Abfrage oder Stored Procedure sind, werden im Parameter Params zurückgegeben.

Die Methode AS_Execute erzeugt das 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 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 von einem TParams-Objekt einen korrekten codierten Wert für Params erstellen. Mit der Routine UnpackParams können Sie Params in ein TParams-Objekt decodieren.

Der Parameter OwnerData enthält benutzerdefinierte Daten für die Ereignisbehandlungsroutinen BeforeExecute und AfterExecute 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.