Ссылки и оператор 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 Если инструкция не содержит имя псевдонима, элементы, определенные в импортированном пространстве имен, можно использовать в модуле без квалификации. Если указано имя псевдонима, его необходимо использовать в качестве квалификатора для имен, содержащихся в этом пространстве имен.

См. также