Pernyataan Impor (Namespace dan Jenis .NET)
Memungkinkan nama jenis dirujuk tanpa kualifikasi namespace layanan.
Sintaks
Imports [ aliasname = ] namespace
' -or-
Imports [ aliasname = ] namespace.element
Generator
Term | Definisi |
---|---|
aliasname |
Opsional. Alias atau nama impor yang dapat dirujuk kode namespace alih-alih string kualifikasi lengkap. Lihat Nama Elemen yang Dideklarasikan. |
namespace |
Harus diisi. Nama namespace layanan yang sepenuhnya memenuhi syarat yang sedang diimpor. Dapat berupa string namespace layanan yang disarangkan ke tingkat apa pun. |
element |
Opsional. Nama elemen pemrograman yang dideklarasikan dalam namespace layanan. Dapat berupa elemen kontainer apa pun. |
Keterangan
Pernyataan Imports
memungkinkan jenis yang terkandung dalam namespace layanan tertentu untuk direferensikan secara langsung.
Anda dapat menyediakan satu nama namespace layanan atau string namespace layanan yang disarangkan. Setiap string namespace layanan yang disarangkan dipisahkan dari namespace layanan tingkat yang lebih tinggi berikutnya dengan titik (.
), seperti yang diilustrasikan contoh berikut:
Imports System.Collections.Generic
Setiap file sumber dapat berisi sejumlah Imports
pernyataan. Ini harus mengikuti deklarasi opsi, seperti pernyataan Option Strict
, dan harus mendahului deklarasi elemen pemrograman, seperti, pernyataan Module
atau Class
.
Anda dapat menggunakan Imports
hanya pada tingkat file. Ini berarti konteks deklarasi untuk impor harus berupa file sumber, dan tidak boleh berupa namespace layanan, kelas, struktur, modul, antarmuka, prosedur, atau blok.
Perhatikan bahwa pernyataan Imports
tidak membuat elemen dari proyek dan rakitan lain tersedia untuk proyek Anda. Impor tidak mengambil tempat pengaturan referensi. Impor hanya menghapus kebutuhan untuk memenuhi syarat nama yang sudah tersedia untuk proyek Anda. Untuk informasi selengkapnya, lihat "Mengimpor Elemen Penampung" dalam Referensi ke Elemen yang Dideklarasikan.
Catatan
Anda dapat menentukan Imports
pernyataan implisit menggunakan Halaman Referensi, Perancang Proyek (Visual Basic). Untuk informasi selengkapnya, lihat Cara: Menambahkan atau Menghapus Namespace Layanan yang Diimpor (Visual Basic).
Alias Impor
Alias impor menentukan alias untuk namespace layanan atau jenis. Alias impor berguna saat Anda perlu menggunakan item dengan nama yang sama dan dideklarasikan dalam satu atau beberapa namespace layanan. Untuk informasi selengkapnya dan contohnya, lihat "Memenuhi Syarat Nama Elemen" di Referensi ke Elemen yang Dideklarasikan.
Anda tidak boleh mendeklarasikan anggota di tingkat modul dengan nama yang sama dengan aliasname
. Jika Anda melakukannya, pengompilasi Visual Basic hanya menggunakan aliasname
untuk anggota yang dideklarasikan dan tidak lagi mengenalinya sebagai alias impor.
Mesk sintaks yang digunakan untuk mendeklarasikan alias impor seperti yang digunakan untuk mengimpor prefiks kumpulan nama XML, hasilnya akan berbeda. Alias impor dapat digunakan sebagai ekspresi dalam kode Anda, sedangkan prefiks kumpulan nama XML hanya dapat digunakan dalam properti harfiah XML atau sumbu XML sebagai prefiks untuk elemen atau nama atribut yang memenuhi syarat.
Nama Elemen
Jika Anda menyediakan element
, elemen tersebut harus mewakili elemen kontainer, yaitu elemen pemrograman yang dapat berisi elemen lain. Elemen kontainer mencakup kelas, struktur, modul, antarmuka, dan enumerasi.
Cakupan elemen yang disediakan oleh pernyataan Imports
tergantung pada apakah Anda menentukan element
. Jika Anda hanya menentukan namespace
, semua anggota namespace layanan yang dinamai secara unik, dan anggota elemen kontainer dalam namespace layanan tersebut, tersedia tanpa kualifikasi. Jika Anda menentukan namespace
dan element
, hanya anggota elemen tersebut yang tersedia tanpa kualifikasi.
Contoh 1
Contoh berikut mengembalikan semua folder di direktori C:\ dengan menggunakan kelas DirectoryInfo:
Kode tidak memiliki pernyataan Imports
di bagian atas file. Oleh karena itu, referensi DirectoryInfo, StringBuilder, dan CrLf sepenuhnya memenuhi syarat dengan namespace layanan.
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
Contoh 2
Contoh berikut menyertakan pernyataan Imports
untuk namespace layanan yang direferensikan. Oleh karena itu, jenis tidak harus sepenuhnya memenuhi syarat dengan namespace layanan.
' 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
Contoh 3
Contoh berikut menyertakan pernyataan Imports
yang membuat alias untuk namespace layanan yang direferensikan. Jenisnya memenuhi syarat dengan alias.
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
Contoh 4
Contoh berikut menyertakan pernyataan Imports
yang membuat alias untuk jenis yang direferensikan. Alias digunakan untuk menentukan jenisnya.
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