Freigeben über

Imports-Anweisung (.NET-Namespace und -Typ)

Ermöglicht das Verweisen auf Typnamen ohne Namespacequalifizierung.

Syntax

Imports [ aliasname = ] namespace
' -or-
Imports [ aliasname = ] namespace.element

Bestandteile

Begriff Definition
aliasname Wahlfrei. Ein Importalias oder Name, auf den Code anstelle der vollständigen Qualifizierungszeichenfolge verweisen namespace kann. Siehe deklarierte Elementnamen.
namespace Erforderlich. Der vollqualifizierte Name des zu importierenden Namespaces. Dies kann eine Zeichenfolge von Namespaces sein, die auf einer beliebigen Ebene geschachtelt sind.
element Wahlfrei. Der Name eines im Namespace deklarierten Programmierelements. Kann ein beliebiges Containerelement sein.

Bemerkungen

Mit der Imports Anweisung können Typen, die in einem bestimmten Namespace enthalten sind, direkt referenziert werden.

Sie können einen einzelnen Namespacenamen oder eine Zeichenfolge geschachtelter Namespaces angeben. Jeder geschachtelte Namespace wird durch einen Punkt (.) vom nächsten Namespace auf höherer Ebene getrennt, wie im folgenden Beispiel dargestellt:

Imports System.Collections.Generic

Jede Quelldatei kann eine beliebige Anzahl von Imports Anweisungen enthalten. Diese müssen allen Optionsdeklarationen folgen, z. B. der Option Strict Anweisung, und sie müssen vor Programmierelementdeklarationen, wie z Module . B. Anweisungen Class , vorausgehen.

Sie können nur auf Dateiebene verwenden Imports . Dies bedeutet, dass der Deklarationskontext für den Import eine Quelldatei sein muss und kein Namespace, eine Klasse, eine Struktur, ein Modul, eine Schnittstelle, eine Prozedur oder ein Block sein kann.

Beachten Sie, dass die Imports Anweisung keine Elemente aus anderen Projekten und Assemblys für Ihr Projekt zur Verfügung stellt. Das Importieren erfolgt nicht an der Stelle des Festlegens eines Verweises. Es entfernt nur die Notwendigkeit, Namen zu qualifizieren, die bereits für Ihr Projekt verfügbar sind. Weitere Informationen finden Sie unter "Importieren von enthaltenden Elementen" in Verweisen auf deklarierte Elemente.

Hinweis

Sie können implizite Imports Anweisungen mithilfe der Seite "Verweise", Project Designer (Visual Basic) definieren. Weitere Informationen finden Sie unter How to: Add or Remove Imported Namespaces (Visual Basic).For more information, see How to: Add or Remove Imported Namespaces (Visual Basic).

Aliase importieren

Ein Importalias definiert den Alias für einen Namespace oder Typ. Importaliasen sind nützlich, wenn Sie Elemente mit demselben Namen verwenden müssen, der in einem oder mehreren Namespaces deklariert ist. Weitere Informationen und ein Beispiel finden Sie unter "Qualifizieren eines Elementnamens" in Verweisen auf deklarierte Elemente.

Sie sollten kein Element auf Modulebene mit demselben Namen aliasnamewie . Wenn Sie dies tun, verwendet aliasname der Visual Basic-Compiler nur für das deklarierte Element und erkennt es nicht mehr als Importalias.

Obwohl die zum Deklarieren eines Importalias verwendete Syntax dem Importieren eines XML-Namespacepräfix entspricht, unterscheiden sich die Ergebnisse. Ein Importalias kann als Ausdruck im Code verwendet werden, während ein XML-Namespacepräfix nur in XML-Literalen oder XML-Achseneigenschaften als Präfix für ein qualifiziertes Element oder attributname verwendet werden kann.

Elementnamen

Wenn Sie angeben element, muss es ein Containerelement darstellen, d. h. ein Programmierelement, das andere Elemente enthalten kann. Containerelemente umfassen Klassen, Strukturen, Module, Schnittstellen und Enumerationen.

Der Umfang der von einer Imports Anweisung verfügbar gemachten Elemente hängt davon ab, ob Sie angeben element. Wenn Sie nur namespaceangeben, sind alle eindeutig benannten Member dieses Namespaces und Member von Containerelementen innerhalb dieses Namespaces ohne Qualifikation verfügbar. Wenn Sie sowohl als auch namespaceelementangeben, sind nur die Member dieses Elements ohne Qualifikation verfügbar.

Beispiel 1

Im folgenden Beispiel werden alle Ordner im Verzeichnis C:\ mithilfe der DirectoryInfo Klasse zurückgegeben:

Der Code hat keine Imports Anweisungen am Anfang der Datei. Daher sind die DirectoryInfo, StringBuilderund CrLf Verweise alle mit den Namespaces voll qualifiziert.

Public Function GetFolders() As String
    ' Create a new StringBuilder, which is used
    ' to efficiently build strings.
    Dim sb As New System.Text.StringBuilder

    Dim dInfo As New System.IO.DirectoryInfo("c:\")

    ' Obtain an array of directories, and iterate through
    ' the array.
    For Each dir As System.IO.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(Microsoft.VisualBasic.ControlChars.CrLf)
    Next

    Return sb.ToString
End Function

Beispiel 2

Das folgende Beispiel enthält Imports Anweisungen für die referenzierten Namespaces. Daher müssen die Typen nicht vollständig mit den Namespaces qualifiziert werden.

' Place Imports statements at the top of your program.
Imports System.Text
Imports System.IO
Imports Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String
    Dim sb As New StringBuilder

    Dim dInfo As New DirectoryInfo("c:\")
    For Each dir As DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(CrLf)
    Next

    Return sb.ToString
End Function

Beispiel 3

Das folgende Beispiel enthält Imports Anweisungen, die Aliase für die referenzierten Namespaces erstellen. Die Typen werden mit den Aliasen qualifiziert.

Imports systxt = System.Text
Imports sysio = System.IO
Imports ch = Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String
    Dim sb As New systxt.StringBuilder

    Dim dInfo As New sysio.DirectoryInfo("c:\")
    For Each dir As sysio.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ch.CrLf)
    Next

    Return sb.ToString
End Function

Beispiel 4

Das folgende Beispiel enthält Imports Anweisungen, die Aliase für die referenzierten Typen erstellen. Aliase werden verwendet, um die Typen anzugeben.

Imports strbld = System.Text.StringBuilder
Imports dirinf = System.IO.DirectoryInfo

Public Function GetFolders() As String
    Dim sb As New strbld

    Dim dInfo As New dirinf("c:\")
    For Each dir As dirinf In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ControlChars.CrLf)
    Next

    Return sb.ToString
End Function

Siehe auch

  • Last updated on