Поделиться через

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

  • Статья

Обновлен: Ноябрь 2007

Импорт пространства имен или элементов программирования, определенных в текущем проекте или в указанном проекте и сборке.

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

Компоненты

  • aliasname
    Необязателен. import alias или имя, по которому код может обращаться к namespace вместо использования полной строки. См. раздел Имена объявленных элементов.

  • namespace
    Обязательный параметр. Полное имя пространства имен импортируемого. Может быть строкой пространства имен, вложенного на любом уровне.

  • element
    Необязательно. Имя элемента программирования, объявленное в пространстве имен. Может быть любым элементом контейнера.

Заметки

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

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

Псевдонимы применяются, когда необходимо использовать элементы с одинаковыми именами, объявленные в одном или нескольких пространствах имен. Дополнительные сведения и примеры содержатся в "Классы с одинаковыми именами" в Разрешение ссылки, когда несколько переменных имеют одинаковые имена.

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

7f38zh8x.alert_note(ru-ru,VS.90).gifПримечание.

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

Правила

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

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

    Imports System.Collections.Generic

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

Поведение

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

  • Квалификация. Код за пределами пространства имен или элемента контейнера должен обычно квалифицировать имена члена этого пространства имен элемента контейнера. Оператор Imports делает подобное квалификацию необязательной, если проект имеет доступ к другому члену с тем же именем. В таком случае можно указать aliasname в каждом операторе Imports. Затем необходимо только импортировать псевдонимы для квалификации членов с одинаковыми именами.

Пример

В следующем примере импортируется класс Microsoft.VisualBasic.Strings и присваивается псевдоним str, который может быть использован для доступа к методу Left.

' Place Imports statements at the top of your program.
Imports str = Microsoft.VisualBasic.Strings

Class testClass1
    Sub showHello()
        ' Display only the word "Hello"
        MsgBox(str.Left("Hello World", 5))
    End Sub
End Class

Обратите внимание, что в предыдущем примере импортируется вложенное пространство имен Strings в VisualBasic в Microsoft. При доступе Функция MsgBox (Visual Basic) к методу Left можно использовать псевдоним str вместо полной строки Microsoft.VisualBasic.Strings.

См. также

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

Знакомство с библиотекой классов .NET Framework в Visual Studio

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

Ссылки

Оператор "Namespace"

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

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

Visual Basic и .NET Framework