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