Partager via


<bindingRedirect>, élément

Redirige une version d'assembly vers une autre.

<configuration>, élément
  <runtime>, élément
    <assemblyBinding>, élément
      <dependentAssembly>, élément
        <bindingRedirect>, élément

<bindingRedirect  
   oldVersion="old 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. Un numéro de version d'assembly suit le format 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

Éléments enfants

Élément Description

Aucun

Éléments parents

Élément Description

assemblyBinding

Contient des informations sur la redirection des versions des assemblys et sur 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 plus d'informations sur la façon dont le code runtime utilise ces fichiers afin de déterminer la version de l'assembly à utiliser, consultez Méthode de localisation des assemblys par le runtime.

Vous pouvez rediriger plusieurs versions d'assembly en incluant plusieurs éléments bindingRedirect dans un élément dependentAssembly.

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 BindingRedirects sur la classe 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>

Voir aussi

Référence

Schéma des paramètres d'exécution

Concepts

Redirection des versions d'assemblys

Autres ressources

Schéma des fichiers de configuration pour le .NET Framework