FireDAC.Comp.Client.TFDCustomConnection.ExecSQLScalar

• Aller au parent : TFDCustomConnection

Delphi

function ExecSQLScalar(const ASQL: String): Variant; overload;
function ExecSQLScalar(const ASQL: String; const AParams: array of Variant): Variant; overload;
function ExecSQLScalar(const ASQL: String; const AParams: array of Variant;
const ATypes: array of TFieldType): Variant; overload;

C++

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

ExecSQLScalar renvoie la valeur de la première colonne dans la première ligne du premier ensemble de résultats.

La méthode ExecSQL est surchargée :

• La première méthode surchargée exécute une commande SQL sans paramètres. Tous les autres curseurs sont ignorés. Le paramètre ASQL représente la commande SQL à exécuter.
• La deuxième méthode surchargée exécute une commande SQL avec des paramètres. Tous les autres curseurs sont ignorés. Le paramètre AParams représente un tableau ouvert de valeurs de paramètres.
• La troisième méthode surchargée exécute une commande SQL avec des paramètres. Tous les autres curseurs sont ignorés. La méthode vous permet de spécifier explicitement les types de paramètres. S'il n'est pas nécessaire de spécifier le type d'un paramètre, l'élément correspondant dans ATypes doit alors être ftUnknown.

Exemple

 var
   sVersion: String;
   sName: String;
   sName2: String;
 ...
   sVersion := FDConnection1.ExecSQLScalar('select @@version');
   sName := FDConnection1.ExecSQLScalar('select name from {id Employees} where id = :id', [100]);
   sName2 := FDConnection1.ExecSQLScalar('select name from {id Employees} where id = :id', [100], [ftLargeInt]);

Voir aussi

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