Bagikan melalui


Parsial (Visual Basic)

Menunjukkan bahwa deklarasi jenis adalah definisi parsial dari jenis tersebut.

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

Nota

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

Sintaksis

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

Bagian

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

Komentar

Visual Basic menggunakan definisi kelas parsial untuk memisahkan kode yang dihasilkan dari kode yang ditulis 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 di dua deklarasi atau lebih. Oleh karena itu, dalam kebanyakan kasus Anda tidak memerlukan Partial kata kunci.

  • Untuk keterbacaan, setiap deklarasi parsial dari jenis harus menyertakan Partial kata kunci. Pengkompilasi memungkinkan paling banyak satu deklarasi parsial untuk menghilangkan kata kunci; jika dua atau lebih menghilangkannya, pengkompilasi menandakan kesalahan.

Perilaku

  • Penyatuan Deklarasi. Kompiler memperlakukan jenis sebagai penyatuan semua deklarasi parsialnya. Setiap pengubah dari setiap definisi parsial berlaku untuk seluruh jenis, dan setiap anggota dari setiap definisi parsial tersedia untuk seluruh jenis.

  • Jenis Promosi Tidak Diizinkan Untuk Jenis Parsial dalam Modul. Jika definisi parsial berada di dalam modul, promosi jenis tersebut secara otomatis dikalahkan. Dalam kasus seperti itu, serangkaian definisi parsial dapat menyebabkan hasil yang tidak terduga dan bahkan kesalahan kompilator. Untuk informasi selengkapnya, lihat Mengetik Promosi.

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

Kata Partial kunci dapat digunakan dalam konteks ini:

Pernyataan Kelas

Pernyataan Struktur

Contoh

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

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.

Lihat juga