FireDAC.Comp.Client.TFDCustomConnection.ExecSQL
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. UtilisezftUnknown
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 instructionsDROP
sur des systèmes de gestion des bases de données qui ne prennent pas en charge la syntaxeDROP IF EXISTS
. Les signatures dans lesquelles vous ne pouvez pas spécifier une valeur pourAIgnoreObjNotExists
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]);