Configuration de la liaison d’assembly

Par défaut, les applications utilisent l’ensemble d’assemblys .NET Framework fournis 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 d’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 elle s’applique. Si aucun attribut n’est appliesTo spécifié, l’élément <assemblyBinding> s’applique à toutes les versions du .NET Framework.

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

Par exemple, pour rediriger la liaison d’assembly pour un assembly du .NET Framework 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> sont sensibles à l'ordre. Ainsi, vous devez d’abord entrer les informations de redirection des liaisons des assemblys du .NET Framework 1.0, puis celles des assemblys du .NET Framework 1.1. Enfin, entrez les informations de redirection de liaison d’assemblage pour toute redirection d’assemblage .NET Framework qui n’utilise pas l’attribut appliesTo et qui s’applique donc à toutes les versions du .NET Framework. En cas de conflit dans la redirection, la première instruction de redirection correspondante dans le fichier de configuration est utilisée.

Par exemple, pour rediriger une référence vers un assembly .NET Framework version 1.0 et une autre référence à un assembly .NET Framework version 1.1, vous utiliserez le modèle indiqué dans le pseudocode 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>

Débogage des erreurs de fichier de configuration

Le runtime analyse les fichiers de configuration une fois lorsqu’un domaine d’application est créé et charge du code dans ce domaine d’application. Le Common Language Runtime gère les erreurs dans un fichier de configuration en ignorant l’entrée. Le runtime ignore l’intégralité du fichier de configuration s’il contient du code XML incorrect. Pour le code XML non valide, seules les sections non valides sont ignorées.

Vous pouvez déterminer si un fichier de configuration est actuellement utilisé en vérifiant si des redirections de liaison d’assembly ont lieu. Utilisez la Visionneuse du journal de liaison d’assembly (Fuslogvw.exe) pour voir quels assemblys sont chargés. Pour afficher toutes les liaisons d’assembly, vous devez définir une entrée pour ForceLog dans le Registre.

Voir aussi

• Procédure : Activer et désactiver la redirection de liaison automatique