FireDAC.Comp.Script.TFDScript.ExecuteStep

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
FireDAC.Comp.Script.pas
FireDAC.Comp.Script.hpp
FireDAC.Comp.Script TFDScript


Description

Extrait et exécute la prochaine commande du script SQL.

Appelez la méthode ExecuteStep pour extraire et exécuter la prochaine commande du script SQL.

L'extraction commence à partir de la position Position dans le script SQL, si le script SQL est stocké dans la collection SQLScript. Si le script SQL est stocké dans un fichier, l'extraction commence à partir de la position en cours dans un flux de fichier.

Après l'exécution d'une commande, la position en cours est expédiée au premier symbole après la commande traitée. Si un script est stocké dans SQLScript, la propriété Position est mise à jour. Si un script est stocké dans un fichier, la position du flux de fichier est mise à jour.

Si l'exécution de la commande de script a déclenché une exception et que IgnoreError vaut False, cette exception est propagée en dehors de la méthode.

Avant l'exécution, le gestionnaire d’événement BeforeExecute est appelé. Après la fin de l'exécution, le gestionnaire d'événement AfterExecute est appelé. Si l'appel d'un sous-script est rencontré, le sous-script est exécuté par la méthode ExecuteStep.

Exemple

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

Voir aussi