<Элемент bindingRedirect>

  • Статья

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

<Конфигурации>
  <Среды выполнения>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Синтаксис

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

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

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

Атрибуты

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

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

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

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

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

Это значение может указывать более раннюю версию, чем oldVersion.

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

Элемент Описание
Нет

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

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

Комментарии

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

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

Для явного перенаправления привязки сборки в файле конфигурации приложения необходимо разрешение безопасности. Это относится к перенаправлению как сборок платформы .NET Framework, так и сторонних сборок. Разрешение предоставляется путем установки флага SecurityPermissionFlag для 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>

См. также раздел