Importuje příkaz (.NET oboru názvů a typ)

Článek
04/10/2013

Umožňuje zadat názvy odkazovat bez kvalifikace v oboru názvů.

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

Části

Termín	Definice
aliasname	Nepovinné.Alias importu nebo název, kterým kód může odkazovat na namespace namísto řetězce úplnou kvalifikaci.Viz téma Deklarovaný názvy prvků (Visual Basic).
namespace	Povinné.Plně kvalifikovaný název importovaného oboru názvů.Mohou být řetězec oborů názvů vnořené na jakékoli úrovni.
element	Nepovinné.Název programovací element deklarované v oboru názvů.Může být libovolný prvek kontejneru.

Poznámky

Imports Prohlášení umožňuje typy, které jsou obsaženy v daném oboru názvů přímo odkazovat.

Můžete zadat název jednoho oboru názvů nebo řetězec vnořené obory názvů.Každý vnořený oboru názvů je oddělena z další vyšší úrovně oboru názvů období (.), jak ukazuje následující příklad.

Imports System.Collections.Generic

Každý zdrojový soubor může obsahovat libovolný počet Imports příkazy.Tyto postupujte jakékoli prohlášení možnost Option Strict prohlášení a musí předcházet všechny deklarace programování prvků jako Module nebo Class příkazy.

Můžete použít Imports pouze na úrovni souboru.To znamená kontextu prohlášení pro dovoz musí být zdrojový soubor a nemůže být obor názvů, třídy, struktury, modul, rozhraní, postup nebo bloku.

Všimněte si, že Imports prohlášení o zpřístupnění prvků z jiných projektů a sestavení projektu.Import neuskuteční nastavení odkaz.Pouze odstraní nutnost kvalifikovat názvy, které jsou k dispozici v projektu.Další informace naleznete v tématu "Import obsahující prvků" v Odkazy na prvky deklarované (Visual Basic).

[!POZNÁMKA]

Můžete definovat implicitní Imports pomocí příkazů Odkazy na stránce projektu Designer (Visual Basic).Další informace naleznete v tématu Jak: Přidat nebo odebrat importovány obory názvů (Visual Basic).

Import aliasů

Alias importu definuje obor názvů nebo typ alias.Import aliasů jsou užitečné k použití položek se stejným názvem, který jsou deklarovány v jedné nebo více oborů názvů.Další informace a příklad viz "Opravňujících prvku název" v Odkazy na prvky deklarované (Visual Basic).

By nebyla deklarovat člen na úrovni modulu se stejným názvem jako aliasname.Pokud tak učiníte, kompilátor Visual Basic používá aliasname pouze pro člena deklarovaného a nadále rozpoznává jako alias importu.

Přestože pro předponu oboru názvů XML import jako toto použití syntaxe pro deklarování alias importu, jsou různé výsledky.Alias importu lze použít jako výraz v kódu, že předponu oboru názvů XML lze použít pouze v XML literály nebo vlastnosti XML osy jako předponu kvalifikovaný prvek nebo atribut názvu.

Názvy prvků

Zadáte-li element, musí představovat prvek kontejneru, je programovací element, který může obsahovat další prvky.Prvky kontejneru patří třídy, struktury, moduly, rozhraní a vyčíslení.

Prvky k dispozici v rozsahu Imports prohlášení závisí zda zadáte element.Pokud zadáte pouze namespace, všechny jednoznačně s názvem členové daného oboru názvů a prvky kontejneru v rámci daného oboru názvů, jsou k dispozici bez kvalifikace.Pokud zadáte i namespace a element, pouze jsou-li k dispozici bez kvalifikace členů tohoto prvku.

Příklad

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

Kód nemá žádné Imports příkazy na začátku souboru.Proto DirectoryInfo, StringBuilder, a CrLf jsou odkazy na všechny 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

Následující příklad obsahuje Imports příkazy pro odkazované obory názvů.Typy proto nemusí být úplný 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

Následující příklad obsahuje Imports příkazy, které vytvořila aliasy pro odkazované obory názvů.Typy jsou kvalifikovaní 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

Následující příklad obsahuje Imports příkazy, které vytvořila 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