Datasnap.Midas.IAppServer.AS_Execute
Delphi
procedure AS_Execute(const ProviderName: OleStr; const CommandText: OleStr;
var Params: OleVariant; var OwnerData: OleVariant); safecall;
C++
virtual HRESULT __safecall AS_Execute(const System::WideString ProviderName, const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData) = 0 ;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | Datasnap.Midas.pas Datasnap.Midas.hpp |
Datasnap.Midas | IAppServer |
説明
指定したプロバイダにバインドされた、クエリまたはストアド プロシージャを実行します。
AS_Execute メソッドを使用すると、指定されたパラメータのセットを使って、実行コマンドをリモート プロバイダに渡すことができます。 AS_Execute は、何らかのパラメータを割り当てた後に指定したプロバイダの AS_Execute メソッドを呼び出します。 クエリまたはストアド プロシージャの実行結果である出力パラメータは、Params パラメータに格納されて返ります。
プロバイダの AS_Execute メソッドは BeforeExecute イベントを生成し、 関連付けられたデータセットにコマンドを渡してから AfterExecute イベントを生成します。 データセットはカーソルを返さないクエリまたはストアド プロシージャを表す必要があります。
ProviderName パラメータは、クエリまたはストアド プロシージャに関連付けられたプロバイダ コンポーネントの名前を指定します。
CommandText パラメータは、クエリの SQL を置き換えるオプションの SQL ステートメント、およびデータセットのストアド プロシージャを置き換えるストアド プロシージャの名前を指定します。 プロバイダの Options プロパティが poAllowCommandText を含まない場合、このパラメータは無視されます。
Params パラメータは、クエリまたはストアド プロシージャに想定されるすべてのパラメータをエンコードし、すべての出力パラメータを返します。 TParams オブジェクトから 適切にエンコードされた Params の値を作成するには、PackageParams ルーチンを使用します。 TParams オブジェクトに Params をデコードするには、UnpackParams ルーチンを使用します。
OwnerData パラメータは、プロバイダの BeforeExecute および AfterExecute イベント ハンドラへの引数として現れるカスタム情報を含みます。 この情報は、クライアント データセットの BeforeExecute イベント ハンドラ内で生成されます。 OwnerData に返される値は、クライアント データセットの AfterExecute イベント ハンドラに渡されます。