Elemen <bindingRedirect>

Artikel
04/08/2023

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>

Bagikan melalui