<runtime> 的 <assemblyBinding> 元素

一.<assemblyBinding> 元素

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

<assemblyBinding
   xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
</assemblyBinding>

特性和元素

下列各节描述了特性、子元素和父元素。

 

特性	说明
xmlns	必需的特性。 指定程序集绑定所需的 XML 命名空间。 使用字符串“urn:schemas-microsoft-com:asm.v1”作为值。
appliesTo	指定 .NET Framework 程序集重定向所应用的运行时版本。 此可选特性使用 .NET Framework 版本号指示其适用的版本。 如果没有指定 appliesTo的特性，<assemblyBinding> 元素将适用于 .NET Framework 的所有版本。 appliesTo特性是在 .NET Framework 1.1 版中引入的；.NET Framework 1.0 版将忽略该特性。 这意味着， 即使指定了appliesTo 特性，在使用 .NET Framework 1.0 版时所有的 <assemblyBinding> 元素也都适用。

子元素

元素	说明
<dependentAssembly>	封装程序集的绑定策略和程序集位置。 为每个程序集使用一个 <dependentAssembly>标记。
<probing>	指定加载程序集时公共语言运行时搜索的子目录。
<publisherPolicy>	指定运行时是否采用出版商策略。
<qualifyAssembly>	指定当使用程序集的部分名称时应动态加载的程序集全名。

父元素

元素	说明
configuration	每个配置文件中的根元素，常用语言 runtime 和 .NET Framework 应用程序会使用这些文件。
runtime	包含程序集绑定和垃圾回收的相关信息。

示例

1.下面的示例显示如何将一个程序集版本重定向到另一个版本并提供基本代码。

<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"/>
            <codeBase version="2.0.0.0"
                      href="http://www.litwareinc.com/myAssembly.dll"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

2.下面的示例显示如何使用 appliesTo 特性重定向 .NET Framework 程序集绑定。

<runtime>
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
      <dependentAssembly>
         <assemblyIdentity name="mscorcfg" publicKeyToken="b03f5f7f11d50a3a" culture=""/>
         <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.3300.0"/>
      </dependentAssembly>
   </assemblyBinding>
</runtime>

二.<dependentAssembly> 元素

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

<dependentAssembly> </dependentAssembly>

特性和元素

子元素

元素	说明
assemblyIdentity	包含关于该程序集的标识信息。 此元素必须包含在每个 dependentAssembly 元素中。
codeBase	如果计算机上未安装共享程序集，指定运行时可在何处找到共享程序集。
bindingRedirect	将一个程序集版本重定向到另一个版本。
publisherPolicy	指定运行时是否应用此程序集的出版商策略。

父元素

元素	说明
assemblyBinding	包含有关程序集版本重定向和程序集位置的信息。
configuration	每个配置文件中的根元素，常用语言 runtime 和 .NET Framework 应用程序会使用这些文件。
runtime	包含程序集绑定和垃圾回收的相关信息。

示例

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <!--Redirection and codeBase policy for myAssembly.-->
         </dependentAssembly>
         <dependentAssembly>
            <assemblyIdentity name="mySecondAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <!--Redirection and codeBase policy for mySecondAssembly.-->
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>