<bindingRedirect>, élément

Article
05/10/2023

Redirige une version d'assembly vers une autre.

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

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`oldVersion`	Attribut requis. Spécifie la version de l'assembly demandée initialement. Le format d’un numéro de version d’assembly est major.minor.build.revision. Les valeurs valides pour chaque partie de ce numéro de version vont de 0 à 65535. Vous pouvez également spécifier une plage de versions en respectant le format suivant : n.n.n.n - n.n.n.n
`newVersion`	Attribut requis. Spécifie la version de l’assembly à utiliser en lieu et place de la version initialement demandée, dans le format : n.n.n.n Cette valeur peut spécifier une version antérieure à `oldVersion`.

Éléments enfants

Élément	Description
None

Éléments parents

Élément	Description
`assemblyBinding`	Contient des informations à propos de la redirection des versions d'assemblys et de l'emplacement de ces derniers.
`configuration`	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
`dependentAssembly`	Encapsule la stratégie de liaisons et l’emplacement de chaque assembly. Utilisez un élément dependentAssembly pour chaque assembly.
`runtime`	Contient des informations sur les liaisons d’assembly et l’opération garbage collection.

Notes

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. 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. Pour savoir comment le runtime utilise ces fichiers pour déterminer quelle version d’assembly utiliser, consultez Comment le runtime localise les assemblys.

Vous pouvez rediriger plusieurs versions d'assembly en incluant plusieurs éléments bindingRedirect dans un élément dependentAssembly. Vous pouvez également rediriger une version plus récente vers une version antérieure de l'assembly.

La redirection de liaison d’assembly explicite dans un fichier de configuration de l’application nécessite une autorisation de sécurité. Cela s'applique à la redirection des assemblys .NET Framework et des assemblys tiers. L’autorisation est accordée en définissant l’indicateur SecurityPermissionFlag sur SecurityPermission. Pour plus d’informations, consultez Autorisation de sécurité pour la redirection de liaison d’assembly.

Exemple

L'exemple suivant montre comment rediriger une version d'assembly vers une autre.

<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>