Partager via

<bindingRedirect> Élément

Redirige une version d’assembly vers une autre.

<Configuration>
   <Duree>
     <assemblyBinding>
       <dépendanceAssembly>
         <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.

Attributes

Caractéristique Descriptif
oldVersion Attribut obligatoire.

Spécifie la version de l’assembly qui a été demandée à l’origine. 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 sont 0 à 65535.

Vous pouvez également spécifier une plage de versions au format suivant :

n.n.n.n - n.n.n.n.n.n
newVersion Attribut obligatoire.

Spécifie la version de l’assembly à utiliser au lieu de la version demandée à l’origine au format : n.n.n.n.n

Cette valeur peut spécifier une version antérieure à oldVersion.

Éléments enfants

Élément Descriptif
Aucun

Éléments parents

Élément Descriptif
assemblyBinding Contient des informations sur la redirection de version d’assembly et les emplacements des assemblys.
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 liaison et l’emplacement de l’assembly pour chaque assembly. Utilisez un élément dépendantAssembly pour chaque assembly.
runtime Contient des informations sur la liaison d’assembly et le garbage collection.

Remarques

Lorsque vous générez une application .NET Framework sur un assembly nommé fort, l’application utilise cette version de l’assembly au moment de l’exécution par défaut, même si une nouvelle version est disponible. Toutefois, vous pouvez configurer l’application pour qu’elle s’exécute sur une version plus récente de l’assembly. Pour plus d’informations sur la façon dont le runtime utilise ces fichiers pour déterminer la version d’assembly à utiliser, consultez Comment le runtime localise les assemblys.

Vous pouvez rediriger plusieurs versions d’assembly en incluant plusieurs bindingRedirect éléments dans un dependentAssembly élément. Vous pouvez également rediriger d’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 d’application nécessite une autorisation de sécurité. Cela s’applique à la redirection d’assemblys et d’assemblys .NET Framework provenant de tiers. L’autorisation est accordée en définissant l’indicateur SecurityPermissionFlag sur le SecurityPermission. Pour plus d’informations, consultez l’autorisation de sécurité de la redirection de liaison d’assembly.

Example

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

  • Last updated on