FireDAC.Comp.Client.TFDCustomConnection.ExecSQL

• Aller au parent : TFDCustomConnection

Delphi

function ExecSQL(const ASQL: String; AIgnoreObjNotExists: Boolean = False): LongInt; overload;
function ExecSQL(const ASQL: String; const AParams: array of Variant): LongInt; overload;
function ExecSQL(const ASQL: String; const AParams: array of Variant;  const ATypes: array of TFieldType): LongInt; overload;
function ExecSQL(const ASQL: String; AParams: TFDParams): LongInt; overload;
function ExecSQL(const ASQL: String; AParams: TFDParams; var AResultSet: TDataSet): LongInt; overload;
function ExecSQL(const ASQL: String; var AResultSet: TDataSet): LongInt; overload;

C++

int __fastcall ExecSQL(const System::UnicodeString ASQL, bool AIgnoreObjNotExists = false)/* overload */;
int __fastcall ExecSQL(const System::UnicodeString ASQL, const System::Variant *AParams, const int AParams_High)/* overload */;
int __fastcall ExecSQL(const System::UnicodeString ASQL, const System::Variant *AParams, const int AParams_High, const Data::Db::TFieldType *ATypes, const int ATypes_High)/* overload */;
int __fastcall ExecSQL(const System::UnicodeString ASQL, Firedac::Stan::Param::TFDParams* AParams)/* overload */;
int __fastcall ExecSQL(const System::UnicodeString ASQL, Firedac::Stan::Param::TFDParams* AParams, Data::Db::TDataSet* &AResultSet)/* overload */;
int __fastcall ExecSQL(const System::UnicodeString ASQL, Data::Db::TDataSet* &AResultSet)/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp	FireDAC.Comp.Client	TFDCustomConnection

Description

Exécute une commande SQL et renvoie le nombre de lignes affectées.

ExecSQL accepte certaines combinaisons des paramètres suivants :

• ASQL est une chaîne contenant l'instruction SQL que vous souhaitez exécuter.
• AResultSet est une instance de TDataSet que ExecSQL remplit avec les données renvoyées par le système de gestion de base de données en guise de réponse à votre instruction SQL.
• AParams est soit un tableau de variants, soit une instance de TFDParams ayant spécifié un ou plusieurs paramètres pour remplir l'instruction SQL spécifiée.
• ATypes est un tableau de types de champ qui indique les types des paramètres spécifiés. Utilisez ftUnknown si vous ne voulez pas spécifier le type d'un certain paramètre.
• AIgnoreObjNotExists détermine si ExecSQL doit ignorer (masquer) les exceptions "l'objet n'existe pas" (True) ou non (False). Cette méthode est utile, par exemple, lorsque vous exécutez des instructions DROP sur des systèmes de gestion des bases de données qui ne prennent pas en charge la syntaxe DROP IF EXISTS. Les signatures dans lesquelles vous ne pouvez pas spécifier une valeur pour AIgnoreObjNotExists propagent toutes les exceptions.

Exemple

FDConnection1.ExecSQL('truncate table tab1');
FDConnection1.ExecSQL('drop table tab2', True);
FDConnection1.ExecSQL('delete from mytab where id > :p1', [1000]);
FDConnection1.ExecSQL('update mytab where id = :p1 set blobfld = :blb',
  [1000, StringOfChar('x', 100000)], [ftInteger, ftBLOB]);

Voir aussi

• Exécution des commandes
• FireDAC.Comp.Client.TFDQuery