Configurar la redirección del enlace de ensamblados

Actualización: noviembre 2007

De forma predeterminada, las aplicaciones utilizan el conjunto de ensamblados de .NET Framework que se suministra con la versión del motor en tiempo de ejecución utilizada para compilar la aplicación. Se puede utilizar el atributo appliesTo en el elemento <assemblyBinding> de un archivo de configuración de la aplicación para redirigir referencias de enlaces de ensamblados a una versión específica de .NET Framework. Este atributo opcional utiliza un número de versión de .NET Framework para indicar la versión a la que se aplica. Si se especifica el atributo appliesTo, el elemento <assemblyBinding> se aplica a todas las versiones de .NET Framework.

El atributo appliesTo se ha incluido por vez primera en la versión 1.1 de .NET Framework; la versión 1.0 de .NET Framework omite este atributo. Esto significa que se aplican todos los elementos <assemblyBinding> cuando se utiliza la versión 1.0 de .NET Framework, aunque se especifique un atributo appliesTo.

Nota:

Utilice el atributo appliesTo para limitar la redirección de enlaces de ensamblados a una versión específica del motor en tiempo de ejecución.

Por ejemplo, para redirigir enlaces de ensamblados a la versión 1.0 de .NET Framework, debe incluir el siguiente código XML en el archivo de configuración de la aplicación.

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly> 
               * assembly information goes here *
            </dependentAssembly>
       </assemblyBinding>
</runtime>

Los elementos <assemblyBinding> tienen en cuenta el orden. Debe especificar primero la información de redirección del enlace de ensamblados para cualquier ensamblado de la versión 1.0 de .NET Framework, seguida de la información de redirección del enlace de ensamblados para cualquier ensamblado de la versión 1.1 de .NET Framework. Por último, escriba la información de redirección del enlace de ensamblados para cualquier redirección de ensamblados que no utilice el atributo appliesTo y que, por tanto, se aplique a todas las versiones de .NET Framework. En caso de que se produzca un conflicto en la redirección, se utiliza la primera instrucción de redirección coincidente del archivo de configuración.

Por ejemplo, para redirigir una referencia a un ensamblado de la versión 1.0 de .NET Framework y otra referencia a un ensamblado de la versión 1.1 de .NET Framework, debe utilizar el modelo que se muestra en el siguiente pseudocódigo.

<assemblyBinding xmlns="..." appliesTo="v1.0.3705"> 
<! — .NET Framework version 1.0 redirects here. --> 
</assemblyBinding> 

<assemblyBinding xmlns="..." appliesTo="v1.1.4322"> 
    <! — .NET Framework version 1.1 redirects here. --> 
</assemblyBinding> 

<assemblyBinding xmlns="..."> 
<!-- Redirects meant for all versions of the .NET Framework. --> 
</assemblyBinding>

Vea también

Tareas

Cómo: Utilizar el archivo de configuración de una aplicación para determinar la versión de .NET Framework que se va a usar

Conceptos

Depurar errores de archivos de configuración

Redirección del enlace de ensamblados

Determinar qué versión del motor en tiempo de ejecución debe cargarse