<bindingRedirect> 項目

將一個組件版本重新導向為另一個版本。

<configuration> 項目
  <runtime> 項目
    <assemblyBinding> 項目
      <dependentAssembly> 項目
        <bindingRedirect> 項目

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

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性 說明

oldVersion

必要屬性。

指定原始要求的組件版本。組件版本號碼的格式為 major.minor.build.revision。此版本號碼每個部分的有效值為 0 至 65535。

您也可以用下列格式來指定版本範圍:

n.n.n.n - n.n.n.n

newVersion

必要屬性。

指定要使用的組件版本,用來替代原來要求的版本,格式為:n.n.n.n

子項目

項目 說明

父項目

項目 說明

assemblyBinding

包含有關組件版本重新導向和組件位置的資訊。

configuration

每一個組態檔中的根 (Root) 項目是由 Common Language Runtime 和 .NET Framework 應用程式所使用的。

dependentAssembly

封裝每一個組件的繫結原則和組件位置。為每個組件使用一個 dependentAssembly 項目。

runtime

包含有關組件繫結和記憶體回收的資訊。

備註

當您對照強式名稱的組件建置 .NET Framework 應用程式時,即使有可用的新版本,應用程式預設還是會在 Run Time 使用該組件版本。不過,您可以設定應用程式來執行較新版本的組件。如需執行階段如何使用這些檔案決定所要使用組件版本的詳細資訊,請參閱 執行階段如何找出組件

您可以在 dependentAssembly 項目中包含多個 bindingRedirect 項目,將一個以上的組件版本重新導向。

在應用程式組態檔中進行明確的組件繫結重新導向必須擁有安全性權限。這適用於 .NET Framework 組件和協力廠商組件的重新導向。使用權限的授與方式是,在 SecurityPermission 類別 上設定 BindingRedirects 旗標。如需詳細資訊,請參閱組件繫結重新導向安全性權限

範例

下列範例顯示如何將一個組件版本重新導向為另一個版本。

<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>

請參閱

參考

執行階段設定結構描述

概念

重新導向組件版本

其他資源

.NET Framework 的組態檔結構描述