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

  • Článek

Umožňuje odkazovat na názvy typů bez kvalifikace oboru názvů.

Syntaxe

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

Součástky

Pojem definice
aliasname Nepovinné. Alias nebo název importu, podle kterého může kód odkazovat namespace místo řetězce úplné kvalifikace. Viz Deklarované názvy elementů.
namespace Povinný: Plně kvalifikovaný název importovaného oboru názvů. Může to být řetězec oborů názvů vnořených na libovolnou úroveň.
element Nepovinné. Název programovacího prvku deklarovaného v oboru názvů. Může to být libovolný element kontejneru.

Poznámky

Příkaz Imports umožňuje přímé odkazy na typy obsažené v daném oboru názvů.

Můžete zadat jeden název oboru názvů nebo řetězec vnořených oborů názvů. Každý vnořený obor názvů je oddělený od dalšího oboru názvů vyšší úrovně tečkou (.), jak ukazuje následující příklad:

Imports System.Collections.Generic

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

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

Všimněte si, že příkaz Imports nedává prvky z jiných projektů a sestavení k dispozici pro váš projekt. Při importu se nenastaví odkaz. Odebere jenom potřebu kvalifikovat názvy, které jsou pro váš projekt již k dispozici. Další informace naleznete v části Import obsahující prvky v odkazech na deklarované elementy.

Poznámka:

Implicitní Imports příkazy můžete definovat pomocí stránky Reference, Návrhář projektu (Visual Basic). Další informace naleznete v tématu Postupy: Přidání nebo odebrání importovaných oborů názvů (Visual Basic).

Import aliasů

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

Člena byste neměli deklarovat na úrovni modulu se stejným názvem jako aliasname. Pokud to uděláte, kompilátor jazyka Visual Basic používá aliasname pouze pro deklarovaného člena a už ho nerozpozná jako alias importu.

I když se syntaxe použitá k deklarování aliasu importu podobá importu 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 ve vlastnostech literálů XML nebo osy XML jako předpona pro kvalifikovaný název elementu nebo atributu.

Názvy elementů

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

Rozsah prvků zpřístupněných příkazem Imports závisí na tom, zda zadáte element. Pokud zadáte pouze namespace, všechny jedinečně pojmenované členy tohoto oboru názvů a členy elementů kontejneru v rámci tohoto oboru názvů jsou k dispozici bez kvalifikace. Pokud zadáte oba namespace i element, jsou 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 nemá v horní části souboru žádné Imports příkazy. Proto , a CrLf odkazy DirectoryInfoStringBuilderjsou 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é s 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 kvalifikované pomocí aliasů.

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é vytvářejí aliasy pro odkazované typy. Aliasy se používají 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é