Imports – příkaz (obor názvů a typ rozhraní .NET)

Povoluje odkazování na názvy typů bez kvalifikace oboru názvů.

Syntax

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

Součásti

Poznámky

ImportsPříkaz umožňuje, aby typy, které jsou obsaženy v daném oboru názvů, odkazovaly přímo.

Můžete dodat jeden název oboru názvů nebo řetězec pro vnořené obory názvů. Všechny vnořené obory názvů jsou oddělené od dalšího oboru názvů vyšší úrovně o periodu ( . ), jak ukazuje následující příklad:

Imports System.Collections.Generic

Každý zdrojový soubor může obsahovat libovolný počet Imports příkazů. Ty musí následovat po deklaracích možností, jako je například Option Strict příkaz, a musí předcházet deklaraci všech programovacích prvků, jako jsou například Module Class příkazy nebo.

Můžete použít Imports pouze na úrovni souboru. To znamená, že kontext deklarace pro import musí být zdrojový soubor a nemůže být obor názvů, třída, struktura, modul, rozhraní, procedura nebo blok.

Všimněte si, že Imports příkaz nezpřístupňuje prvky z jiných projektů a sestavení, která jsou k dispozici pro váš projekt. Import nebere v úvahu místo nastavení odkazu. Pouze odebere nutnost kvalifikovat názvy, které jsou již k dispozici pro váš projekt. Další informace naleznete v tématu "Import obsahující prvky" v odkazech na deklarované elementy.

Importovat aliasy

Alias importu definuje alias pro obor názvů nebo typ. Importovat aliasy jsou užitečné v případě, že potřebujete použít položky se stejným názvem, které jsou deklarovány v jednom nebo více oborech názvů. Další informace a příklad naleznete v tématu "získání názvu elementu" v odkazech na deklarované elementy.

Člena byste neměli deklarovat na úrovni modulu se stejným názvem jako aliasname . v případě, Visual Basic kompilátor používá aliasname pouze pro deklarovaný člen a již jej nerozezná jako alias importu.

I když syntaxe použitá pro deklarování aliasu importu je stejná jako ta, která se používá pro import předpony oboru názvů XML, výsledky se liší. Alias importu lze použít jako výraz v kódu, zatímco předponu oboru názvů XML lze použít pouze v literálech XML nebo ve vlastnostech osy XML jako předponu pro kvalifikovaný element nebo název atributu.

Názvy elementů

Pokud zadáte element , musí reprezentovat prvek kontejneru, to znamená, že programovací prvek, který může obsahovat další prvky. Prvky kontejneru zahrnují třídy, struktury, moduly, rozhraní a výčty.

Rozsah prvků, které jsou k dispozici Imports příkazem, závisí na tom, zda zadáte element . Pokud zadáte pouze namespace , budou k dispozici všechny jedinečně pojmenované členy tohoto oboru názvů a členy prvků kontejneru v rámci tohoto oboru názvů, a to bez kvalifikace. Pokud zadáte obojí namespace a element , budou k dispozici pouze členové tohoto prvku bez kvalifikace.

Příklad 1

Následující příklad vrátí všechny složky v adresáři C: \ pomocí DirectoryInfo třídy:

Kód neobsahuje žádné Imports příkazy v horní části souboru. Proto DirectoryInfo StringBuilder CrLf jsou odkazy, a plně kvalifikované s obory názvů.

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

Příklad 2

Následující příklad obsahuje Imports příkazy pro odkazované obory názvů. Proto nemusí být typy plně kvalifikované pro obory názvů.

' 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

Příklad 3

Následující příklad obsahuje Imports příkazy, které vytvářejí aliasy pro odkazované obory názvů. Typy jsou kvalifikovány s aliasy.

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

Příklad 4

Následující příklad obsahuje Imports příkazy, které vytvoří aliasy pro odkazované typy. Aliasy slouží k určení typů.

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

Viz také

• Namespace – příkaz
• Obory názvů v jazyce Visual Basic
• Odkazy a příkaz Imports
• Imports – Příkaz (obor názvů XML)
• Odkazy na deklarované elementy