Bagikan melalui

Pernyataan Impor (Namespace dan Jenis.NET)

Memungkinkan nama jenis dirujuk tanpa kualifikasi namespace.

Sintaksis

Imports [ aliasname = ] namespace
' -or-
Imports [ aliasname = ] namespace.element

Bagian

Istilah Definisi
aliasname Fakultatif. Alias impor atau nama yang dapat dirujuk namespace oleh kode alih-alih string kualifikasi lengkap. Lihat Nama Elemen yang Dideklarasikan.
namespace Dibutuhkan. Nama namespace layanan yang sepenuhnya memenuhi syarat yang sedang diimpor. Dapat berupa string namespace yang disarangkan ke tingkat apa pun.
element Fakultatif. Nama elemen pemrograman yang dideklarasikan dalam namespace. Dapat berupa elemen kontainer apa pun.

Komentar

Pernyataan ini Imports memungkinkan jenis yang terkandung dalam namespace tertentu untuk direferensikan secara langsung.

Anda dapat memberikan satu nama namespace layanan atau string namespace berlapis. Setiap namespace berlapis dipisahkan dari namespace tingkat 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 apa pun, seperti Option Strict pernyataan, dan mereka harus mendahului deklarasi elemen pemrograman apa pun, seperti Module pernyataan atau Class .

Anda hanya dapat menggunakan Imports pada tingkat file. Ini berarti konteks deklarasi untuk impor harus berupa file sumber, dan tidak boleh berupa namespace, kelas, struktur, modul, antarmuka, prosedur, atau blok.

Perhatikan bahwa Imports pernyataan tidak membuat elemen dari proyek dan rakitan lain tersedia untuk proyek Anda. Mengimpor tidak menggantikan pengaturan referensi. Ini hanya menghapus kebutuhan untuk memenuhi syarat nama yang sudah tersedia untuk proyek Anda. Untuk informasi selengkapnya, lihat "Mengimpor Elemen Yang Mengandung" dalam Referensi ke Elemen yang Dideklarasikan.

Nota

Anda dapat menentukan pernyataan implisit Imports dengan menggunakan Halaman Referensi, Perancang Proyek (Visual Basic). Untuk informasi selengkapnya, lihat Cara: Menambahkan atau Menghapus Namespace Yang Diimpor (Visual Basic).

Impor Alias

Alias impor menentukan alias untuk namespace atau jenis. Alias impor berguna ketika Anda perlu menggunakan item dengan nama yang sama yang dideklarasikan dalam satu atau beberapa namespace. 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, pengkompilasi Visual Basic hanya menggunakan aliasname untuk anggota yang dideklarasikan dan tidak lagi mengenalinya sebagai alias impor.

Meskipun sintaks yang digunakan untuk mendeklarasikan alias impor seperti yang digunakan untuk mengimpor awalan namespace XML, hasilnya berbeda. Alias impor dapat digunakan sebagai ekspresi dalam kode Anda, sedangkan awalan namespace XML hanya dapat digunakan dalam properti literal XML atau sumbu XML sebagai awalan 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 termasuk kelas, struktur, modul, antarmuka, dan enumerasi.

Cakupan elemen yang Imports disediakan oleh pernyataan tergantung pada apakah Anda menentukan element. Jika Anda hanya namespacemenentukan , semua anggota namespace layanan yang dinamai secara unik, dan anggota elemen kontainer dalam namespace layanan tersebut, tersedia tanpa kualifikasi. Jika Anda menentukan dan namespaceelement, hanya anggota elemen tersebut yang tersedia tanpa kualifikasi.

Contoh 1

Contoh berikut mengembalikan semua folder di direktori C:\ dengan menggunakan DirectoryInfo kelas :

Kode tidak Imports memiliki pernyataan di bagian atas file. Oleh karena itu, DirectoryInforeferensi , StringBuilder, dan CrLf semuanya 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 Imports pernyataan untuk namespace layanan yang dirujuk. 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 mencakup Imports pernyataan yang membuat alias untuk namespace layanan yang dirujuk. 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 mencakup Imports pernyataan yang membuat alias untuk jenis yang dirujuk. Alias digunakan untuk menentukan jenis.

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

Lihat juga

  • Last updated on