Afficher : Object Pascal C++
Préférences d'affichage

FireDAC.Comp.Client.TFDCustomConnection.ExecSQL

De Appmethod Libraries

Object Pascal

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, System::Variant const *AParams, const int AParams_High)/* overload */;
int __fastcall ExecSQL(const System::UnicodeString ASQL, System::Variant const *AParams, const int AParams_High, Data::Db::TFieldType const *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

Outils personnels
Traductions