Elemento <bindingRedirect>

  • Artículo

Redirige una versión de ensamblado a otra versión.

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

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
oldVersion Atributo necesario.

Especifica la versión del ensamblado solicitada originalmente. El formato de un número de versión del ensamblado es major.minor.build.revision. Los valores válidos para cada una de las partes de este número de versión van del 0 al 65535.

También se puede especificar un intervalo de versiones con el siguiente formato:

n.n.n.n - n.n.n.n
newVersion Atributo necesario.

Especifica la versión del ensamblado que se va a usar, en lugar de la versión solicitada originalmente, con el formato: n.n.n.n

Este valor puede especificar una versión anterior a oldVersion.

Elementos secundarios

Elemento Descripción
Ninguno

Elementos primarios

Elemento Descripción
assemblyBinding Contiene información sobre la redirección de versiones de ensamblado y las ubicaciones de ensamblados.
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
dependentAssembly Encapsula la directiva de enlace y la ubicación de cada ensamblado. Use un elemento dependentAssembly para cada ensamblado.
runtime Contiene información del enlace del ensamblado y de la recolección de elementos no utilizados.

Comentarios

Al compilar una aplicación .NET Framework en un ensamblado con nombre seguro, la aplicación usa esa versión del ensamblado en tiempo de ejecución de forma predeterminada, aunque haya disponible otra versión posterior. No obstante, la aplicación puede configurarse para ejecutarla en una versión más reciente del ensamblado. Para obtener información detallada sobre cómo el runtime usa estos archivos para determinar la versión del ensamblado que se va a emplear, vea el tema sobre cómo el runtime busca ensamblados.

Se puede redirigir más de una versión de ensamblado con la inclusión de varios elementos bindingRedirect en un elemento dependentAssembly. También puede redirigirse de una versión más reciente a una versión anterior del ensamblado.

Para realizar una redirección de enlaces de ensamblado de forma explícita en un archivo de configuración, se precisa permiso de seguridad. Esto se aplica a la redirección de los ensamblados de .NET Framework y de los ensamblados de otros proveedores. El permiso se obtiene al establecer la marca SecurityPermissionFlag en SecurityPermission. Para obtener más información, consulta Permiso de seguridad para la redirección de enlace de ensamblados.

Ejemplo

En el ejemplo siguiente se muestra cómo redirigir una versión de ensamblado a otra versión.

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

Consulte también