Datasnap.DSConnect.TDSProviderConnection.AS_Execute
Delphi
procedure AS_Execute(const ProviderName: OleStr; const CommandText: OleStr; 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.DSConnect.pas Datasnap.DSConnect.hpp |
Datasnap.DSConnect | TDSProviderConnection |
Beschreibung
Führt die Abfrage oder Stored Procedure aus, die mit einem angegebenen 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 angegebenen Providers auf und übergibt ihr die Parameter. Ausgabeparameter werden im Parameter Params
zurückgegeben.
Die Methode AS_Execute des Providers erzeugt das Ereignis BeforeExecute, übergibt den Befehl an die zugeordnete Datenmenge und generiert 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 korrekt 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 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.