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