Data.SqlExpr.TSQLConnection.Execute
Delphi
function Execute(const SQL: string; Params: TParams): Integer; overload;
function Execute(const SQL: string; Params: TParams; var ResultSet: TDataSet): Integer; overload;
function Execute(const SQL: string; Params: TParams; ResultSet: Pointer): Integer; overload; deprecated 'Use overloaded method instead';
C++
int __fastcall Execute(const System::UnicodeString SQL, Data::Db::TParams* Params)/* overload */;
int __fastcall Execute(const System::UnicodeString SQL, Data::Db::TParams* Params, Data::Db::TDataSet* &ResultSet)/* overload */;
int __fastcall Execute _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (const System::UnicodeString SQL, Data::Db::TParams* Params, void * ResultSet)/* overload */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | TSQLConnection |
Beschreibung
Führt auf dem Server eine SQL-Anweisung aus.
Mit Execute können Sie auf dem Server eine bestimmte Anweisung ausführen, ohne dafür eine SQL-Datenmenge zu benötigen. Die Methode Execute eignet sich besonders für Anweisungen, die keine Ergebnismenge zurückgeben (z.B. Anweisungen in einer Datendefinitionssprache).
SQL ist die auszuführende Anweisung.
Params ist ein TParams-Objekt, das alle von der Anweisung verwendeten Parameter enthält. Da die Parameterbindung nicht über den Namen, sondern über den Index stattfindet, ist die Reihenfolge der Parameter von Bedeutung. Die Reihenfolge der TParam-Objekte in Params entspricht der Reihenfolge der Parameter in der SQL-Anweisung. Mit den Eigenschaften und Methoden von TParams können Sie TParams-Objekte erstellen, für jeden Parameter ein solches Objekt hinzufügen und Parametereigenschaften wie den Datentyp und den Wert festlegen. Bei einer SQL-Anweisung ohne Parameter übergeben Sie für Params den Wert nil (Delphi) bzw. NULL (C++).
ResultSet ist ein Zeiger auf eine Variable vom Typ TCustomSQLDataSet*. Wenn die SQL-Anweisung einen Cursor zurückgibt, erstellt Execute eine neue TCustomSQLDataSet-Instanz und weist ihr die Ergebnismenge zu. Auf diese TCustomSQLDataSet-Instanz zeigt der Parameter ResultSet. Wenn die SQL-Anweisung keine Ergebnismenge zurückgibt, übergeben Sie für ResultSet den Wert nil (Delphi) bzw. NULL (C++). TPSResult wird für nativen Quelltext auf Pointer und für verwalteten Code auf TObject gesetzt.
Execute gibt die Anzahl der Datensätze zurück, auf die mit der SQL-Anweisung zugegriffen wurde.
Tip: Verwenden Sie für SQL-Anweisungen ohne Parameter die Methode ExecuteDirect.