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


Элемент <bindingRedirect>

Перенаправление одной версии сборки к другой.

<bindingRedirect  
   oldVersion="old assembly version"
   newVersion="new assembly version"/>

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

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

Атрибуты

Атрибут

Описание

oldVersion

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

Задание первоначально запрошенной версии сборки. Формат номера версии сборки — основной.дополнительный.построение.редакция. Для каждой части этого номера версии допустимо использовать значения от 0 до 65535.

Кроме того, можно задать диапазон версий в следующем формате:

n.n.n.n - n.n.n.n

newVersion

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

Задание версии сборки, которая будет использоваться вместо первоначально запрошенной, в формате n.n.n.n

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

Элемент

Описание

Нет

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

Элемент

Описание

assemblyBinding

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

configuration

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

dependentAssembly

Инкапсуляция политики привязки и расположения для каждой сборки. Для каждой сборки используется только один элемент dependentAssembly.

runtime

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

Заметки

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

Перенаправление нескольких версий сборок можно выполнить, включив в элемент dependentAssembly несколько элементов bindingRedirect.

Для явного перенаправления привязки сборки в файле конфигурации приложения необходимо разрешение безопасности. Это относится к перенаправлению как сборок платформы .NET Framework, так и сторонних сборок. Разрешение можно получить путем установки флага BindingRedirects в классе SecurityPermission. Дополнительные сведения см. в разделе Разрешение безопасности перенаправления привязки сборок.

Пример

В следующем примере показан способ перенаправления одной версии сборки на другую.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <bindingRedirect oldVersion="1.0.0.0"
                             newVersion="2.0.0.0"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

См. также

Ссылки

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

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

Перенаправление версий сборки

Другие ресурсы

Схема файлов конфигурации для .NET Framework