FireDAC.Comp.Client.TFDCustomConnection.ExecSQLScalar

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomConnection

Beschreibung

Führt eine SQL-Anweisung aus.

ExecSQLScalar gibt den Wert der ersten Spalte in der ersten Zeile der ersten Ergebnismenge zurück.

Die Methode ExecSQL ist überladen:

  • Die erste überladene Methode führt eine SQL-Anweisung ohne Parameter aus. Alle anderen Cursors werden verworfen. Der Parameter ASQL repräsentiert die auszuführende SQL-Anweisung.
  • Die zweite überladene Methode führt eine SQL-Anweisung mit Parametern aus. Alle anderen Cursors werden verworfen. Der Parameter AParams repräsentiert ein offenes Array mit Parameterwerten.
  • Die dritte überladene Methode führt eine SQL-Anweisung mit Parametern aus. Alle anderen Cursors werden verworfen. Die Methode ermöglicht die explizite Angabe von Parametertypen. Wenn der Typ eines Parameters nicht angegeben werden muss, dann muss der zugehörige Eintrag in ATypesftUnknown lauten.

Beispiel

 
 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]);

Siehe auch