Data.SqlExpr.TSQLDataSet.ExecSQL

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ExecSQL(ExecDirect: Boolean = False): Integer; override;

C++

virtual int __fastcall ExecSQL(bool ExecDirect = false);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TSQLDataSet

Beschreibung

Führt eine Abfrage oder Stored Procedure aus, die keine Ergebnismenge zurückgibt.

Mit ExecSQL führen Sie SQL-Anweisungen aus, die keine Ergebnismenge zurückgeben. Solche Anweisungen sind z.B. INSERT, UPDATE, DELETE oder CREATE TABLE, nicht jedoch SELECT.

Der Parameter ExecDirect gibt an, ob die Abfrage vor der Ausführung vorbereitet werden soll. Wenn die Abfrage keine Parameter enthält, kann ExecDirect auf true gesetzt werden. Bei false wird die Abfrage vor der Ausführung vorbereitet. Auch in diesem Fall können Sie verhindern, dass die Abfrage bei jedem Aufruf von ExecSQL vorbereitet wird, indem Sie die Eigenschaft Prepared vor dem ersten Aufruf auf true setzen.

ExecSQL gibt die Anzahl der Datensätze zurück, auf die mit der letzten Anweisung zugegriffen wurde. Dieser Wert wird auch der Eigenschaft RowsAffected zugewiesen.

Anmerkung:  Verwenden Sie ExecSQL nicht für Anweisungen, die Daten zurückgeben. Dazu gehören alle Anweisungen vom Typ ctTable, SELECT-Abfragen und Stored Procedures, die einen Cursor zurückgeben. Wenn eine Anweisung Daten zurückgibt, verwenden Sie die Methode Open, oder setzen Sie die Eigenschaft Active auf true.

Siehe auch