Оператор Imports (пространство имен .NET и тип)
Позволяет обращаться к именам типов без уточнения пространства имен.
Imports [ aliasname = ] namespace
-or-
Imports [ aliasname = ] namespace.element
Части
Термин |
Определение |
aliasname |
Необязательный.import alias или имя, по которому код может обращаться к namespace вместо использования полной строки.См. раздел Имена объявленных типов (Visual Basic). |
namespace |
Обязательный.Полное имя пространства имен импортируемого.Может быть строкой пространства имен, вложенного на любом уровне. |
element |
Необязательный.Имя элемента программирования, объявленное в пространстве имен.Может быть любым элементом контейнера. |
Заметки
Оператор Imports разрешает непосредственно ссылаться на типы, содержащиеся в заданном пространстве имен.
Можно указать имя одного пространства имен или строку из вложенных пространств имен.Каждое вложенное пространство имен отделяется от следующего пространства имен более высокого уровня точкой (.), как показано в следующем примере.
Imports System.Collections.Generic
Каждый исходный файл может содержать любое количество операторов Imports.Они должны следовать за любым параметром объявления, таким как инструкция Option Strict, и они должны предшествовать любому объявлению элементов программированию, например инструкциям Module или Class.
Можно использовать Imports только на уровне файла.Это означает, что контекст объявления для импорта должен быть исходным файлом и не может быть пространством имен, классом, структурой, модулем, интерфейсом, процедурой или блоком.
Обратите внимание, что оператор Imports не разрешает текущему проекту получать доступ к элементам других проектов и сборок.Импорт не принимает в качестве параметра ссылку.Он только избавляет от необходимости квалификации имен, которые уже доступны проекту.Дополнительные сведения содержатся в разделе "Импорт содержащих элементов" в Ссылки на объявленные элементы (Visual Basic).
![]() |
---|
Можно определить неявные операторы Imports, используя Страница "Ссылки" в конструкторе проектов (Visual Basic).Дополнительные сведения см. в разделе Практическое руководство. Добавление или удаление импортированных пространств имен (Visual Basic). |
Импорт псевдонимов
Псевдоним импорта определяет псевдоним для типа или пространства имен.Псевдонимы применяются, когда необходимо использовать элементы с одинаковыми именами, объявленные в одном или нескольких пространствах имен.Дополнительные сведения и примеры см. в подразделе "Уточнение имени элемента" раздела Ссылки на объявленные элементы (Visual Basic).
Нельзя объявлять элемент на уровне модуля с именем, совпадающим с aliasname.Если это сделать, то компилятор Visual Basic воспримет aliasname только для объявленного элемента и больше не распознает его как псевдоним импорта.
Хотя синтаксис, используемый для объявления псевдонима импорта, такой же как используемый для импорта префикса пространства имен XML, результаты отличаются.Псевдоним импорта может использоваться как выражение в коде, тогда как префикс пространства имен XML можно использовать только в XML-литералах или свойствах XML-оси как префикс для элемента или имени атрибута.
Имена элементов
Если указать element, он должен представлять container element, который является элементом программирования, содержащим другие элементы.К элементам контейнера относятся классы, структуры, модули, интерфейсы и перечисления.
Область элементов, доступных с помощью оператора Imports, зависит от того, определяется ли element.Если задано только namespace, то все члены и члены элементов контейнера этого пространства имен с уникальными именами в пределах этого пространства имен доступны без уточнения.Если указать вместе namespace и element, без уточнения доступны только члены этого элемента.
Пример
В следующем примере возвращаются все папки в папке C:\ с помощью классаDirectoryInfo.
В коде нет операторов Imports в начале файла.Таким образом ссылки DirectoryInfoStringBuilderи CrLf являются полными, с пространствами имен.
Public Function GetFolders() As String
' Create a new StringBuilder, which is used
' to efficiently build strings.
Dim sb As New System.Text.StringBuilder
Dim dInfo As New System.IO.DirectoryInfo("c:\")
' Obtain an array of directories, and iterate through
' the array.
For Each dir As System.IO.DirectoryInfo In dInfo.GetDirectories()
sb.Append(dir.Name)
sb.Append(Microsoft.VisualBasic.ControlChars.CrLf)
Next
Return sb.ToString
End Function
Следующий пример включает оператор Imports для пространств имен, на которые стоит ссылка.Таким образом типы не обязательно должны быть полными, с пространствами имен.
' Place Imports statements at the top of your program.
Imports System.Text
Imports System.IO
Imports Microsoft.VisualBasic.ControlChars
Public Function GetFolders() As String
Dim sb As New StringBuilder
Dim dInfo As New DirectoryInfo("c:\")
For Each dir As DirectoryInfo In dInfo.GetDirectories()
sb.Append(dir.Name)
sb.Append(CrLf)
Next
Return sb.ToString
End Function
Следующий пример включает операторы Imports, создающие псевдонимы для пространств имен, на которые стоит ссылка.Типы дополняются псевдонимами.
Imports systxt = System.Text
Imports sysio = System.IO
Imports ch = Microsoft.VisualBasic.ControlChars
Public Function GetFolders() As String
Dim sb As New systxt.StringBuilder
Dim dInfo As New sysio.DirectoryInfo("c:\")
For Each dir As sysio.DirectoryInfo In dInfo.GetDirectories()
sb.Append(dir.Name)
sb.Append(ch.CrLf)
Next
Return sb.ToString
End Function
Следующий пример включает операторы Imports, создающие псевдонимы для типов, на которые стоит ссылка.Псевдонимы используются для указания типов.
Imports strbld = System.Text.StringBuilder
Imports dirinf = System.IO.DirectoryInfo
Public Function GetFolders() As String
Dim sb As New strbld
Dim dInfo As New dirinf("c:\")
For Each dir As dirinf In dInfo.GetDirectories()
sb.Append(dir.Name)
sb.Append(ControlChars.CrLf)
Next
Return sb.ToString
End Function
См. также
Ссылки
Оператор Imports (пространство имен XML)
Основные понятия
Пространства имен в Visual Basic