Kelas System.Resources.SatelliteContractVersionAttribute

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

Di aplikasi desktop, SatelliteContractVersionAttribute atribut menetapkan kontrak antara perakitan utama dan semua satelitnya. Anda menerapkan atribut ini ke rakitan utama Anda, dan meneruskannya nomor versi 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 perakitan kebijakan penerbit bersama dengan rakitan satelit Anda yang menyatakan bahwa rakitan satelit baru Anda memiliki kompatibilitas mundur dengan rakitan satelit lama Anda. Manajer sumber daya masih akan menggunakan nomor kontrak lama yang ditulis ke dalam rakitan utama Anda berdasarkan SatelliteContractVersionAttribute atribut; namun, loader akan mengikat ke versi perakitan satelit yang ditentukan oleh perakitan kebijakan.

Vendor komponen bersama menggunakan perakitan kebijakan penerbit untuk membuat pernyataan kompatibilitas tentang versi tertentu dari rakitan 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> Element) dengan menggunakan alat Al.exe (Assembly Linker). Assembly Linker digunakan dengan /link opsi untuk menautkan file konfigurasi XML ke perakitan manifes, yang kemudian disimpan di cache perakitan global. Rakitan kebijakan penerbit dapat digunakan ketika vendor mengirimkan rilis pemeliharaan (paket layanan) yang berisi perbaikan bug.

Aplikasi Bursa Windows 8.x

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.