Verweise und die Imports-Anweisung

Aktualisiert: November 2007

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 verweist einen Kurznamen, der wieerum im Code auf einen importierten Namespace verweist. Namespace ist ein Namespace, der über eine Projektreferenz, eine Definition im Projekt oder über eine vorherige Imports-Anweisung verfügbar ist.

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.

Hinweis:

Verwechseln Sie Projektverweise nicht mit der Imports-Anweisung oder der Declare-Anweisung. Mit Projektverweisen werden externe Objekte, z. B. Objekte in Assemblys, in Visual Basic-Projekte eingebunden. 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-Modul (Visual Basic)-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 in Visual Studio (Visual Basic)

Gewusst wie: Erstellen und Verwenden von Assemblys

Konzepte

Namespaces in Visual Basic

Assemblys

Referenz

Imports-Anweisung (.NET-Namespace und Typ)

ControlChars-Modul (Visual Basic)

Microsoft.VisualBasic

Weitere Ressourcen

Änderungen in der Programmiersprache für Visual Basic 6.0-Benutzer