<qualifyAssembly> 元素

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

<配置>
   <运行时>
     <assemblyBinding>
       <qualifyAssembly>

Syntax

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

特性和元素

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

特性

Attribute Description
partialName 必需属性。

指定程序集在代码中显示的部分名称。
fullName 必需属性。

指定程序集在全局程序集缓存中显示的全名。

子元素

没有。

父元素

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

注解

Assembly.Load使用部分程序集名称调用该方法会导致公共语言运行时仅在应用程序基目录中查找程序集。 <qualifyAssembly>使用应用程序配置文件中的元素提供完整的程序集信息(名称、版本、公钥令牌和区域性),并导致公共语言运行时在全局程序集缓存中搜索程序集。

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

Example

以下示例在逻辑上将调用 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>

另请参阅