Datasnap.Win.TConnect.TLocalConnection.AS_Execute
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);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
protected | Datasnap.Win.TConnect.pas Datasnap.Win.TConnect.hpp |
Datasnap.Win.TConnect | TLocalConnection |
説明
指定されたプロバイダにバインドされた、クエリまたはストアド プロシージャを実行します。
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 イベント ハンドラに渡されます。