Verweise und die Imports-Anweisung (Visual Basic)
Mit dem Befehl Verweis hinzufügen aus dem Menü Projekt lassen sich externe Objekte in das Projekt einbinden.Verweise in Visual Basic können auf Assemblys zeigen, die mit Typbibliotheken vergleichbar sind, jedoch mehr Informationen enthalten.
Die Imports-Anweisung
Assemblys umfassen einen oder mehrere Namespaces.Wenn Sie einen Verweis auf eine Assembly anlegen, können Sie auch eine Imports-Anweisung zu einem Modul hinzufügen, die die Sichtbarkeit der Namespaces innerhalb des Moduls steuert.Die Imports-Anweisung stellt einen Kontextbereich bereit, in dem Sie gezielt den Teil des Namespaces nutzen können, der zur Erstellung eines eindeutigen Verweises nötig ist.
Die Imports-Anweisung hat die folgende Syntax:
Imports [|Aliasname =] Namespace
Aliasname steht für einen kurzen Namen, den Sie innerhalb des Codes verwenden können, um auf einen importierten Namespace zu verweisen.Namespace ist ein Namespace, der entweder durch einen Projektverweis, durch eine Definition innerhalb des Projekts oder durch eine vorangehende Imports-Anweisung verfügbar gemacht wird.
Ein Modul kann beliebig viele Imports-Anweisungen enthalten.Wenn vorhanden, müssen sie nach den Option-Anweisungen, aber vor jeglichem anderen Code aufgeführt werden.
.gif "Hinweis") Hinweis |
|---|
Verwechseln Sie Projektverweise nicht mit der Imports-Anweisung oder der Declare-Anweisung.Mit Projektverweisen werden externe Objekte, z. B. Objekte in Assemblys, für Visual Basic-Projekte verfügbar gemacht.Die Imports-Anweisung erleichtert zwar den Zugriff auf Projektverweise, stellt jedoch keinen Zugriff auf diese Objekte selbst bereit.Mit der Declare-Anweisung wird ein Verweis auf eine externe Prozedur in einer Dynamic Link Library (DLL) deklariert. |
Verwenden von Aliasen mit der Imports-Anweisung
Die Imports-Anweisung erleichtert den Zugriff auf Methoden in Klassen, denn sie macht die explizite Eingabe des vollgekennzeichneten Namens eines Verweises überflüssig.Mit Aliasen können Sie bestimmten Teilen des Namespaces einen eingängigeren Namen zuweisen.So ist z. B. die Sequenz für Wagenrücklauf/Zeilenvorschub, die die Anzeige eines einzelnen Textelements in mehreren Zeilen bewirkt, Teil der ControlChars-Klasse im Microsoft.VisualBasic-Namespace.Ohne Alias müssten Sie folgenden Code eingeben, um diese Konstante in einem Programm zu verwenden:
MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
"Some more text")
Imports-Anweisungen müssen in einem Modul immer in den unmittelbar auf die Option-Anweisungen folgenden Zeilen stehen.Das folgende Codefragment zeigt, wie ein Alias für das Microsoft.VisualBasic.ControlChars-Modul importiert und zugewiesen wird:
Imports CtrlChrs = Microsoft.VisualBasic.ControlChars
Zukünftige Verweise auf diesen Namespace fallen dann wesentlich kürzer aus:
MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")
Wenn eine Imports-Anweisung keinen Aliasnamen enthält, können im importierten Namespace definierte Elemente ohne Angabe des Namespacenamens im Modul verwendet werden.Wenn ein Aliasname angegeben ist, müssen Namen innerhalb des betreffenden Namespaces mit ihm qualifiziert werden.
Siehe auch
Aufgaben
Gewusst wie: Hinzufügen oder Entfernen von Verweisen mithilfe des Dialogfelds "Verweise hinzufügen"
Gewusst wie: Erstellen und Verwenden von Assemblys über die Befehlszeile (C# und Visual Basic)
Referenz
Imports-Anweisung (.NET-Namespace und Typ)
Konzepte
Assemblys und der globale Assemblycache (C# und Visual Basic)