Freigeben über


Verweise und die Imports-Anweisung (Visual Basic)

Sie können externe Objekte für Ihr Projekt verfügbar machen, indem Sie im Menü Projekt den Befehl Verweis hinzufügen auswählen. Verweise in Visual Basic können auf Assemblys zeigen, die Typbibliotheken ähneln, aber mehr Informationen enthalten.

Die Imports-Anweisung

Assemblys enthalten mindestens einen Namespace. Wenn Sie einer Assembly einen Verweis hinzufügen, können Sie auch einem Modul eine Imports-Anweisung hinzufügen, die die Sichtbarkeit der Namespaces dieser Assembly innerhalb des Moduls steuert. Die Imports-Anweisung stellt einen Bereichskontext bereit, in dem Sie nur den Teil des Namespace verwenden können, der zum Bereitstellen eines eindeutigen Verweises erforderlich ist.

Die Imports-Anweisung weist die folgende Syntax auf:

Imports [Aliasname =] Namespace

Aliasname bezieht sich auf einen Kurznamen, den Sie im Code verwenden können, um auf einen importierten Namespace zu verweisen. Namespace ist ein Namespace, der über einen Projektverweis, eine Definition innerhalb des Projekts oder eine vorherige Imports-Anweisung verfügbar ist.

Ein Modul kann eine beliebige Anzahl von Imports-Anweisungen enthalten. Sie müssen nach allen Option-Anweisungen, sofern vorhanden, aber vor jeglichem anderen Code stehen.

Hinweis

Verwechseln Sie Projektverweise nicht mit den Anweisungen Imports oder Declare. Projektverweise machen externe Objekte, z. B. Objekte in Assemblys, für Visual Basic-Projekte verfügbar. Die Imports-Anweisung wird verwendet, um den Zugriff auf Projektverweise zu vereinfachen, bietet jedoch selbst keinen Zugriff auf diese Objekte. Die Declare-Anweisung wird verwendet, um einen Verweis auf eine externe Prozedur in einer Dynamic Link Library (DLL) zu deklarieren.

Verwenden von Aliasen mit der Imports-Anweisung

Die Imports-Anweisung erleichtert den Zugriff auf Methoden von Klassen, da nicht explizit die vollqualifizierten Namen von Verweisen eingegeben werden müssen. Aliase ermöglichen es Ihnen, nur einem Teil eines Namespaces einen benutzerfreundlicheren Namen zuzuweisen. Beispielsweise ist die Wagenrücklauf-/Zeilenvorschubsequenz, die bewirkt, dass ein einzelner Textabschnitt in mehreren Zeilen angezeigt wird, Teil des Moduls ControlChars im Namespace Microsoft.VisualBasic. Um diese Konstante in einem Programm ohne Alias zu verwenden, müssen Sie den folgenden Code eingeben:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

Imports-Anweisungen müssen immer die ersten Zeilen sein, die unmittelbar auf Option-Anweisungen in einem Modul folgen. Das folgende Codefragment zeigt, wie Sie einen Alias importieren und dem Modul Microsoft.VisualBasic.ControlChars zuweisen:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Zukünftige Verweise auf diesen Namespace können erheblich kürzer sein:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

Wenn eine Imports-Anweisung keinen Aliasnamen enthält, können im importierten Namespace definierte Elemente ohne Qualifizierung im Modul verwendet werden. Wenn der Aliasname angegeben ist, muss er als Qualifizierer für Namen verwendet werden, die in diesem Namespace enthalten sind.

Siehe auch