<bindingRedirect> 元素

  • 项目

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

configuration
  runtime
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

语法

   <bindingRedirect
oldVersion="existing 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）

此值可以指定 oldVersion 之前的版本。

子元素

元素 说明
无

父元素

元素 说明
assemblyBinding 包含有关程序集版本重定向和程序集位置的信息。
configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
dependentAssembly 封装每个程序集的绑定策略和程序集位置。 为每个程序集使用一个 dependentAssembly 元素。
runtime 包含有关程序集绑定和垃圾回收的信息。

备注

在针对具有强名称的程序集生成 .NET Framework 应用程序时，默认情况下，应用程序在运行时使用该版本的程序集，即使提供了新版本也是如此。 但是，你可以将应用程序配置为针对更新版本的程序集运行。 有关运行时如何使用这些文件来确定要使用的程序集版本的详细信息，请参见运行时如何定位程序集。

通过在一个 bindingRedirect 元素中包含多个 dependentAssembly 元素，你可以重定向多个程序集版本。 你还可从程序集的更新版本重定向到较旧版本。

应用程序配置文件中的显式程序集绑定重定向需要安全权限。 这适用于对 .NET Framework 程序集和来自第三方的程序集的重定向。 通过设置 SecurityPermission 上的 SecurityPermissionFlag 标志授予权限。 有关详细信息，请参阅程序集绑定重定向安全权限。

示例

下面的示例演示如何将一个程序集版本重定向到另一个版本。

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

请参阅