Kelas System.Resources.SatelliteContractVersionAttribute

Nota

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

Di aplikasi desktop, atribut SatelliteContractVersionAttribute menetapkan kontrak antara assembly utama dan semua satelitnya. Anda menerapkan atribut ini ke rakitan utama Anda, dan memberikannya nomor versi dari rakitan satelit yang akan berfungsi dengan versi rakitan utama ini. Ketika manajer sumber daya (ResourceManager objek) mencari sumber daya, ia secara eksplisit memuat versi satelit yang ditentukan oleh atribut ini pada rakitan utama.

Saat memperbarui rakitan utama, Anda menaikkan nomor versi rakitannya. Namun, Anda mungkin tidak ingin mengirim salinan baru dari rakitan satelit Anda jika salinan yang ada kompatibel dengan aplikasi Anda. Dalam hal ini, tingkatkan nomor versi rakitan utama tetapi biarkan nomor versi kontrak satelit tetap sama. Manajer sumber daya akan menggunakan rakitan satelit Anda yang ada.

Jika Anda ingin merevisi rakitan satelit tetapi bukan assembly utama, naikkan nomor versi di satelit Anda. Dalam hal ini, kirimkan assembly kebijakan penerbit bersama dengan assembly satelit Anda yang menyatakan bahwa assembly satelit baru Anda memiliki kompatibilitas ke belakang dengan assembly satelit lama Anda. Manajer Sumber Daya masih akan menggunakan nomor kontrak lama yang ditulis ke dalam rakitan utama Anda berdasarkan atribut SatelliteContractVersionAttribute; namun, loader akan terhubung dengan versi rakitan satelit yang ditentukan oleh rakitan kebijakan.

Penyedia komponen yang dibagi menggunakan assembly kebijakan penerbit untuk membuat pernyataan mengenai kompatibilitas tentang versi tertentu dari assembly yang dirilis. Rakitan kebijakan penerbit adalah rakitan bernama kuat yang memiliki nama dalam format policy.<major>.<minor>.<ComponentAssemblyName>, dan terdaftar di Global Assembly Cache (GAC). Kebijakan penerbit dihasilkan dari file konfigurasi XML (lihat <bindingRedirect> Elemen) dengan menggunakan alat Al.exe (Assembly Linker). Assembly Linker digunakan dengan opsi /link untuk menghubungkan file konfigurasi XML ke perakitan manifes, yang disimpan kemudian di cache perakitan global. Rakitan kebijakan penerbit dapat digunakan ketika vendor mengirimkan rilis pemeliharaan (paket layanan) yang berisi perbaikan bug.

Aplikasi Windows 8.x Store

Atribut ini diabaikan di aplikasi Windows 8.x Store, karena file indeks sumber daya paket (PRI) tidak memiliki semantik penerapan versi. Selain itu, model pengemasan Windows 8.x Store memerlukan semua sumber daya untuk dikirim dalam paket yang sama, tanpa kemungkinan penyebaran ulang rakitan satelit atau file PRI.