通过

<bindingRedirect> 元素

  • 项目

更新：2007 年 11 月

将一个程序集版本重定向到另一个版本。

<configuration> 元素
  <runtime> 元素
    <runtime> -> <assemblyBinding> 元素
      <dependentAssembly> 元素
        <bindingRedirect> 元素

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

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性

说明

oldVersion

必需。

指定最初请求的程序集的版本。程序集版本号的格式是 major.minor.build.revision。该版本号的每个部分的有效值为 0 到 65535。

还可以按下列格式指定版本范围：

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

newVersion

必需。

指定要用来取代最初请求的版本的程序集版本（格式为：n.n.n.n）。

子元素

元素

说明

无

父元素

元素

说明

assemblyBinding

包含有关程序集版本重定向和程序集位置的信息。

configuration

公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

dependentAssembly

封装每个程序集的绑定策略和程序集位置。为每个程序集使用一个 dependentAssembly 元素。

runtime

包含有关程序集绑定和垃圾回收的信息。

备注

针对具有强名称的程序集生成 .NET Framework 应用程序时，在默认情况下，即使可以使用新版本，应用程序在运行时仍使用该程序集版本。然而，可以配置应用程序以针对程序集的较新版本运行。有关运行库如何使用这些文件确定使用哪个程序集版本的详细信息，请参见运行库如何定位程序集。

通过在一个 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 的配置文件架构