Compartir a través de


Elemento <bindingRedirect>

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

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

Atributos y elementos

En las secciones siguientes 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 inicialmente. El formato de un número de versión de ensamblado es major.minor.build.revision. Los valores aceptados para cada parte de este número de versión van de 0 a 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 de ensamblado que se va a utilizar, en vez de la versión solicitada inicialmente, con el formato: n.n.n.n.

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. Utilice un elemento dependentAssembly para cada ensamblado.

runtime

Contiene información del enlace del ensamblado y del recolector de elementos no utilizados.

Comentarios

Cuando se compila una aplicación de .NET Framework mediante un ensamblado con nombre seguro, la aplicación utiliza de forma predeterminada esa versión de ensamblado en tiempo de ejecución, aunque esté disponible otra versión más moderna. No obstante, se puede configurar la aplicación para ejecutarla con una versión más actual del ensamblado. Para obtener información sobre cómo utiliza estos archivos el motor de ejecución para determinar la versión del ensamblado, vea Cómo el motor de ejecución ubica los ensamblados.

Se pueden redirigir varias versiones de un ensamblado incluyendo varios elementos bindingRedirect en un elemento dependentAssembly.

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 otorga estableciendo el marcador de BindingRedirects en la clase SecurityPermission. Para obtener más información, vea Permiso de seguridad para la redirección de enlace de ensamblados.

Ejemplo

En el siguiente ejemplo 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>

Vea también

Referencia

Esquema de la configuración de Common Language Runtime

Conceptos

Redirigir versiones de ensamblado

Otros recursos

Esquema de los archivos de configuración de .NET Framework