Datasnap.DBClient.TCustomClientDataSet.Execute
Delphi
procedure Execute; virtual;
C++
virtual void __fastcall Execute();
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
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 の適用，および関連する問い合わせまたはストアドプロシージャの実行をプロバイダに通知します。適切な文を実行したら，プロバイダは出力パラメータを返し，Execute は Params プロパティを更新してその出力パラメータを反映します。
アプリケーションが Execute を実行すると，クライアントデータセットは，要求がプロバイダコンポーネントに渡される前に BeforeExecute イベントを受け取ります。プロバイダは，問い合わせまたはストアドプロシージャを実行すると，出力パラメータを返します。これらの出力パラメータは，Params プロパティの更新に使用されます。最後に，クライアントデータセットが AfterExecute イベントを受け取ります。
メモ： カーソルを返す問い合わせまたはストアドプロシージャの実行には，Execute を使用しないでください。ほとんどのデータセットは，データを返す場合も，返さない場合も，分割コマンドを使って問い合わせまたはストアドプロシージャを実行します。プロバイダが Execute コマンドをデータセットに渡すと，データセットは，カーソルを返さない問い合わせまたはストアドプロシージャの実行コマンドを使用します。