DatabaseQuery()

Syntax

Ergebnis = DatabaseQuery(#Datenbank, Abfrage$)

Führt eine SQL-Abfrage (englisch "SQL query") in der angegebenen Datenbank aus.

Parameter

#Datenbank	Gibt die zu verwendende Datenbank an.
Abfrage$	Gibt die auszuführende Abfrage an.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Abfrage erfolgreich war, oder Null wenn sie fehlgeschlagen ist (wegen eines SQL-Fehlers oder einer falsch formatierten Abfrage).

Anmerkungen

Wenn die Abfrage erfolgreich war, dann kann NextDatabaseRow() zum Auflisten der Einträge (englisch "Records") verwendet werden (siehe Beispiel unten). Im Falle eines Fehlers kann der Fehlertext mittels DatabaseError() ermittelt werden. Es ist sicher NextDatabaseRow() zu verwenden, auch wenn die Abfrage keine Einträge zurückgibt. Um eine Abfrage auszuführen, die keine Einträge zurückliefert, verwenden Sie DatabaseUpdate() anstelle von DatabaseQuery().

Sobald die Abfrage-Resultate nicht mehr benötigt werden, muss FinishDatabaseQuery() aufgerufen werden, um alle Abfrage-Ressourcen freizugeben.

Beispiel

  ; Zuerst stellen wir eine Verbindung zu der 'employee' (Angestellten) Tabelle her
  ;
  If DatabaseQuery(#DatenBank, "SELECT * FROM employee")  ; Ermittelt alle Einträge in der 'employee' Tabelle

    While NextDatabaseRow(#Datenbank)   ; alle Einträge durchlaufen
      Debug GetDatabaseString(#Datenbank, 0)  ; Inhalt vom ersten Feld anzeigen
    Wend

    FinishDatabaseQuery(#Datenbank)
  Else
    MessageRequester("Fehler", "Kann die folgende Abfrage nicht ausführen: "+DatabaseError())
  EndIf

Siehe auch

DatabaseUpdate(), NextDatabaseRow()

Unterstützte OS

Alle