Mengonfigurasi Pengalihan Pengikatan Rakitan

Nota

Artikel ini khusus untuk .NET Framework. Ini tidak berlaku untuk implementasi .NET yang lebih baru, termasuk .NET 6 dan versi yang lebih baru.

Secara default, aplikasi menggunakan set rakitan .NET Framework yang dikirim dengan versi runtime yang digunakan untuk mengkompilasi aplikasi. Anda dapat menggunakan appliesTo atribut pada <elemen assemblyBinding> dalam file konfigurasi aplikasi untuk mengalihkan referensi pengikatan rakitan ke versi tertentu dari rakitan .NET Framework. Atribut opsional ini menggunakan nomor versi .NET Framework untuk menunjukkan versi mana yang berlaku. Jika tidak ada appliesTo atribut yang ditentukan, <assemblyBinding> elemen berlaku untuk semua versi .NET Framework.

Atribut appliesTo diperkenalkan dalam .NET Framework versi 1.1; atribut tersebut diabaikan oleh .NET Framework versi 1.0. Ini berarti bahwa semua <assemblyBinding> elemen diterapkan saat menggunakan .NET Framework versi 1.0, bahkan jika appliesTo atribut ditentukan.

Nota

appliesTo Gunakan atribut untuk membatasi pengalihan pengikatan perakitan ke versi runtime tertentu.

Misalnya, untuk mengubah pengikatan rakitan untuk rakitan .NET Framework versi 1.0, Anda akan menyertakan kode XML berikut dalam file konfigurasi aplikasi Anda.

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly>
               * assembly information goes here *
            </dependentAssembly>
       </assemblyBinding>
</runtime>

Elemen <assemblyBinding> sensitif terhadap pesanan. Anda harus memasukkan informasi pengalihan pengikatan perakitan untuk rakitan .NET Framework versi 1.0 terlebih dahulu, diikuti dengan informasi pengalihan pengikatan perakitan untuk rakitan .NET Framework versi 1.1. Terakhir, masukkan informasi pengalihan pengikatan assembly untuk pengalihan assembly .NET Framework apa pun yang tidak menggunakan atribut appliesTo dan sehingga berlaku untuk seluruh versi .NET Framework. Jika terjadi konflik dalam pengalihan, pernyataan pengalihan pencocokan pertama dalam file konfigurasi digunakan.

Misalnya, untuk mengalihkan satu referensi ke rakitan .NET Framework versi 1.0 dan referensi lain ke rakitan .NET Framework versi 1.1, Anda akan menggunakan pola yang ditunjukkan dalam pseudocode berikut.

<assemblyBinding xmlns="..." appliesTo="v1.0.3705">
  <!-- .NET Framework version 1.0 redirects here. -->
</assemblyBinding>

<assemblyBinding xmlns="..." appliesTo="v1.1.4322">
  <!-- .NET Framework version 1.1 redirects here. -->
</assemblyBinding>

<assemblyBinding xmlns="...">
  <!-- Redirects meant for all versions of the .NET Framework. -->
</assemblyBinding>

Kesalahan Konfigurasi File Debugging

Runtime menguraikan file konfigurasi sekali ketika domain aplikasi dibuat, dan memuat kode ke domain aplikasi tersebut. Common Language Runtime menangani kesalahan di dalam file konfigurasi dengan mengabaikan entri. Runtime mengabaikan seluruh file konfigurasi jika berisi XML cacat. Untuk XML yang tidak valid, hanya bagian yang tidak valid yang diabaikan.

Anda dapat menentukan apakah file konfigurasi sedang digunakan dengan menentukan apakah pengalihan pengikatan perakitan terjadi. Gunakan Penampil Log Pengikatan Rakitan (Fuslogvw.exe) untuk melihat rakitan mana yang sedang dimuat. Untuk melihat semua pengikatan rakitan, Anda harus mengatur entri untuk ForceLog di registri.

Lihat juga

• Panduan: Aktifkan dan Nonaktifkan Pengalihan Pengikatan Otomatis