Datasnap.DBClient.TCustomClientDataSet.Execute

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

procedure Execute; virtual;

C++

virtual void __fastcall Execute(void);

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

説明

Execute は,SQL コマンドをプロバイダのデータセットで実行します。

Execute メソッドを呼び出すと,クライアントデータセットは,結果セットを生成しない問い合わせまたはストアドプロシージャと対話できます。Execute を呼び出すと,CommandText で指定したコマンドか,プロバイダの問い合わせまたはストアドプロシージャを実行できます。CommandText が空の文字列ではない場合で,かつプロバイダの Options によってクライアントが CommandText 値を供給できる場合,Execute は,Params プロパティ(文のパラメータを供給)とともに CommandText をプロバイダに渡します。それ以外の場合,Execute は,Params の適用,および関連する問い合わせまたはストアドプロシージャの実行をプロバイダに通知します。適切な文を実行したら,プロバイダは出力パラメータを返し,ExecuteParams プロパティを更新してその出力パラメータを反映します。

アプリケーションが Execute を実行すると,クライアントデータセットは,要求がプロバイダコンポーネントに渡される前に BeforeExecute イベントを受け取ります。プロバイダは,問い合わせまたはストアドプロシージャを実行すると,出力パラメータを返します。これらの出力パラメータは,Params プロパティの更新に使用されます。最後に,クライアントデータセットが AfterExecute イベントを受け取ります。

メモ:  カーソルを返す問い合わせまたはストアドプロシージャの実行には,Execute を使用しないでください。ほとんどのデータセットは,データを返す場合も,返さない場合も,分割コマンドを使って問い合わせまたはストアドプロシージャを実行します。プロバイダが Execute コマンドをデータセットに渡すと,データセットは,カーソルを返さない問い合わせまたはストアドプロシージャの実行コマンドを使用します。

関連項目