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);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
protected | Datasnap.DSConnect.pas Datasnap.DSConnect.hpp |
Datasnap.DSConnect | TDSProviderConnection |
説明
指定されたプロバイダにバインドされた、クエリまたはストアド プロシージャを実行します。
AS_Execute を使用すると、実行コマンドをリモート プロバイダへ、指定された一連のパラメータを使用して渡すことができます。AS_Execute は、パラメータを割り当てた後、指定されたプロバイダの AS_Execute メソッドを呼び出します。クエリまたはストアド プロシージャを実行した結果となる出力パラメータは、Params
パラメータによって返されます。
プロバイダの AS_Execute メソッドは、BeforeExecute イベントを生成し、コマンドをそれが割り当てられるデータセットへ渡し、AfterExecute イベントを生成します。データセットは、カーソルを返さないクエリまたはストアド プロシージャを表さなければなりません。
ProviderName
パラメータは、クエリまたはストアド プロシージャと関連付られている、プロバイダ コンポーネントの名前を指定します。
CommandText
は、クエリの SQL と置換する任意の SQL 文、または、データセットのストアド プロシージャと置換するストアド プロシージャの名前を指定します。このパラメータは、プロバイダの Options
プロパティに poAllowCommandText
が含まれていない場合には、無視されます。
Params
パラメータは、クエリまたはストアド プロシージャで期待される、どんなパラメータでもエンコードし、出力パラメータを返します。Params
のための適切にエンコードされた値を、TParams オブジェクトから作成するには、PackageParams ルーチンを使用します。Params
を TParams オブジェクトへとデコードするには、UnpackParams ルーチンを使用します。
OwnerData
パラメータには、プロバイダの BeforeExecute および AfterExecute イベント ハンドラへの引数として現れる、独自の情報が含まれています。この情報は、基はクライアント データセットの BeforeExecute イベントに基づくものです。OwnerData
内で返される値は、クライアント データセットの AfterExecute イベント ハンドラに渡されます。