Bagikan melalui

Penerapan versi rakitan

Semua pembaruan versi dari rakitan yang menggunakan common language runtime dilakukan pada tingkat perakitan. Versi khusus dari suatu rakitan dan versi rakitan yang bergantung dicatat dalam manifes milik rakitan tersebut. Kebijakan versi default untuk runtime adalah bahwa aplikasi hanya berjalan dengan versi di mana mereka dibuat dan diuji, kecuali dibatalkan oleh kebijakan versi yang eksplisit dalam file konfigurasi (file konfigurasi aplikasi, file kebijakan penerbit, dan file konfigurasi administrator komputer).

Runtime melakukan beberapa langkah untuk menyelesaikan permintaan pengikatan assembly.

  1. Memeriksa referensi rakitan asli untuk menentukan versi rakitan yang akan diikat.

  2. Memeriksa semua file konfigurasi yang berlaku untuk menerapkan kebijakan versi.

  3. Menentukan rakitan yang benar dari referensi perakitan asli dan pengalihan apa pun yang ditentukan dalam file konfigurasi, dan menentukan versi yang harus terikat ke rakitan panggilan.

  4. Memeriksa cache perakitan global, basis kode yang ditentukan dalam file konfigurasi, lalu memeriksa direktori dan subdirektori aplikasi menggunakan aturan pemeriksaan yang dijelaskan dalam Cara runtime menemukan rakitan.

Ilustrasi berikut menunjukkan langkah-langkah berikut:

Diagram yang memperlihatkan langkah-langkah dalam resolusi permintaan pengikatan rakitan.

Untuk informasi selengkapnya tentang mengonfigurasi aplikasi, lihat Mengonfigurasi aplikasi. Untuk informasi selengkapnya tentang kebijakan pengikatan, lihat Bagaimana runtime menemukan rakitan.

Informasi versi

Setiap rakitan memiliki dua cara berbeda untuk mengekspresikan informasi versi:

  • Nomor versi perakitan, yang, bersama dengan nama rakitan dan informasi budaya, adalah bagian dari identitas perakitan. Nomor ini digunakan oleh runtime untuk memberlakukan kebijakan versi dan memainkan bagian kunci dalam proses penyelesaian tipe selama runtime.

  • Versi informasi, yang merupakan string yang mewakili informasi versi tambahan yang disertakan hanya untuk tujuan informasi.

Nomor versi rakitan

Setiap rakitan memiliki nomor versi sebagai bagian dari identitasnya. Dengan demikian, dua rakitan yang berbeda menurut nomor versi dianggap oleh runtime sebagai rakitan yang sepenuhnya berbeda. Nomor versi ini secara fisik dinyatakan sebagai string empat bagian dengan format berikut:

< versi> utama.<versi> minor.<nomor> build.<revisi>

Misalnya, versi 1.5.1254.0 menunjukkan 1 sebagai versi utama, 5 sebagai versi minor, 1254 sebagai nomor build, dan 0 sebagai nomor revisi.

Nomor versi disimpan dalam manifes perakitan bersama dengan informasi identitas lain, termasuk nama rakitan dan kunci publik, serta informasi tentang hubungan dan identitas rakitan lain yang terhubung dengan aplikasi.

Saat rakitan dibangun, informasi dependensi direkam oleh alat pengembangan untuk setiap rakitan yang direferensi di dalam manifes rakitan. Runtime menggunakan nomor versi ini, bersama dengan informasi konfigurasi yang ditetapkan oleh administrator, aplikasi, atau penerbit, untuk memuat versi yang tepat dari rakitan yang dirujuk.

Runtime membedakan antara rakitan reguler dan rakitan bernama kuat untuk tujuan pengelolaan versi. Pemeriksaan versi hanya terjadi dengan assembly yang memiliki nama kuat.

Untuk informasi tentang menentukan kebijakan pengikatan versi, lihat Mengonfigurasi aplikasi. Untuk informasi tentang cara runtime menggunakan informasi versi untuk menemukan rakitan tertentu, lihat Cara runtime menemukan rakitan.

Versi informasi perakitan

Versi informasi adalah string yang melampirkan informasi versi tambahan ke assembly hanya untuk tujuan informatif; informasi ini tidak digunakan pada waktu runtime. Versi informasi berbasis teks berkaitan dengan literatur pemasaran produk, kemasan, atau nama produk dan tidak digunakan oleh runtime. Misalnya, versi informasi bisa menjadi "Common Language Runtime versi 1.0" atau "NET Control SP 2". Pada tab Versi dialog properti file di Microsoft Windows, informasi ini muncul di item "Versi Produk".

Nota

Meskipun Anda dapat menentukan teks apa pun, pesan peringatan muncul pada kompilasi jika string tidak dalam format yang digunakan oleh nomor versi rakitan, atau jika dalam format tersebut tetapi berisi kartubebas. Peringatan ini tidak berbahaya.

Versi informasi diwakili menggunakan atribut System.Reflection.AssemblyInformationalVersionAttributekustom . Untuk informasi selengkapnya tentang atribut versi informasi, lihat Menetapkan atribut perakitan.

Lihat juga

  • Last updated on