SqliteQuery

value SqliteQuery ( value dxSqlite, string strSqlSelect, string/value BYREF varToBind... );

Rückgabewert

Rückgabewert

Beschreibung

0

Die Abfrage wurde erfolgreich durchgeführt.

-1

Entweder ist beim Ausführen der Abfrage ein Fehler aufgetreten oder es konnte für die Abfrage kein passender Datensatz gefunden werden.

Der Fehlertext kann mit SqliteGetLastError ausgelesen werden..

Parameter

dxSqlite

Das erfolgreich geöffnete SQLite Datenbank-Objekt, an dem die Abfrage durchgeführt werden soll.

strSqlSelect

Eine SQL-Abfrage, die angibt, welches Result/e varToBind enthalten soll.

varToBind

Die Variable/n, an die die Werte der entsprechenden Felder übergeben werden sollen. Die Bindung erfolgt von links nach rechts der Ergebnisfelder des SQL-Select Anweisung.

Bemerkung

Führt eine Abfrage in der SQLite Datenbank dxSqlite entsprechend der SQL-Anweisung strSqlSelect durch und liefert den Inhalt des ersten Datensatzes der Abfrage in die Übergabeparameter varToBind.

Diese Funktion dient dazu Datensatzabfragen mit nur einem Befehl auszuführen, bei denen das Ergebnis entweder in nur einer Datensatzzeile enthalten ist oder nur der Inhalt des ersten gefundenen Datensatz ausgelesen werden soll. Sie ersetzt somit eine komplette SqliteQueryOpen-SqliteQueryNext-SqliteQueryClose Folge.

Beispiele


if (SqliteDatabaseOpen(dxSqlite, "c:\data.sqlite"))
    return (SqliteGetLastError(strLastSqliteError));
end
value totalCount = 0;

//Liest die Anzahl der vorhanden Datensätze der Tabelle 'DoneOrders'
SqliteQuery(dxSqlite, "select count(*) from DoneOrders", totalCount);
 

Siehe auch SqliteDatabaseOpen, SqliteDatabaseClose, SqliteExecute, SqliteQueryOpen, SqliteQueryNext, SqliteQueryGetValue, SqliteQueryClose, SqliteGetLastError