Elemen <bindingRedirect>

  • Artikel

Mengalihkan satu versi perakitan ke versi perakitan lainnya.

<konfigurasi>
  <runtime bahasa umum>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Sintaks

   <bindingRedirect
oldVersion="existing assembly version"  
newVersion="new assembly version"/>

Atribut dan Elemen

Bagian berikut menjelaskan atribut, elemen turunan, dan elemen induk.

Atribut

Atribut Deskripsi
oldVersion Atribut yang diperlukan.

Menentukan versi rakitan yang awalnya diminta. Format nomor versi rakitan adalah major.minor.build.revision. Nilai yang valid untuk setiap bagian dari nomor versi adalah 0 hingga 65535.

Anda juga bisa menentukan rentang versi dalam format berikut:

n.n.n.n - n.n.n.n
newVersion Atribut yang diperlukan.

Menentukan versi assembly yang akan digunakan alih-alih versi yang awalnya diminta dalam format: n.n.n.n

Nilai ini dapat menentukan versi yang lebih lama dari oldVersion.

Elemen Anak

Elemen Deskripsi
Tidak ada

Elemen Induk

Elemen Deskripsi
assemblyBinding Berisi informasi tentang pengalihan versi rakitan dan lokasi rakitan.
configuration Elemen akar di setiap file konfigurasi yang digunakan oleh runtime bahasa umum dan aplikasi .NET Framework.
dependentAssembly Merangkum kebijakan pengikatan dan lokasi perakitan untuk setiap perakitan. Menggunakan satu elemen dependenAssembly untuk setiap rakitan.
runtime Berisi informasi tentang pengikatan rakitan dan kumpulan sampah.

Keterangan

Saat Anda membangun aplikasi .NET Framework terhadap rakitan bernama kuat, aplikasi menggunakan versi perakitan tersebut pada durasi secara default, bahkan jika versi baru tersedia. Namun, Anda dapat mengonfigurasi aplikasi untuk dijalankan terhadap versi rakitan yang lebih baru. Untuk detail tentang bagaimana runtime menggunakan file ini untuk menentukan versi rakitan mana yang akan digunakan, lihat Cara Runtime bahasa umum Menemukan Rakitan.

Anda dapat mengalihkan lebih dari satu versi rakitan dengan menyertakan beberapa elemen bindingRedirect dalam elemen dependentAssembly. Anda juga dapat mengalihkan dari versi yang lebih baru ke versi rakitan yang lebih lama.

Pengalihan pengikatan rakitan eksplisit dalam file konfigurasi aplikasi memerlukan izin keamanan. Ini berlaku untuk pengalihan rakitan .NET Framework dan rakitan dari pihak ketiga. Izin diberikan dengan mengatur bendera SecurityPermissionFlag pada SecurityPermission. Untuk informasi selengkapnya, lihat Izin Keamanan Pengalihan Pengikatan Perakitan.

Contoh

Contoh berikut menunjukkan cara mengalihkan satu versi rakitan ke versi rakitan lainnya.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="myAssembly"  
                              publicKeyToken="32ab4ba45e0a69a1"  
                              culture="neutral" />  
            <bindingRedirect oldVersion="1.0.0.0"  
                             newVersion="2.0.0.0"/>  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Lihat juga