Элемент <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>
См. также
Ссылки
Схема параметров среды выполнения