Datasnap.DataBkr.TRemoteDataModule.AS_Execute

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche


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.DataBkr.pas
Datasnap.DataBkr.hpp
Datasnap.DataBkr TRemoteDataModule

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.

Anmerkung:  AS_Execute sollte nur für Provider aufgerufen werden, deren Datenmenge eine Abfrage oder Stored Procedure darstellt, die keinen Cursor zurückgibt.

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

CommandText ist eine optionale SQL-Anweisung, die die SQL-Anweisung des Providers ersetzt, oder der Name einer Stored Procedure, die die Stored Procedure des Providers ersetzt. Wenn poAllowCommandText in Options nicht enthalten ist, wird dieser Parameter ignoriert.

Der Parameter Params codiert alle Parameter für die Abfrage oder Stored Procedure und gibt alle Ausgabeparameter zurück. Mithilfe der Methode PackageParams können Sie ein TParams-Objekt mit den gewünschten Parameterwerten erstellen.

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.

Anmerkung:  Anwendungen können die als protected deklarierte Methode AS_Execute nur über das IAppServer-Interface aufrufen. Um direkt auf eine Datenmenge zuzugreifen, verwenden Sie die Datenmengenkomponente.

Siehe auch