FireDAC.Comp.Client.TFDCustomCommand.Execute
Delphi
procedure Execute(ATimes: Integer = 0; AOffset: Integer = 0; ABlocked: Boolean = False); overload;
function Execute(const ASQL: String): LongInt; overload;
function Execute(const ASQL: String; const AParams: array of Variant): LongInt; overload;
function Execute(const ASQL: String; const AParams: array of Variant; const ATypes: array of TFieldType): LongInt; overload;
C++
void __fastcall Execute(int ATimes = 0x0, int AOffset = 0x0, bool ABlocked = false)/* overload */;
int __fastcall Execute(const System::UnicodeString ASQL)/* overload */;
int __fastcall Execute(const System::UnicodeString ASQL, const System::Variant *AParams, const int AParams_High)/* overload */;
int __fastcall Execute(const System::UnicodeString ASQL, const System::Variant *AParams, const int AParams_High, const Data::Db::TFieldType *ATypes, const int ATypes_High)/* overload */;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomCommand |
Beschreibung
Führt die SQL-Anweisung aus.
Die Methode Execute ist überladen:
- Die erste überladene Methode führt die in CommandText angegebene SQL-Anweisung aus, die keine Ergebnismengen zurückgibt. Wenn die Anweisung Ergebnismengen zurückgibt, dann werden alle verworfen. Die Anweisung kann in einem der folgenden Modi ausgeführt werden:
|
Modus |
Parameterwerte |
Bedeutung |
|---|---|---|
|
Standard oder Vorgabe. Die SQL-Anweisung wird nur einmal ausgeführt. |
|
Die Anzahl der von der SQL-Anweisung betroffenen Zeilen (eingefügt, aktualisiert, gelöscht usw.). Diese Information wird vom DBMS bereitgestellt und von FireDAC nicht "überprüft". |
|
Array DML. |
|
Die Anzahl der erfolgreichen Anweisungsausführungen für jedes Element des Parameter-Arrays. Eine detaillierte Beschreibung finden Sie unter Array DML. |
- Die zweite überladene Methode führt die im Parameter
ASQLangegebene SQL-Anweisung aus, die keine Ergebnismengen zurückgibt. Wenn die Anweisung Ergebnismengen zurückgibt, dann werden alle verworfen. - Die dritte überladene Methode führt die im Parameter
ASQLangegebene parametrisierte SQL-Anweisung aus, die keine Ergebnismengen zurückgibt. Wenn die Anweisung Ergebnismengen zurückgibt, dann werden alle verworfen. Der ParameterAParamsrepräsentiert das offene Array der Parameterwerte, die in der Reihenfolge des Vorkommens im Text der SQL-Anweisung zugewiesen werden. - Die vierte überladene Methode führt die im Parameter
ASQLangegebene parametrisierte SQL-Anweisung aus, die keine Ergebnismengen zurückgibt. Wenn die Anweisung Ergebnismengen zurückgibt, dann werden alle verworfen. Für die Methode müssen die Datentypen der Parameter angegeben werden. Der ParameterAParamsrepräsentiert das offene Array der Parameterwerte, die in der Reihenfolge des Vorkommens im Text der SQL-Anweisung zugewiesen werden. Der ParameterATypesrepräsentiert ein offenes Array der Parameterdatentypen.
Beispiel
//First overloaded method
ADCommand1.CommandText.Text := 'create table MyTab (f1 number, f2 varchar2(10))';
ADCommand1.Execute;
//Second overloaded method
ADCommand1.Execute('DROP TABLE MyTab');
//Third overloaded method
ADCommand1.Execute('delete from MyTab where id = : id', [100]);\
//Fourth overloaded method
ADCommand1.Execute('insert into MyTab (id, bval) values (:id, :bval)', [100, StringOfChar('x', 100000)], [ftInteger, ftBLOB]);