Freigeben über

SET LIBRARY-Befehl

  • Artikel

Öffnet eine externe API-Bibliotheksdatei (API = Application Programming Interface).

SET LIBRARY TO [FileName [ADDITIVE]]

Parameter

  • FileName
    Gibt den Dateinamen der zu öffnenden API-Bibliothek oder Prozedurdatei an.

    Visual FoxPro erwartet bei Bibliotheken die Dateinamenerweiterung FLL. Wenn der Name der Bibliotheksdatei die Dateinamenerweiterung FLL besitzt, brauchen Sie diese nicht mit dem Dateinamen anzugeben. Besitzt eine Bibliothek dagegen eine andere Erweiterung als FLL, müssen Sie die entsprechende Erweiterung mit dem Dateinamen angeben.

    Vorsicht   Beachten Sie die folgenden Punkte bei der Verwendung von SET LIBRARY:

    • API-Bibliotheken, die für eine bestimmte Plattform erstellt wurden, können nicht auf einer anderen Plattform verwendet werden. So lassen sich beispielsweise mit FoxPro für MS-DOS erstellte Bibliotheken nicht in Visual FoxPro verwenden. Umgekehrt können mit Visual FoxPro erstellte Bibliotheken nicht in FoxPro für MS-DOS verwendet werden.
    • API-Bibliotheken, die für eine bestimmte Version erstellt wurden, können nicht in einer anderen Version verwendet werden. Sie können beispielsweise Bibliotheken, die für FoxPro, Version 2.6, erstellt wurden, nicht in Visual FoxPro verwenden. Sie müssen neu kompiliert und gebunden werden.

    Visual FoxPro erwartet bei einer Prozedurdatei die Erweiterung PRG.

    Wenn Sie eine Prozedur mit DO ProcedureName ausführen, sucht Visual FoxPro nach der Prozedur in folgenden Dateien und in der angegebenen Reihenfolge:

    • In der Datei, die den Befehl DO ProcedureName enthält.
    • In einer mit SET PROCEDURE geöffneten Prozedurdatei (falls eine solche vorhanden ist).
    • In den Programmen der Ausführungsfolge. Visual FoxPro durchsucht Programmdateien, beginnend mit dem zuletzt ausgeführten Programm, bis hin zu dem Programm, das als Erstes ausgeführt wurde.
    • In einer mit SET LIBRARY geöffneten Prozedurdatei (falls eine solche vorhanden ist).
    • In einer eigenständigen Programmdatei. Wenn Visual FoxPro eine Programmdatei mit demselben Namen wie die durch DO angegebene Datei findet, wird das entsprechende Programm ausgeführt. Wird keine Programmdatei mit übereinstimmendem Namen gefunden, generiert Visual FoxPro eine Fehlermeldung.

  • ADDITIVE
    Öffnet zusätzliche API-Bibliotheken. Geben Sie ADDITIVE in aufeinander folgenden SET LIBRARY-Befehlen jeweils nach dem Dateinamen an.

    Visual FoxPro ignoriert ADDITIVE, wenn Sie eine Prozedurdatei mit SET LIBRARY öffnen.

Hinweise

Mit SET LIBRARY können Sie externe API-Bibliotheken oder eine Prozedurdatei öffnen.

Bibliotheken mit API-Routinen erweitern die Fähigkeiten der Sprache und Benutzeroberfläche von Visual FoxPro. Nach dem Öffnen einer externen API-Bibliothek können Sie die API-Funktionen genau wie Visual FoxPro-Funktionen verwenden. Die in der Bibliothek zur Verfügung stehenden Funktionen können mit DISPLAY STATUS oder LIST STATUS angezeigt werden.

Sie können bereits vorhandene API-Bibliotheken verwenden oder Ihre eigenen API-Bibliotheken erstellen.

Die in Visual FoxPro bevorzugte Art der Anmeldung von DLL-Funktionen ist die Verwendung des DECLARE - DLL-Befehls.

Verwenden Sie SET LIBRARY TO ohne FileName oder ADDITIVE, um alle API-Bibliotheken aus dem Arbeitsspeicher zu entfernen. Eine einzelne Bibliothek können Sie mit RELEASE LIBRARY LibraryName aus dem Arbeitsspeicher entfernen.

Bei Angabe einer Prozedurdatei stehen die darin enthaltenen Prozeduren allen Programmen und auch interaktiv über das Befehlsfenster zur Verfügung.

Anmerkung   Die Fähigkeit von Visual FoxPro, eine Prozedurdatei mit SET LIBRARY zu öffnen, ermöglicht die Kompatibilität mit dBASE IV. Durch das Öffnen einer Prozedurdatei mit SET LIBRARY werden alle geöffneten API-Bibliotheken geschlossen. Durch das Öffnen von API-Bibliotheken mit SET LIBRARY wird eine mit SET LIBRARY geöffnete Prozedurdatei geschlossen. Mit SET PROCEDURE können Sie eine Prozedurdatei öffnen und gleichzeitig das Schließen der API-Bibliotheken verhindern.

Weitere Informationen zu Prozedurdateien finden Sie unter PROCEDURE und SET PROCEDURE.

Siehe auch

CALL | DISPLAY STATUS | LIST | LOAD | RELEASE