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

Внешние объекты можно сделать доступными для проекта, выбрав в меню Проект команду Добавить ссылку.Ссылки в Visual Basic могут указывать на сборки, которые подобны библиотекам типов, но содержат больше сведений.

Оператор Imports

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

Оператор Imports имеет следующий синтаксис:

Imports [|Aliasname =] Namespace

Aliasname — это короткое имя, которое можно использовать в коде для обозначения импортированного пространства имен.Namespace — это пространство имен, доступное либо через ссылку в проекте, либо через определение в проекте, либо с помощью предшествующей инструкции Imports.

Модуль может содержать любое количество операторов Imports.Они должны располагаться после операторов Option, если таковые присутствуют, но перед любым другим кодом.

ПримечаниеПримечание

Не следует путать ссылки на проекты с оператором Imports или Declare.Ссылки на проекты делают внешние объекты, такие как объекты в сборках, доступные для проектов Visual Basic.Оператор Imports используется для упрощения доступа к ссылкам на проекты, однако он не обеспечивает доступа к этим объектам.Оператор Declare применяется для объявления ссылки на внешнюю процедуру в библиотеке DLL.

Использование псевдонимов при помощи оператора Imports

Оператор Imports облегчает доступ к методам классов, устраняя необходимость явно вводить полные проверенные имена ссылок.Псевдонимы позволяют присваивать более понятные имена только одной части пространства имен.Например, последовательность возврат каретки / перевод строки, в результате которой один фрагмент текста отображается в нескольких строках, является частью модуля ControlChars пространства имен Microsoft.VisualBasic.Использование этой константы в программе без псевдонима потребовало бы написания следующего кода:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

Операторы Imports должны всегда располагаться в первых строках модуля сразу же после операторов Option. В следующем фрагменте кода показано, как импортировать и присваивать псевдоним модулю Microsoft.VisualBasic.ControlChars:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Дальнейшие ссылки на это пространство имен могут быть значительно более краткими:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

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

См. также

Задачи

Практическое руководство. Добавление и удаление ссылок с помощью диалогового окна "Добавление ссылок"

Практическое руководство. Создание и использование сборок с помощью командной строки (C# и Visual Basic)

Ссылки

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

ControlChars

Microsoft.VisualBasic

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

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

Сборки и глобальный кэш сборок (C# и Visual Basic)