Elemento <bindingRedirect>
Redirige una versión de ensamblado a otra versión.
Elemento <configuration>
Elemento <runtime>
Elemento <assemblyBinding>
Elemento <dependentAssembly>
Elemento <bindingRedirect>
<bindingRedirect
oldVersion="old assembly version"
newVersion="new assembly version"/>
Atributos y elementos
Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
oldVersion |
Atributo requerido. 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 requerido. Especifica la versión de ensamblado utilizada, 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 |
Es el elemento raíz de cada archivo de configuración que utilizan las aplicaciones 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 crea 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 indicador 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