<bindingRedirect>, élément
Mise à jour : novembre 2007
Redirige une version d'assembly vers une autre.
<configuration>, élément
<runtime>, élément
<assemblyBinding>, élément de <runtime>
<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
Concepts
Redirection des versions d'assemblys
Référence
Schéma des paramètres d'exécution