Bde.DBTables.TDatabase.Execute
Delphi
function Execute(const SQL: string; Params: TParams = nil;
Cache: Boolean = False; Cursor: phDBICur = nil): Integer;
C++
int __fastcall Execute(const System::UnicodeString SQL, Data::Db::TParams* Params = (Data::Db::TParams*)(0x0), bool Cache = false, Bde::phDBICur Cursor = (Bde::phDBICur)(0x0));
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TDatabase |
Beschreibung
Führt eine SQL-Anweisung aus.
Mit Execute wird eine SQL-Anweisung für eine Datenmenge ausgeführt, ohne dass dafür ein TQuery-Objekt erforderlich ist. Execute unterstützt DDL (Data Definition Language) SQL-Anweisungen und solche DML (Data Manipulation Language) SQL-Anweisungen, die keine Ergebnismengen zurückliefern. Zu den DDL-Anweisungen zählen beispielsweise: CREATE INDEX, ALTER TABLE und DROP DOMAIN. DML-Anweisungen, die Aktionen mit Daten ausführen, aber keine Ergebnismengen liefern, gehören: INSERT, DELETE und UPDATE.
SQL ist ein String-Wert, der die auszuführende Anweisung enthält.
Params ist ein Wert vom Typ TParams und führt die von der SQL-Anweisung verwendeten Parameter auf. Die Parameter werden nur anhand des Indizes (nicht anhand des Namens) gebunden. Die Reihenfolge der TParam-Objekte in Params muss mit der Reihenfolge der Parameter in der SQL-Anweisung identisch sein. Mit der Methode TParams.CreateParam erzeugen Sie ein TParams-Objekt für jeden Parameter der SQL-Anweisung. Konfigurieren Sie mithilfe der Eigenschaften und Methoden von TParams alle TParam-Objekte und weisen Sie allen Parametern vor dem Aufruf von Execute einen Wert zu. Bei einer SQL-Anweisung ohne Parameter übergeben Sie für Params den Wert nil (Delphi) bzw. NULL (C++).
Cache legt fest, ob die vorbereitete SQL-Anweisung zwischengespeichert wird, damit sie in der aktuellen Transaktion erneut verwendet werden kann. Das Zwischenspeichern von Anweisungen kann deren Verarbeitungsgeschwindigkeit beim wiederholten Einsatz in einer Transaktion erhöhen.
Cursor ermöglicht die Ausführung einer SELECT-Anweisung und das Erstellen einer BDE-Datenmenge (Borland Database Engine). Wenn SQL eine SELECT-Anweisung ist, gibt Cursor den BDE-Cursor auf die Ergebnismenge zurück. Cursor ist ein Zeiger auf einen bereits vorhandenen BDE-Cursor. Gegenwärtig gibt es in der VCL keine Möglichkeit, den durch diesem Parameter erzeugten Cursor einer Datenmengenkomponenten (wie etwa TTable) zuzuweisen. Daher ist dieser Parameter auf aufeinanderfolgende Cursor im BDE API-Code beschränkt. Die in Cursor zurückgegebene Ergebnismenge ist immer schreibgeschützt. Bei einer SQL-Anweisung ohne Parameter übergeben Sie für Params den Wert nil (Delphi) bzw. NULL (C++).
Execute gibt die Anzahl der Datensätze zurück, auf die mit der SQL-Anweisung zugegriffen wurde.