Элемент <qualifyAssembly>

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

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

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

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

Атрибуты

Атрибут

Описание

partialName

Обязательный атрибут.

Неполное имя сборки в том виде, в котором оно указано в коде.

fullName

Обязательный атрибут.

Полное имя сборки в том виде, в котором оно указано в глобальном кэше сборок.

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

Отсутствует.

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

Элемент

Описание

assemblyBinding

Содержит сведения о перенаправлении версии сборки и о расположении сборок.

configuration

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

runtime

Содержит сведения о привязке сборок и сборке мусора.

Заметки

При вызове метода Assembly.Load с использованием неполного имени сборки среда CLR выполняет поиск сборки только в базовой папке приложения. Для предоставления полных сведений о сборке (имени, версии, маркера открытого ключа, а также языка и региональных параметров) и для поиска сборки средой CLR в глобальном кэше сборок необходимо использовать элемент <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>

См. также

Ссылки

Схема параметров среды выполнения

Основные понятия

Обнаружение сборок в среде выполнения

Частичные ссылки на сборки