Przywóz instrukcji (.Obszar nazw netto i typ)

Artykuł
04/10/2013

Pozwala wpisać nazwy, aby odwoływać się bez kwalifikacji nazw.

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

Części

Termin	Definicja
aliasname	Opcjonalne.Alias importowania lub nazwa, według której kod może odwoływać się do namespace zamiast ciągu pełnej kwalifikacji.See Nazwy elementów deklarowanej (Visual Basic).
namespace	Wymagane.Pełna nazwa obszaru nazw, które są przywożone.Może być ciągiem nazw zagnieżdżone na dowolnym poziomie.
element	Opcjonalne.Nazwa elementu programowania zadeklarowane w obszarze nazw.Może być dowolny element kontenera.

Uwagi

Imports Instrukcji umożliwia typów, które są zawarte w danym obszarze nazw, aby odwoływać się bezpośrednio.

Można podać nazwę pojedynczy obszar nazw lub ciąg zagnieżdżonych nazw.Każdy zagnieżdżonych nazw jest oddzielona od następny wyższy poziom obszaru nazw przez okres (.), jak przedstawiono w następującym przykładzie.

Imports System.Collections.Generic

Każdy plik źródłowy może zawierać dowolną liczbę Imports instrukcji.Te należy wykonać wszelkie deklaracje opcji, takich jak Option Strict instrukcji i one musi poprzedzać deklaracje elementów programowania, takich jak Module lub Class instrukcji.

Można użyć Imports tylko na poziomie pliku.Oznacza to, kontekst deklaracji dla przywozu musi być plikiem źródłowym i nie może być obszaru nazw, klasy, struktury, moduł, interfejs, procedury lub bloku.

Należy zauważyć, że Imports instrukcja nie udostępnia elementów z innych projektów i zespołów do projektu.Importowanie nie ma miejsce odwołanie ustawienia.Powoduje tylko usunięcie potrzebę kwalifikują się do nazw, które są już dostępne w projekcie.Aby uzyskać więcej informacji, zobacz "Importowanie elementów zawierających" w Odniesienia do zadeklarowanych elementów (Visual Basic).

[!UWAGA]

Można zdefiniować niejawny Imports sprawozdania za pomocą Odwołania do strony, Project Designer (Visual Basic).Aby uzyskać więcej informacji, zobacz Jak: Dodawanie lub usuwanie importowane obszary nazw (Visual Basic).

Aliasy importu

Alias importowania alias dla obszaru nazw lub typ definiuje.Aliasy importu są przydatne, gdy trzeba użyć elementów o tej samej nazwie, zadeklarowany w jeden lub więcej obszarów nazw.Na przykład i uzyskać więcej informacji, zobacz "Kwalifikujących się nazwa elementu" w Odniesienia do zadeklarowanych elementów (Visual Basic).

Nie należy zadeklarować Członkowskich na poziomie modułu z taką samą nazwę jak aliasname.Jeśli to zrobisz, kompilator języka Visual Basic używa aliasname tylko dla deklarowanych członka i nie będą dłużej rozpozna, że przywóz alias.

Mimo że składnia używana do deklarowania alias przywozu tak jest używany do importowania prefiks obszaru nazw XML, wyniki są różne.Alias importu może służyć jako wyrażenie w kodzie, prefiks obszaru nazw XML, który można stosować tylko w literały XML lub właściwości osi XML jako prefiks dla elementu kwalifikowaną lub nazwa atrybutu.

Nazwy elementów

Jeśli podasz element, musi reprezentować elementu-kontenera, to znaczy programowania element, który może zawierać inne elementy.Kontenery zawiera klasy, struktury, modułów, interfejsów i wyliczenia.

Zakres elementów, udostępnione przez Imports instrukcji zależy od tego, czy określić element.Jeśli określisz tylko namespace, wszystkie jednoznacznie nazwane członkami tego obszaru nazw i członków elementów kontenera w obrębie tego obszaru nazw, są dostępne bez kwalifikacji.Jeśli określisz zarówno namespace i element, tylko członkowie tego elementu są dostępne bez kwalifikacji.

Przykład

W przykładzie poniżej są zwracane wszystkie foldery w katalogu C:\ za pomocą DirectoryInfo klasy.

Nie ma kodu Imports sprawozdań na początku pliku.W związku z tym DirectoryInfo, StringBuilder, i CrLf odwołania są wszystkie pełną z obszarów nazw.

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

Poniższy przykład zawiera Imports instrukcje dla nazw, do którego istnieje odwołanie.W związku z tym typy nie być w pełni kwalifikowana z obszarów nazw.

' 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

Poniższy przykład zawiera Imports instrukcji, które utworzył aliasy dla nazw, do którego istnieje odwołanie.Typy są poprzedzone 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

Poniższy przykład zawiera Imports instrukcji, które utworzył aliasy dla wskazanych typów.Aliasy są używane do określania typów.

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