Ссылки и оператор Imports

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

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

Оператор Imports

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

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

Imports [|Aliasname =] Namespace

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

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

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

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

Оператор Imports облегчает доступ к методам классов, устраняя необходимость явно вводить полные проверенные имена ссылок. Псевдонимы позволяют присваивать более понятные имена только одной части пространства имен. Например, последовательность возврат каретки / перевод строки, в результате которой один фрагмент текста отображается в нескольких строках, является частью модуля Модуль ControlChars (Visual Basic) пространства имен 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 псевдоним не включен, то элементы, определенные в импортированном пространстве имен, могут использоваться в модуле без указания полного имени. Если псевдоним назначен, он должен использоваться в качестве квалификатора имен, содержащихся в данном пространстве имен.

См. также

Задачи

Практическое руководство. Добавление или удаление ссылок в Visual Studio (Visual Basic)

Практическое руководство. Создание и использование сборок

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

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

Сборки

Ссылки

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

Модуль ControlChars (Visual Basic)

Microsoft.VisualBasic

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

Сведения об изменениях в языке (для пользователей Visual Basic 6.0)