FireDAC.Comp.Script.TFDScript.ExecuteStep

提供:RAD Studio API Documentation

Delphi

function ExecuteStep(AParser: TFDScriptParser): Boolean; overload;
function ExecuteStep: Boolean; overload;

C++

bool __fastcall ExecuteStep(TFDScriptParser* AParser)/* overload */;
bool __fastcall ExecuteStep()/* overload */;

プロパティ

種類 可視性 ソース ユニット 親
function public
FireDAC.Comp.Script.pas
FireDAC.Comp.Script.hpp
FireDAC.Comp.Script TFDScript

説明

次のコマンドを SQL スクリプトから抜き出して実行します。


ExecuteStep メソッドを呼び出すと、次のコマンドを SQL スクリプトから抜き出して実行できます。

SQL スクリプトが SQLScript コレクションに格納されている場合、コマンドの抜き出しは SQL スクリプトの Position 位置から始まります。SQL スクリプトがファイルに保存されている場合、コマンドの抜き出しはファイル ストリームの現在位置から始まります。

コマンドの実行後、現在位置は、処理されたコマンドの後に現れる最初のシンボルに移動します。スクリプトが SQLScript に格納されている場合は、Position プロパティが更新されます。スクリプトがファイルに保存されている場合は、ファイル ストリームの位置が更新されます。

IgnoreError が False になっていて、スクリプト コマンドの実行で例外が発生した場合、この例外はメソッドの外部に伝播されます。

コマンドの実行前には、BeforeExecute イベント ハンドラが呼び出されます。実行完了後には、AfterExecute イベント ハンドラが呼び出されます。サブスクリプト呼び出しが検出された場合、そのサブスクリプトは ExecuteStep メソッドで実行されます。

例

 FDScript1.Position := Memo1.CaretPos;
 FDScript1.ExecuteStep;
 Memo1.CaretPos := FDScript1.Position;

関連項目