Ссылки и оператор Imports (Visual Basic)
Внешние объекты можно сделать доступными для проекта, выбрав команду "Добавить ссылку " в меню "Проект ". Ссылки в Visual Basic могут указывать на сборки, которые похожи на библиотеки типов, но содержат дополнительные сведения.
Инструкция import
Сборки включают одно или несколько пространств имен. При добавлении ссылки на сборку можно также добавить Imports
инструкцию в модуль, который управляет видимостью пространств имен этой сборки в модуле. Оператор Imports
предоставляет контекст области, который позволяет использовать только часть пространства имен, необходимую для предоставления уникальной ссылки.
Оператор Imports
имеет следующий синтаксис:
Imports [Aliasname =] Namespace
Aliasname
относится к короткому имени, который можно использовать в коде для ссылки на импортированное пространство имен. Namespace
— это пространство имен, доступное через ссылку на проект, через определение в проекте или с помощью предыдущей Imports
инструкции.
Модуль может содержать любое количество инструкций Imports
. Они должны отображаться после любых Option
операторов, если они присутствуют, но перед любым другим кодом.
Примечание.
Не путайте ссылки на проект с инструкцией Imports
или инструкцией Declare
. Ссылки на проект делают внешние объекты, такие как объекты в сборках, доступными для проектов Visual Basic. Инструкция Imports
используется для упрощения доступа к ссылкам на проект, но не предоставляет доступ к этим объектам. Инструкция Declare
используется для объявления ссылки на внешнюю процедуру в библиотеке динамической компоновки (DLL).
Использование псевдонимов с оператором import
Оператор 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
Если инструкция не содержит имя псевдонима, элементы, определенные в импортированном пространстве имен, можно использовать в модуле без квалификации. Если указано имя псевдонима, его необходимо использовать в качестве квалификатора для имен, содержащихся в этом пространстве имен.