Бөлісу құралы:

<bindingRedirect> Элемент

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

<configuration>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Синтаксис

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

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

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

Attributes

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

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

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

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

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

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

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

Элемент Description
None

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

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

Замечания

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

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

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

Example

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

<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>

См. также

  • Last updated on