OdbcDatabaseOpen
value OdbcDatabaseOpen ( string strDSN, value BYREF dxDatabase, value bExclusive = FALSE, value bReadOnly = FALSE );
Rückgabewert
Null wenn die Verbindung erfolgreich hergestellt wurde, ansonsten eine Fehlernummer. Mit OdbcGetLastError kann dann eine genaue Fehlerbeschreibung ausgelesen werden.
Parameter
strDSN
Der Name der eingerichteten ODBC-Datenquelle, die geöffnet werden soll.
dxDatabase
Wurde die Datenquelle erfolgreich geöffnet, so wird dxDatabase mit einem Verweis auf die geöffnete Datenquelle geladen. Nachfolgenden OdbcDatabase-Funktionsaufrufen, die sich auf diese Datenquelle beziehen, muss dieses Datenbankobjekt übergeben werden.
bExclusive
TRUE |
Die Datenquelle wird für Exclusivzugriff geöffnet. |
FALSE |
Die Datenquelle kann auch von anderen geöffnet werden (shared access). |
bReadOnly
TRUE |
Die Datenquelle wird schreib geschützt geöffnet. |
FALSE |
Die Datenquelle wird mit Lese- und Schreibzugriff geöffnet. |
Bemerkung
Stellt eine Verbindung zu einer eingerichteten ODBC-Datenquelle her. In der Systemsteuerung können unter "System und Sicherheit", dort unter "Verwaltung", "Datenquellen (ODBC)" eingerichtet und gewartet werden.
Wird die Datenquelle nicht mehr benötigt, so ist diese mit OdbcDatabaseClose zu schließen. Victory schließt alle offenen Datenbank automatisch, sobald die Anwendung gestoppt bzw. beendet wird.
Allgemeine Erläuterungen zur ODBC-Anbindung siehe hier.
Beispiel
//Öffnet die Datenquelle meine_datenbank und erzeugt eine Tabelle innerhalb dieser Datenbank. Tritt ein Fehler auf, so wird der entsprechende Fehlertext in strLastError gespeichert.
value dxDatabase;
string strLastError;
if (! OdbcDatabaseOpen ("meine_datenbank", dxDatabase))
if (OdbcDatabaseExecute (dxDatabase, "CREATE TABLE IF NOT EXISTS meldungen (DatumUhrzeit DATETIME, Meldetext TEXT)"))
OdbcGetLastError (strLastError);
end
OdbcDatebaseClose (dxDatabase);
else
OdbcGetLastError (strLastError);
end
Siehe auch OdbcDatabaseActivateAnsiToUTF8, OdbcDatabaseClose, OdbcDatabaseExecute, OdbcDatabaseExport, OdbcDatabaseQuery, OdbcDatabaseIsOpen, OdbcDatabaseOpenEx, OdbcGetLastError, OdbcDatabaseMySqlOpen, OdbcDatabaseMySqlCreate