Parsial (Visual Basic)

Artikel
03/13/2024

Menunjukkan bahwa deklarasi jenis adalah definisi parsial dari jenis.

Anda dapat membagi definisi jenis di antara beberapa deklarasi dengan menggunakan kata kunci Partial. Anda dapat menggunakan deklarasi parsial sebanyak yang Anda inginkan, dalam banyak file sumber berbeda yang Anda inginkan. Tetapi, semua deklarasi harus dalam rakitan yang sama dan namespace yang sama.

Catatan

Visual Basic mendukung metode parsial, yang biasanya diterapkan di kelas parsial. Untuk informasi selengkapnya, lihat Metode Parsial dan Pernyataan Sub.

Sintaks

[ <attrlist> ] [ accessmodifier ] [ Shadows ] [ MustInherit | NotInheritable ] _  
Partial { Class | Structure | Interface | Module } name [ (Of typelist) ]  
    [ Inherits classname ]  
    [ Implements interfacenames ]  
    [ variabledeclarations ]  
    [ proceduredeclarations ]  
{ End Class | End Structure }

Generator

Term	Definisi
`attrlist`	Opsional. Daftar atribut yang berlaku untuk jenis ini. Anda harus menyertakan Daftar Atribut dalam tanda kurung sudut (`< >`).
`accessmodifier`	Opsional. Menentukan kode apa yang dapat mengakses jenis ini. Lihat Tingkat akses di Visual Basic.
`Shadows`	Opsional. Lihat Bayangan.
`MustInherit`	Opsional. Lihat MustInherit.
`NotInheritable`	Opsional. Lihta NotInheritable.
`name`	Harus diisi. Nama jenis ini. Harus cocok dengan nama yang ditentukan dalam semua deklarasi parsial lainnya dari jenis yang sama.
`Of`	Opsional. Tentukan bahwa ini adalah jenis generik. Lihat Jenis Generik dalam Visual Basic.
`typelist`	Wajib jika Anda menggunakan Of. Lihat Daftar Jenis.
`Inherits`	Opsional. Lihat Pernyataan Inherits.
`classname`	Diperlukan jika Anda menggunakan `Inherits`. Nama kelas atau antarmuka dari tempat kelas ini berasal.
`Implements`	Opsional. Lihat Pernyataan Implements.
`interfacenames`	Diperlukan jika Anda menggunakan `Implements`. Nama antarmuka yang diterapkan jenis ini.
`variabledeclarations`	Opsional. Pernyataan yang mendeklarasikan variabel dan kejadian tambahan untuk jenis tersebut.
`proceduredeclarations`	Opsional. Pernyataan yang mendeklarasikan dan menentukan prosedur tambahan untuk jenis tersebut.
`End Class` atau `End Structure`	Mengakhiri definisi `Class` atau `Structure` parsial ini.

Keterangan

Visual Basic menggunakan definisi kelas parsial untuk memisahkan kode yang dihasilkan dari kode yang dibuat pengguna dalam file sumber terpisah. Misalnya, Windows Form Designer menentukan kelas parsial untuk kontrol seperti Form. Anda tidak boleh mengubah kode yang dihasilkan dalam kontrol ini.

Semua aturan untuk pembuatan kelas, struktur, antarmuka, dan modul, seperti untuk penggunaan dan pewarisan pengubah, berlaku saat membuat jenis parsial.

Praktik Terbaik

Dalam keadaan normal, Anda tidak boleh membagi pengembangan satu jenis menjadi dua atau lebih deklarasi. Oleh karena itu, biasanya Anda tidak memerlukan kata kunci Partial.
Agar mudah dibaca, setiap deklarasi parsial dari jenis harus menyertakan kata kunci Partial. Kompilator mengizinkan paling banyak satu deklarasi parsial untuk menghilangkan kata kunci; jika dua atau lebih deklarasi parsial menghilangkan kata kunci, kompilator memberi sinyal kesalahan.

Perilaku

Kesatuan Deklarasi. Kompilator memperlakukan jenis sebagai gabungan dari semua deklarasi parsial. Setiap pengubah dari setiap definisi parsial berlaku untuk seluruh jenis, dan setiap anggota dari setiap definisi parsial tersedia untuk seluruh jenis.
Promosi Jenis Tidak Diizinkan Untuk Jenis Parsial dalam Modul. Jika definisi parsial ada di dalam modul, promosi jenis dari jenis tersebut secara otomatis dihilangkan. Dalam kasus seperti itu, kumpulan definisi parsial dapat menyebabkan hasil yang tidak diharapkan dan bahkan kesalahan kompilator. Untuk informasi selengkapnya, lihat Penentu Jenis.

Kompilator menggabungkan definisi parsial hanya ketika jalur yang sepenuhnya memenuhi syarat identik.

Kata kunci Partial dapat digunakan dalam konteks berikut:

Pernyataan Kelas

Pernyataan Struktur

Contoh

Contoh berikut membagi definisi kelas sampleClass menjadi dua deklarasi, yang masing-masing menentukan prosedur Sub yang berbeda.

Partial Public Class sampleClass
    Public Sub sub1()
    End Sub
End Class
Partial Public Class sampleClass
    Public Sub sub2()
    End Sub
End Class

Dua definisi parsial dalam contoh sebelumnya dapat berada dalam file sumber yang sama atau dalam dua file sumber yang berbeda.

Bagikan melalui