Élément <bindingRedirect><bindingRedirect> Element

Redirige une version d'assembly vers une autre.Redirects one assembly version to another.

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

SyntaxeSyntax

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

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
oldVersion Attribut requis.Required attribute.

Spécifie la version de l'assembly demandée initialement.Specifies the version of the assembly that was originally requested. Le format d’un numéro de version d’assembly est major. minor. Build. Revision.The format of an assembly version number is major.minor.build.revision. Les valeurs valides pour chaque partie de ce numéro de version vont de 0 à 65535.Valid values for each part of this version number are 0 to 65535.

Vous pouvez également spécifier une plage de versions en respectant le format suivant :You can also specify a range of versions in the following format:

n. n. n. n-n. n. nn.n.n.n - n.n.n.n
newVersion Attribut requis.Required attribute.

Spécifie la version de l’assembly à utiliser à la place de la version initialement demandée au format : n. n. n. nSpecifies the version of the assembly to use instead of the originally requested version in the format: n.n.n.n

Cette valeur peut spécifier une version antérieure à oldVersion.This value can specify an earlier version than oldVersion.

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
NoneNone

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
assemblyBinding Contient des informations à propos de la redirection des versions d'assemblys et de l'emplacement de ces derniers.Contains information about assembly version redirection and the locations of assemblies.
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
dependentAssembly Encapsule la stratégie de liaisons et l’emplacement de chaque assembly.Encapsulates binding policy and assembly location for each assembly. Utilisez un élément dependentAssembly pour chaque assembly.Use one dependentAssembly element for each assembly.
runtime Contient des informations sur les liaisons d’assembly et l’opération garbage collection.Contains information about assembly binding and garbage collection.

RemarquesRemarks

Lorsque vous générez une application .NET Framework basée sur un assembly avec nom fort, l'application utilise par défaut cette version de l'assembly au moment de l'exécution, même si une nouvelle version est disponible.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. Vous pouvez toutefois configurer l'application pour faire en sorte qu'elle s'exécute en utilisant une version plus récente de l'assembly.However, you can configure the application to run against a newer version of the assembly. Pour plus d’informations sur la façon dont le runtime utilise ces fichiers pour déterminer la version de l’assembly à utiliser, consultez la manière dont le runtime localise les assemblys.For details on how the runtime uses these files to determine which assembly version to use, see How the Runtime Locates Assemblies.

Vous pouvez rediriger plusieurs versions d'assembly en incluant plusieurs éléments bindingRedirect dans un élément dependentAssembly.You can redirect more than one assembly version by including multiple bindingRedirect elements in a dependentAssembly element. Vous pouvez également rediriger une version plus récente vers une version antérieure de l'assembly.You can also redirect from a newer version to an older version of the assembly.

La redirection de liaison d’assembly explicite dans un fichier de configuration de l’application nécessite une autorisation de sécurité.Explicit assembly binding redirection in an application configuration file requires a security permission. Cela s'applique à la redirection des assemblys .NET Framework et des assemblys tiers.This applies to redirection of .NET Framework assemblies and assemblies from third parties. L’autorisation est accordée en définissant l' SecurityPermissionFlag indicateur sur SecurityPermission .The permission is granted by setting the SecurityPermissionFlag flag on the SecurityPermission. Pour plus d’informations, consultez autorisation de sécurité pour la redirection des liaisons d’assembly.For more information, see Assembly Binding Redirection Security Permission.

ExempleExample

L'exemple suivant montre comment rediriger une version d'assembly vers une autre.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>  

Voir aussiSee also