Pernyataan Impor (Namespace dan Jenis .NET)

Artikel
04/08/2023

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