FireDAC.Comp.Script.TFDScript.SQLScripts

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property SQLScripts: TFDSQLScripts read FSQLScripts write SetSQLScripts;

C++

__property TFDSQLScripts* SQLScripts = {read=FSQLScripts, write=SetSQLScripts};

Propriétés

Type Visibilité  Source Unité  Parent
property published
FireDAC.Comp.Script.pas
FireDAC.Comp.Script.hpp
FireDAC.Comp.Script TFDScript

Description

La collection des scripts SQL.

Utilisez la propriété SQLScripts pour stocker et gérer des scripts SQL dans la mémoire de l'application, plutôt que dans les fichiers OS externes.

Chaque élément de la collection comporte la propriété Name, identifiant un script, et la propriété SQL, contenant un script. Un script peut être référencé par son nom. L'élément avec l'index zéro est le script principal (racine) et l'exécution commence à partir de celui-ci.

Le mécanisme de chargement d'un script SQL peut être redéfini en utilisant le gestionnaire d'événement OnGetText. Il est également possible de soumettre un script SQL à partir d'un fichier OS externe en utilisant la propriété SQLScriptFileName. La propriété SQLScriptFileName a une priorité supérieure à la propriété SQLScripts.

Notez que les méthodes ExecuteFile et ExecuteScript effacent le contenu SQLScripts existant.

Exemple

 with FDScript1.SQLScripts do begin
   Clear;
   with Add do begin
     Name := 'root';
     SQL.Add('@first');  // explicitly call 'first' script
     SQL.Add('@second'); // explicitly call 'second' script
   end;
   with Add do begin
     Name := 'first';
     SQL.Add('create table t1 (...);');
     SQL.Add('create table t2 (...);');
   end;
   with Add do begin
     Name := 'second';
     SQL.Add('create procedure p1 (...);');
     SQL.Add('create procedure p2 (...);');
   end;
 end;
 FDScript1.ValidateAll;
 FDScript1.ExecuteAll;

Voir aussi