通过

<qualifyAssembly> 元素

  • 项目

更新：2007 年 11 月

指定当使用程序集的部分名称时应动态加载的程序集全名。

<configuration> 元素
  <runtime> 元素
    <runtime> -> <assemblyBinding> 元素
      <qualifyAssembly> 元素

<qualifyAssembly partialName="PartialAssemblyName"
                                  fullName="FullAssemblyName"/>

属性和元素

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

属性

属性

说明

partialName

必需。

指定在代码中出现的程序集的部分名称。

fullName

必需。

指定在全局程序集缓存中出现的程序集的全名。

子元素

无。

父元素

元素

说明

assemblyBinding

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

configuration

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

runtime

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

备注

如果使用程序集的部分名称调用 Assembly.Load 方法，则会导致公共语言运行库只在应用程序的基目录中查找程序集。在应用程序的配置文件中使用 <qualifyAssembly> 元素可提供程序集的全部信息（名称、版本、公钥标记和区域性），并且使公共语言运行库在全局程序集缓存中搜索程序集。

fullName 属性必须包括程序集标识的四个字段：名称、版本、公钥标记和区域性。partialName 属性必须部分地引用程序集。必须至少指定程序集的文本名称（最常见的情况），但也可以包括版本、公钥标记或区域性（或者四个字段的任意组合，但不能包括全部四个）。partialName 必须与调用中指定的名称匹配。例如，不能在配置文件中将 "math" 指定为 partialName 属性，而在代码中调用 Assembly.Load("math, Version=3.3.3.3")。

示例

下面的示例逻辑上将 Assembly.Load("math") 调用变成 Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral")。

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <qualifyAssembly partialName="math" 
                         fullName=
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>
      </assemblyBinding>
   </runtime>
</configuration>

请参见

概念

运行库如何定位程序集

部分程序集引用

参考

运行库设置架构