<bindingRedirect > elemento<bindingRedirect> Element

Redirige una versión de ensamblado a otra versión.Redirects one assembly version to another.

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

SintaxisSyntax

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

Atributos y elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
oldVersion Atributo necesario.Required attribute.

Especifica la versión del ensamblado solicitada originalmente.Specifies the version of the assembly that was originally requested. El formato de un número de versión del ensamblado es principal.secundaria.compilación.revisión.The format of an assembly version number is 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.Valid values for each part of this version number are 0 to 65535.

También se puede especificar un intervalo de versiones con el siguiente formato:You can also specify a range of versions in the following format:

n.n.n.n - n.n.n.nn.n.n.n - n.n.n.n
newVersion Atributo necesario.Required attribute.

Especifica la versión del ensamblado que se va a usar en lugar de la versión solicitada inicialmente en el formato: n.n.n.nSpecifies the version of the assembly to use instead of the originally requested version in the format: n.n.n.n

Este valor puede especificar una versión anterior a oldVersion.This value can specify an earlier version than oldVersion.

Elementos secundariosChild Elements

ElementoElement DescripciónDescription
NingunaNone

Elementos primariosParent Elements

ElementoElement DescripciónDescription
assemblyBinding Contiene información sobre la redirección de versiones de ensamblado y las ubicaciones de ensamblados.Contains information about assembly version redirection and the locations of assemblies.
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
dependentAssembly Encapsula la directiva de enlace y la ubicación de cada ensamblado.Encapsulates binding policy and assembly location for each assembly. Use un elemento dependentAssembly para cada ensamblado.Use one dependentAssembly element for each assembly.
runtime Contiene información del enlace del ensamblado y de la recolección de elementos no utilizados.Contains information about assembly binding and garbage collection.

ComentariosRemarks

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.When you build a .NET Framework application against a strong-named assembly, the application uses that version of the assembly at run time by default, even if a new version is available. No obstante, la aplicación puede configurarse para ejecutarla en una versión más reciente del ensamblado.However, you can configure the application to run against a newer version of the assembly. Para obtener más información sobre cómo el runtime usa estos archivos para determinar qué versión del ensamblado, vea How the Runtime Locates Assemblies.For details on how the runtime uses these files to determine which assembly version to use, see How the Runtime Locates Assemblies.

Se puede redirigir más de una versión de ensamblado con la inclusión de varios elementos bindingRedirect en un elemento dependentAssembly.You can redirect more than one assembly version by including multiple bindingRedirect elements in a dependentAssembly element. También puede redirigirse de una versión más reciente a una versión anterior del ensamblado.You can also redirect from a newer version to an older version of the assembly.

Para realizar una redirección de enlaces de ensamblado de forma explícita en un archivo de configuración, se precisa permiso de seguridad.Explicit assembly binding redirection in an application configuration file requires a security permission. Esto se aplica a la redirección de los ensamblados de .NET Framework y de los ensamblados de otros proveedores.This applies to redirection of .NET Framework assemblies and assemblies from third parties. El permiso se otorga estableciendo el SecurityPermissionFlag marca en el SecurityPermission.The permission is granted by setting the SecurityPermissionFlag flag on the SecurityPermission. Para obtener más información, consulte permiso de seguridad de redirección de enlace de ensamblado.For more information, see Assembly Binding Redirection Security Permission.

EjemploExample

En el ejemplo siguiente se muestra cómo redirigir una versión de ensamblado a otra versión.The following example shows how to redirect one assembly version to another.

<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énSee also