ADATABASES( )-Funktion

Artikel
04/01/2008

Schreibt die Namen aller geöffneten Datenbanken sowie deren Pfade in ein Array.

ADATABASES(ArrayName)

Rückgabewerte

Numerisch

Parameter

ArrayName
Gibt den Namen des Arrays an. Wenn das angegebene Array nicht vorhanden ist, wird es von Visual FoxPro automatisch erstellt. Ist das Array zwar vorhanden, aber nicht groß genug, um alle Datenbankinformationen aufnehmen zu können, passt Visual FoxPro die Größe des Arrays automatisch entsprechend an. Ist das Array größer als notwendig, wird es abgeschnitten. Für den Fall, dass das Array zwar vorhanden ist, ADATABASES( ) aber 0 zurückgibt, weil keine Datenbank geöffnet ist, bleibt das vorhandene Array unverändert. Ist das Array nicht vorhanden und gibt ADATABASES( ) den Wert 0 zurück, wird das Array nicht erstellt.

Hinweise

In das angegebene Array werden die Namen aller Datenbanken geschrieben, die in der aktuellen Datensitzung geöffnet sind.

ADATABASES( ) erstellt ein zweidimensionales Array. Die erste Spalte enthält die Namen der geöffneten Datenbanken, die zweite Spalte enthält die Pfade zu den Datenbanken.

ADATABASES( ) gibt die Anzahl der im Array gespeicherten Datenbanknamen (Zeilen) zurück. Wenn keine Datenbank geöffnet ist, gibt ADATABASES( ) den Wert 0 zurück, und das Array wird nicht erstellt.

Beispiel

Im folgenden Beispiel wird die Datenbank testdata geöffnet; anschließend wird ADATABASES( ) zum Erstellen eines Arrays mit Namen gaDatabase verwendet, das die Namen aller offenen Datenbanken enthält.

SET PATH TO (HOME(2) + 'data\')     && Sets path to database
OPEN DATABASE testdata && Opens the database
CLEAR
? ADATABASES(gaDatabase)     && Creates an array of open databases
DISPLAY MEMORY LIKE gadatabase  && Displays the contents of the array
CLOSE DATABASES

Siehe auch

CREATE DATABASE | DISPLAY DATABASE | LIST DATABASE | MODIFY DATABASE | OPEN DATABASE

Freigeben über