Freigeben über

Verweise und die Imports-Anweisung (Visual Basic)

Sie können ihrem Projekt externe Objekte zur Verfügung stellen, indem Sie im Menü Projekt den Befehl "Verweis hinzufügen" auswählen. Verweise in Visual Basic können auf Assemblys verweisen, die wie Typbibliotheken sind, aber weitere Informationen enthalten.

Die Imports-Anweisung

Assemblys enthalten mindestens einen Namespace. Wenn Sie einem Assembly einen Verweis hinzufügen, können Sie einem Modul auch eine Imports Anweisung hinzufügen, die die Sichtbarkeit der Namespaces dieser Assembly innerhalb des Moduls steuert. Die Imports Anweisung stellt einen Bereichskontext bereit, mit dem Sie nur den Teil des Namespaces 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 kurzen Namen, den Sie im Code verwenden können, um auf einen importierten Namespace zu verweisen. Namespace ist ein Namespace, der entweder über einen Projektverweis, über eine Definition innerhalb des Projekts oder über 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 der Imports Anweisung oder der Declare Anweisung. Projektverweise stellen externe Objekte, z. B. Objekte in Assemblys, für Visual Basic-Projekte zur Verfügung. Die Imports Anweisung wird verwendet, um den Zugriff auf Projektverweise zu vereinfachen, bietet jedoch 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 die vollqualifizierten Namen von Referenzen nicht explizit 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 zum Microsoft.VisualBasic.ControlChars Modul importieren und 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 elemente, die im importierten Namespace definiert sind, im Modul ohne Qualifikation verwendet werden. Wenn der Aliasname angegeben ist, muss er als Qualifizierer für Namen verwendet werden, die in diesem Namespace enthalten sind.

Siehe auch