<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 的配置文件架构