Configuration de la liaison d'assembly

  • Article

Par défaut, les applications utilisent le jeu d'assemblys .NET Framework fourni avec la version du runtime utilisée pour compiler l'application. Vous pouvez utiliser l'attribut appliesTo sur l'élément <assemblyBinding> dans un fichier de configuration de l'application pour rediriger les références de liaison d'assembly vers une version spécifique des assemblys .NET Framework. Cet attribut facultatif utilise un numéro de version .NET Framework pour indiquer la version à laquelle il s'applique. Si aucun attribut appliesTo n'est spécifié, l'élément <assemblyBinding> s'applique à toutes les versions du .NET Framework.

L'attribut appliesTo a été introduit dans le .NET Framework version 1.1 ; il est ignoré par le .NET Framework version 1.0. Cela signifie que tous les éléments <assemblyBinding> sont appliqués lorsque vous utilisez le .NET Framework version 1.0, même si un attribut appliesTo est spécifié.

Notes

Utilisez l'attribut appliesTo pour limiter la redirection de liaison d'assembly vers une version spécifique du runtime.

Par exemple, pour rediriger la liaison d'assembly pour un assembly .NET Framework version 1.0, vous devez inclure le code XML suivant dans votre fichier de configuration de l'application.

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly> 
               * assembly information goes here *
            </dependentAssembly>
       </assemblyBinding>
</runtime>

Les éléments <assemblyBinding> respectent l'ordre. Ainsi, vous devez d'abord entrer les informations de redirection des liaisons des assemblys du .NET Framework version 1.0, suivies de celles des assemblys du .NET Framework version 1.1. Enfin, vous devez entrer les informations de redirection des liaisons d'assembly pour toutes les redirections d'assembly du .NET Framework qui n'utilisent pas l'attribut appliesTo et s'appliquent donc à toutes les versions du .NET Framework. En cas de conflit de redirection, la première instruction de redirection correspondante du fichier de configuration est utilisée.

Par exemple, pour rediriger une référence à un assembly du .NET Framework version 1.0 et une autre à un assembly du .NET Framework version 1.1, utilisez le modèle indiqué dans le pseudo-code suivant.

<assemblyBinding xmlns="..." appliesTo="v1.0.3705"> 
<! — .NET Framework version 1.0 redirects here. --> 
</assemblyBinding> 

<assemblyBinding xmlns="..." appliesTo="v1.1.4322"> 
    <! — .NET Framework version 1.1 redirects here. --> 
</assemblyBinding> 

<assemblyBinding xmlns="..."> 
<!-- Redirects meant for all versions of the .NET Framework. --> 
</assemblyBinding>

Voir aussi

Tâches

Comment : utiliser un fichier de configuration de l'application pour cibler une version du .NET Framework

Concepts

Débogage des erreurs de fichier de configuration
Redirection de liaison d'assembly
Détermination de la version du runtime à charger