parsial (C++/CLI dan C++/CX)

Kata kunci parsial memungkinkan berbagai bagian dari kelas ref yang sama untuk ditulis secara independen dan dalam file yang berbeda.

Semua Runtime

(Fitur bahasa ini hanya berlaku untuk Windows Runtime.)

Windows Runtime

Untuk kelas ref yang memiliki dua definisi parsial, kata kunci parsial diterapkan pada kemunculan pertama definisi, dan ini biasanya dilakukan oleh kode yang dihasilkan secara otomatis, sehingga coder manusia tidak sering menggunakan kata kunci. Untuk semua definisi parsial kelas berikutnya, hilangkan pengubah parsial dari kata kunci kelas dan pengidentifikasi kelas. Ketika kompilator menemukan kelas ref dan pengidentifikasi kelas yang ditentukan sebelumnya tetapi tidak ada kata kunci parsial , pengompilasi secara internal menggabungkan semua bagian definisi kelas ref ke dalam satu definisi.

Sintaks

partial class-key identifier {
   /* The first part of the partial class definition.
      This is typically auto-generated */
}
// ...
class-key identifier {
   /* The subsequent part(s) of the class definition. The same
      identifier is specified, but the "partial" keyword is omitted. */
}

Parameter

kunci kelas
Kata kunci yang mendeklarasikan kelas atau struktur yang didukung oleh Windows Runtime. Baik kelas ref, kelas nilai, struktur ref, atau struktur nilai.

identifier
Nama jenis yang ditentukan.

Keterangan

Kelas parsial mendukung skenario di mana Anda memodifikasi satu bagian definisi kelas dalam satu file, dan perangkat lunak pembuatan kode otomatis—misalnya, perancang XAML—memodifikasi kode di kelas yang sama di file lain. Dengan menggunakan kelas parsial, Anda dapat mencegah generator kode otomatis menimpa kode Anda. Dalam proyek Visual Studio, pengubah parsial diterapkan secara otomatis ke file yang dihasilkan.

Konten: Dengan dua pengecualian, definisi kelas parsial dapat berisi apa pun yang dapat dimuat oleh definisi kelas lengkap jika kata kunci parsial dihilangkan. Namun, Anda tidak dapat menentukan aksesibilitas kelas (misalnya, public partial class X { ... };), atau declspec.

Penentu akses yang digunakan dalam definisi kelas parsial untuk pengidentifikasi tidak memengaruhi aksesibilitas default dalam definisi kelas parsial atau penuh berikutnya untuk pengidentifikasi. Definisi sebaris anggota data statis diizinkan.

Deklarasi: Definisi parsial pengidentifikasi kelas hanya memperkenalkan pengidentifikasi nama, tetapi pengidentifikasi tidak dapat digunakan dengan cara yang memerlukan definisi kelas. Pengidentifikasi nama tidak dapat digunakan untuk mengetahui ukuran pengidentifikasi, atau untuk menggunakan basis atau anggota pengidentifikasi sampai setelah pengkompilasi menemukan definisi lengkap pengidentifikasi.

Jumlah dan pengurutan: Mungkin ada nol atau lebih definisi kelas parsial untuk pengidentifikasi. Setiap definisi kelas parsial pengidentifikasi harus secara leksikal mendahului satu definisi lengkap pengidentifikasi (jika ada definisi lengkap; jika tidak, kelas tidak dapat digunakan kecuali seolah-olah dinyatakan maju) tetapi tidak perlu mendahului deklarasi pengidentifikasi. Semua kunci kelas harus cocok.

Definisi lengkap: Pada titik definisi lengkap pengidentifikasi kelas, perilakunya sama seperti jika definisi pengidentifikasi telah mendeklarasikan semua kelas dasar, anggota, dll. dalam urutan di mana mereka ditemui dan didefinisikan dalam kelas parsial.

Templat: Kelas parsial tidak boleh berupa templat.

Generik: Kelas parsial dapat menjadi generik jika definisi lengkapnya bisa generik. Tetapi setiap kelas parsial dan penuh harus memiliki parameter generik yang sama persis, termasuk nama parameter formal.

Untuk informasi selengkapnya tentang cara menggunakan kata kunci parsial , lihat Kelas Parsial (C++/CX).

Persyaratan

Opsi pengkompilasi: /ZW

Runtime Bahasa Umum

(Fitur bahasa ini tidak berlaku untuk Common Language Runtime.)

Lihat juga

Kelas Parsial (C++/CX)