FireDAC.Comp.Client.TFDCustomConnection.ExecSQLScalar

提供: RAD Studio API Documentation
移動先: 案内検索

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

プロパティ

種類 可視性 ソース ユニット
function public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomConnection

説明

SQL コマンドを実行します。


ExecSQLScalar は、最初の結果セットの第 1 行、第 1 列の値を返します。

ExecSQL メソッドは、以下のようにオーバーロード(多重定義)されています。

  • 1 番目のオーバーロード メソッドは、パラメータなしの SQL コマンドを実行します。それ以外のカーソルはすべて破棄されます。ASQL パラメータは、実行する SQL コマンドを表わします。
  • 2 番目のオーバーロード メソッドは、パラメータのある SQL コマンドを実行します。それ以外のカーソルはすべて破棄されます。AParams パラメータはパラメータ値のオープン配列を表します。
  • 3 番目のオーバーロード メソッドは、パラメータのある SQL コマンドを実行します。それ以外のカーソルはすべて破棄されます。このメソッドではパラメータの型を明示的に指定できます。パラメータの型を指定しないですむようにするには、ATypes の対応項目が ftUnknown である必要があります。

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

関連項目