Поделиться через


<qualifyAssembly> Элемент

Указывает полное имя сборки, которая должна быть динамически загружена при использовании частичного имени.

<конфигурация>
   <среда выполнения>
     <assemblyBinding>
       <qualifyAssembly>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Attributes

Свойство Description
partialName Обязательный атрибут.

Указывает частичное имя сборки, как она отображается в коде.
fullName Обязательный атрибут.

Указывает полное имя сборки, как она отображается в глобальном кэше сборок.

Дочерние элементы

Нет.

Родительские элементы

Элемент Description
assemblyBinding Содержит сведения о перенаправлении версий сборки и расположениях сборок.
configuration Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.
runtime Содержит сведения о привязке сборки и сборке мусора.

Замечания

Assembly.Load Вызов метода с использованием частичных имен сборок приводит к тому, что среда CLR ищет сборку только в базовом каталоге приложения. <qualifyAssembly> Используйте элемент в файле конфигурации приложения, чтобы предоставить полные сведения о сборке (имя, версия, маркер открытого ключа и язык и региональные параметры) и вызвать среду CLR для поиска сборки в глобальном кэше сборок.

Атрибут 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>

См. также