Оператор Imports (пространство имен .NET и тип)

Позволяет обращаться к именам типов без уточнения пространства имен.

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

Части

Заметки

Оператор Imports разрешает непосредственно ссылаться на типы, содержащиеся в заданном пространстве имен.

Можно указать имя одного пространства имен или строку из вложенных пространств имен. Каждое вложенное пространство имен отделяется от следующего пространства имен более высокого уровня точкой (.), как показано в следующем примере.

Imports System.Collections.Generic

Каждый исходный файл может содержать любое количество операторов Imports. Они должны следовать за любым параметром объявления, таким как инструкция Option Strict, и они должны предшествовать любому объявлению элементов программированию, например инструкциям Module или Class.

Можно использовать Imports только на уровне файла. Это означает, что контекст объявления для импорта должен быть исходным файлом и не может быть пространством имен, классом, структурой, модулем, интерфейсом, процедурой или блоком.

Обратите внимание, что оператор Imports не разрешает текущему проекту получать доступ к элементам других проектов и сборок. Импорт не принимает в качестве параметра ссылку. Он только избавляет от необходимости квалификации имен, которые уже доступны проекту. Дополнительные сведения содержатся в разделе "Импорт содержащих элементов" в Ссылки на объявленные элементы (Visual Basic).

Импорт псевдонимов

Псевдоним импорта определяет псевдоним для типа или пространства имен. Псевдонимы применяются, когда необходимо использовать элементы с одинаковыми именами, объявленные в одном или нескольких пространствах имен. Дополнительные сведения и примеры см. в подразделе "Уточнение имени элемента" раздела Ссылки на объявленные элементы (Visual Basic).

Нельзя объявлять элемент на уровне модуля с именем, совпадающим с aliasname. Если это сделать, то компилятор Visual Basic воспримет aliasname только для объявленного элемента и больше не распознает его как псевдоним импорта.

Хотя синтаксис, используемый для объявления псевдонима импорта, такой же как используемый для импорта префикса пространства имен XML, результаты отличаются. Псевдоним импорта может использоваться как выражение в коде, тогда как префикс пространства имен XML можно использовать только в XML-литералах или свойствах XML-оси как префикс для элемента или имени атрибута.

Имена элементов

Если указать element, он должен представлять container element, который является элементом программирования, содержащим другие элементы. К элементам контейнера относятся классы, структуры, модули, интерфейсы и перечисления.

Область элементов, доступных с помощью оператора Imports, зависит от того, определяется ли element. Если задано только namespace, то все члены и члены элементов контейнера этого пространства имен с уникальными именами в пределах этого пространства имен доступны без уточнения. Если указать вместе namespace и element, без уточнения доступны только члены этого элемента.

Пример

В следующем примере возвращаются все папки в папке C:\ с помощью классаDirectoryInfo.

В коде нет операторов Imports в начале файла. Таким образом ссылки DirectoryInfo StringBuilderи CrLf являются полными, с пространствами имен.

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

Следующий пример включает оператор Imports для пространств имен, на которые стоит ссылка. Таким образом типы не обязательно должны быть полными, с пространствами имен.

' 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

Следующий пример включает операторы Imports, создающие псевдонимы для пространств имен, на которые стоит ссылка. Типы дополняются псевдонимами.

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

Следующий пример включает операторы Imports, создающие псевдонимы для типов, на которые стоит ссылка. Псевдонимы используются для указания типов.

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

См. также

Ссылки

Библиотека классов .NET Framework

Оператор Namespace

Оператор Imports (пространство имен XML)

Основные понятия

Пространства имен в Visual Basic

Ссылки и оператор Imports (Visual Basic)

Другие ресурсы

Ссылки на объявленные элементы (Visual Basic)

Журнал изменений