<qualifyAssembly> 元素

  • 项目

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

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

请参阅