FireDAC.Comp.Client.TFDRdbmsDataSet.Prepare
Delphi
procedure Prepare;
C++
void __fastcall Prepare();
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDRdbmsDataSet |
説明
実行できるよう SQL コマンドを準備します。
Prepare メソッドを呼び出すと、実行できるよう SQL コマンドを準備することができます。標準の SQL コマンドの場合、実行前に Prepare を呼び出す必要はありません。最初に Execute/ExecSQL/Open を呼び出したときに自動的にコマンドの準備が行われるからです。ただし、ストアド プロシージャで Params コレクションの内容を自動的に設定する必要がある場合には、これを呼び出さなければなりません。コマンドの準備が済むと、SQLText によって、DBMS に送信される SQL コマンド テキストが返されます。
SQL コマンドの準備をするには、DBMS 接続がアクティブになっている必要があります。アクティブでなければ例外が発生します。
Prepare を呼び出した後、アプリケーションでコマンド パラメータのデータ型やサイズを変更することはできません。変更してしまうと、次に Execute/ExecSQL/ExecProc/Open を呼び出したときに例外が発生します。Prepare を呼び出す前にパラメータをセットアップしておくことをお勧めします。
例
FDQuery1.SQL.Text := 'select * from MyTab';
FDQuery1.Prepare;