FireDAC.Comp.Client.TFDRdbmsDataSet.Prepared
Delphi
property Prepared: Boolean read GetPrepared write SetPrepared stored IsPS default False;
C++
__property bool Prepared = {read=GetPrepared, write=SetPrepared, stored=IsPS, default=0};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
property | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDRdbmsDataSet |
説明
コマンドの実行準備ができたかどうかの状態を取得/設定します。
実行できるよう SQL コマンドを準備するには、Prepared を True に設定します。Prepared を True に設定すると、Prepare メソッドが呼び出されます。標準の SQL コマンドの場合、実行前に Prepared を True に設定する必要はありません。最初に Execute/ExecSQL/Open を呼び出したときに自動的にコマンドの準備が行われるからです。ただし、ストアド プロシージャで Params コレクションの内容を自動的に設定する必要がある場合には、このプロパティを設定しなければなりません。コマンドの準備が済むと、SQLText によって、DBMS に送信される SQL コマンド テキストが返されます。
SQL コマンドの準備をするには、DBMS 接続がアクティブになっている必要があります。アクティブでなければ例外が発生します。
SQL コマンドの準備が済んだ後、アプリケーションでコマンド パラメータのデータ型やサイズを変更することはできません。変更してしまうと、次に Execute や Open を呼び出したときに例外が発生します。そのため、パラメータのセットアップは Prepared を True に設定する前に行ってください。
SQL コマンドを準備解除してすべてのリソースを解放するには、Prepared を False に設定します。Prepared を False に設定すると、Unprepare メソッドが呼び出されます。