Partager via

Meilleures pratiques pour le chargement d'assembly

  • Article

Remarque

Cet article est spécifique au .NET Framework. Ceci ne s’applique pas aux implémentations plus récentes de .NET, y compris .NET 6 et ultérieur.

Cet article explique les moyens d’éviter les problèmes d’identités de type qui peuvent générer des exceptions InvalidCastException et MissingMethodException, et d’autres erreurs. L’article aborde les recommandations suivantes :

La première recommandation, comprendre les avantages et inconvénients des contextes de chargement, fournit des informations générales pour les autres recommandations, car elles dépendent toutes d’une connaissance des contextes de chargement.

Comprendre les avantages et les inconvénients des contextes de chargement

Dans un domaine d’application, les assemblys peuvent être chargés dans un contexte parmi trois, ou peuvent être chargés sans contexte :

  • Le contexte de chargement par défaut contient les assemblys trouvés en recherchant dans le Global Assembly Cache, dans le magasin d’assemblys de l’hôte si le runtime est hébergé (par exemple dans SQL Server), et dans le ApplicationBase et le PrivateBinPath du domaine d’application. La plupart des surcharges de la méthode Load chargent les assemblys dans ce contexte.

  • Le contexte de chargement source contient des assemblys chargés à partir d’emplacements où le chargeur ne fait pas de recherche. Par exemple, des compléments peuvent être installés dans un répertoire qui n’est pas sous le chemin de l’application. Assembly.LoadFrom, AppDomain.CreateInstanceFrom et AppDomain.ExecuteAssembly sont des exemples de méthodes qui sont chargées via un chemin.

  • Le contexte de réflexion uniquement contient des assemblys chargés avec les méthodes ReflectionOnlyLoad et ReflectionOnlyLoadFrom. Le code de ce contexte ne peut pas être exécuté et il n’est donc pas abordé ici. Pour plus d’informations, consultez Guide pratique pour charger des assemblys dans le contexte de réflexion uniquement.

  • Si vous avez généré un assembly dynamique transitoire en utilisant l’émission par réflexion, l’assembly ne se trouve dans aucun contexte. En outre, la plupart des assemblys chargés à l’aide de la méthode LoadFile sont chargés sans contexte, et les assemblys qui sont chargés à partir de tableaux d’octets sont chargés sans contexte, à moins que leur identité (une fois que la stratégie est appliquée) établisse qu’ils se trouvent dans le Global Assembly Cache.

Les contextes d’exécution présentent des avantages et des inconvénients, qui sont présentés dans les sections suivantes.

Contexte de chargement par défaut

Quand les assemblys sont chargés dans le contexte de chargement par défaut, leurs dépendances sont chargées automatiquement. Les dépendances qui sont chargées dans le contexte de chargement par défaut sont trouvées automatiquement pour les assemblys dans le contexte de chargement par défaut ou dans le contexte de chargement source. Le chargement par identité d’assembly augmente la stabilité des applications en vérifiant que des versions inconnues des assemblys ne sont pas utilisées (consultez la section Éviter la liaison sur les noms d’assemblys partiels).

L’utilisation du contexte de chargement par défaut a les inconvénients suivants :

  • Les dépendances chargées dans d’autres contextes ne sont pas disponibles.

  • Vous ne pouvez pas charger des assemblys à partir d’emplacements qui sont en dehors du chemin de recherche dans le contexte de chargement par défaut.

Contexte de chargement source

Le contexte de chargement source vous permet de charger un assembly à partir d’un chemin qui n’est pas sous le chemin de l’application et qui n’est par conséquent pas inclus dans la recherche. Il permet la localisation et le chargement des dépendances à partir de ce chemin, car les informations du chemin sont gérées par le contexte. En outre, les assemblys de ce contexte peuvent utiliser les dépendances qui sont chargées dans le contexte de chargement par défaut.

Le chargement des assemblys à l’aide de la méthode Assembly.LoadFrom ou de l’une des autres méthodes qui chargent via un chemin a les inconvénients suivants :

  • Si un assembly avec la même identité est déjà chargé dans le contexte de chargement source, LoadFrom retourne l’assembly chargé même si un autre chemin a été spécifié.

  • Si un assembly est chargé avec LoadFrom et qu’ultérieurement, un assembly du contexte de chargement par défaut essaie de charger le même assembly via le nom d’affichage, la tentative de chargement échoue. Ceci peut se produire quand un assembly est désérialisé.

  • Si un assembly est chargé avec LoadFrom et que le chemin de recherche inclut un assembly avec la même identité mais à un emplacement différent, une InvalidCastException, MissingMethodException ou un autre comportement inattendu peut se produire.

  • LoadFrom demande FileIOPermissionAccess.Read et FileIOPermissionAccess.PathDiscovery, ou WebPermission, sur le chemin spécifié.

  • S’il existe une image native pour l’assembly, elle n’est pas utilisée.

  • L’assembly ne peut pas être chargé comme étant indépendant du domaine.

  • Dans les versions 1.0 et 1.1 du .NET Framework, la stratégie n’est pas appliquée.

Pas de contexte

Le chargement sans contexte est la seule option pour les assemblys transitoires générés avec l’émission par réflexion. Le chargement sans contexte est la seule façon de charger plusieurs assemblys qui ont la même identité dans un même domaine d’application. Ceci permet d’éviter le coût lié à la recherche.

Les assemblys chargés à partir de tableaux d’octets sont chargés sans contexte, sauf si l’identité de l’assembly, qui est établie quand la stratégie est appliquée, correspond à l’identité d’un assembly dans le Global Assembly Cache. Dans ce cas, l’assembly est chargé à partir du Global Assembly Cache.

Le chargement d’assemblys sans contexte a les inconvénients suivants :

  • D’autres assemblys ne peuvent pas se lier aux assemblys qui sont chargés sans contexte, sauf si vous gérez l’événement AppDomain.AssemblyResolve.

  • Les dépendances ne sont pas chargées automatiquement. Vous pouvez les précharger sans contexte, les précharger dans le contexte de chargement par défaut ou les charger en gérant l’événement AppDomain.AssemblyResolve.

  • Le chargement de plusieurs assemblys avec la même identité sans contexte peut provoquer des problèmes d’identité de type similaires à ceux provoqués par le chargement d’assemblys avec la même identité dans plusieurs contextes. Consultez Éviter de charger un assembly dans plusieurs contextes.

  • S’il existe une image native pour l’assembly, elle n’est pas utilisée.

  • L’assembly ne peut pas être chargé comme étant indépendant du domaine.

  • Dans les versions 1.0 et 1.1 du .NET Framework, la stratégie n’est pas appliquée.

Éviter la liaison sur les noms d’assemblys partiels

Une liaison de nom partiel se produit quand vous ne spécifiez qu’une partie du nom d’affichage de l’assembly (FullName) quand vous chargez un assembly. Par exemple, vous pouvez appeler la méthode Assembly.Load avec seulement le nom simple de l’assembly, en omettant la version, la culture et le jeton de clé publique. Vous pouvez aussi appeler la méthode Assembly.LoadWithPartialName, qui appelle d’abord la méthode Assembly.Load et qui, en cas d’échec de la localisation de l’assembly, recherche dans le Global Assembly Cache et charge la dernière version disponible de l’assembly.

Une liaison de nom partiel peut provoquer de nombreux problèmes, notamment les suivants :

  • La méthode Assembly.LoadWithPartialName peut charger un autre assembly portant le même nom simple. Par exemple, deux applications peuvent installer deux assemblys complètement différents qui ont tous deux le nom simple GraphicsLibrary dans le Global Assembly Cache.

  • L’assembly qui est actuellement chargé risque de ne pas être à compatibilité descendante. Par exemple, le fait de ne pas spécifier la version risque d’aboutir au chargement d’une version beaucoup plus récente que la version pour laquelle votre programme a été écrit à l’origine. Des modifications dans la version plus récente peuvent provoquer des erreurs dans votre application.

  • L’assembly qui est actuellement chargé risque de ne pas être à compatibilité ascendante. Par exemple, vous pouvez avoir généré et testé votre application avec la version la plus récente d’un assembly, mais une liaison partielle peut charger une version beaucoup plus ancienne où des fonctionnalités utilisées par votre application sont absentes.

  • L’installation de nouvelles applications peut endommager des applications existantes. Une application qui utilise la méthode LoadWithPartialName peut être endommagée en raison de l’installation d’une version plus récente et incompatible d’un assembly partagé.

  • Le chargement d’une dépendance inattendue peut se produire. Si vous chargez deux assemblys qui partagent une dépendance, leur chargement avec une liaison partielle peut aboutir à ce qu’un assembly utilise un composant avec lequel il n’a pas été généré ou testé.

En raison des problèmes qu’elle peut provoquer, la méthode LoadWithPartialName a été marquée comme étant dépréciée. Nous vous recommandons d’utiliser à la place la méthode Assembly.Load et de spécifier des noms d’affichage d’assemblys complets. Consultez Comprendre les avantages et les inconvénients des contextes de chargement et Envisager de basculer vers le contexte de chargement par défaut.

Si vous voulez utiliser la méthode LoadWithPartialName car elle facilite le chargement des assemblys, prenez en compte le fait que si votre application échoue avec un message d’erreur qui identifie l’assembly manquant, ceci est probablement susceptible de fournir une meilleure expérience utilisateur, au contraire de l’utilisation automatique d’une version inconnue de l’assembly, qui peut entraîner des failles de sécurité et un comportement imprévisible.

Éviter de charger un assembly dans plusieurs contextes

Le chargement d’un assembly dans plusieurs contextes peut provoquer des problèmes d’identités de type. Si le même type est chargé à partir du même assembly dans deux contextes différents, c’est comme si deux types différents du même nom avaient été chargés. Une InvalidCastException est levée si vous essayez d’effectuer un cast d’un type à l’autre, avec un message trompeur, selon lequel le type MyType ne peut pas être converti en type MyType.

Par exemple, supposons que l’interface ICommunicate est déclarée dans un assembly nommé Utility, qui est référencé par votre programme et aussi par d’autres assemblys chargés par votre programme. Ces autres assemblys contiennent des types qui implémentent l’interface ICommunicate, permettant à votre programme de les utiliser.

Considérez à présent ce qui se passe quand votre programme est exécuté. Les assemblys référencés par votre programme sont chargés dans le contexte de chargement par défaut. Si vous chargez un assembly cible via son identité en utilisant la méthode Load, elle sera dans le contexte de chargement par défaut, comme le seront ses dépendances. Votre programme et l’assembly cible utilisent le même assembly Utility.

Supposez cependant que vous chargez l’assembly cible via son chemin de fichier en utilisant la méthode LoadFile. L’assembly est chargé sans aucun contexte, et ses dépendances ne sont donc pas chargées automatiquement. Vous pouvez avoir un gestionnaire pour l’événement AppDomain.AssemblyResolve pour fournir la dépendance, et il peut charger l’assembly Utility sans contexte à l’aide de la méthode LoadFile. Quand vous créez une instance d’un type qui est contenu dans l’assembly cible et que vous essayez de l’affecter à une variable de type ICommunicate, une InvalidCastException est levée, car le runtime considère que les interfaces ICommunicate dans les deux copies de l’assembly Utility sont des types différents.

Il existe de nombreux autres scénarios dans lesquels un assembly peut être chargé dans plusieurs contextes. La meilleure approche consiste à éviter les conflits en déplaçant l’assembly cible dans le chemin de votre application et en utilisant la méthode Load avec le nom d’affichage complet. L’assembly est ensuite chargé dans le contexte de chargement par défaut, et les deux assemblys utilisent le même assembly Utility.

Si l’assembly cible doit rester en dehors du chemin de votre application, vous pouvez utiliser la méthode LoadFrom pour le charger dans le contexte de chargement source. Si l’assembly cible a été compilé avec une référence à l’assembly Utility de votre application, il utilisera l’assembly Utility que votre application a chargé dans le contexte de chargement par défaut. Notez que des problèmes peuvent se produire si l’assembly cible a une dépendance d’une copie de l’assembly Utility qui se trouve en dehors du chemin de votre application. Si cet assembly est chargé dans le contexte de chargement source avant que votre application ne charge l’assembly Utility, le chargement de votre application échoue.

La section Envisager de basculer vers le contexte de chargement par défaut traite des alternatives à l’utilisation des chargements via un chemin de fichier, comme LoadFile et LoadFrom.

Éviter de charger plusieurs versions d’un assembly dans le même contexte

Le chargement de plusieurs versions d’un assembly dans un même contexte de chargement peut provoquer des problèmes d’identité de type. Si le même type est chargé à partir de deux versions du même assembly, c’est comme si deux types différents du même nom avaient été chargés. Une InvalidCastException est levée si vous essayez d’effectuer un cast d’un type à l’autre, avec un message trompeur, selon lequel le type MyType ne peut pas être converti en type MyType.

Par exemple, votre programme peut charger directement une version de l’assembly Utility, et il peut charger ultérieurement un autre assembly qui charge une version différente de l’assembly Utility. De même, une erreur de codage peut faire que deux chemins de code différents dans votre application chargent des versions différentes d’un assembly.

Dans le contexte de chargement par défaut, ce problème peut se produire quand vous utilisez la méthode Assembly.Load et que vous spécifiez des noms d’affichage d’assemblys complets qui incluent des numéros de version différents. Pour les assemblys chargés sans contexte, le problème peut être dû à l’utilisation de la méthode Assembly.LoadFile pour charger le même assembly à partir de différents chemins. Le runtime considère deux assemblys chargés à partir de chemins différents comme des assemblys différents, même si leurs identités sont les mêmes.

En plus des problèmes d’identités de type, plusieurs versions d’un même assembly peuvent provoquer une MissingMethodException si un type qui est chargé à partir d’une version de l’assembly est passé au code qui attend ce type d’une autre version. Par exemple, le code peut attendre une méthode qui a été ajoutée à la version ultérieure.

Des erreurs plus subtiles peuvent se produire si le comportement du type a changé entre les versions. Par exemple, une méthode peut lever une exception inattendue ou retourner une valeur inattendue.

Examinez soigneusement votre code pour vérifier qu’une seule version d’un assembly est chargée. Vous pouvez utiliser la méthode AppDomain.GetAssemblies pour déterminer quels assemblys sont chargés à un moment donné.

Envisager de basculer vers le contexte de chargement par défaut

Examinez les modèles de chargement et de déploiement des assemblys de votre application. Pouvez-vous éliminer des assemblys chargés à partir de tableaux d’octets ? Pouvez-vous déplacer des assemblys dans le chemin de recherche ? Si les assemblys se trouvent dans le Global Assembly Cache ou dans le chemin de recherche du domaine d’application (autrement dit son ApplicationBase et son PrivateBinPath), vous pouvez charger l’assembly via son identité.

S’il n’est pas possible de placer tous vos assemblys dans le chemin de recherche, considérez les solutions alternatives, comme utiliser le modèle de complément du .NET Framework, placer les assemblys dans le Global Assembly Cache ou créer des domaines d’application.

Envisager d’utiliser le modèle de complément du .NET Framework

Si vous utilisez le contexte de chargement source pour implémenter des compléments, qui ne sont généralement pas installés dans la base de l’application, utilisez le modèle de complément du .NET Framework. Ce modèle fournit une isolation au niveau du domaine d’application ou du processus, sans qu’il soit nécessaire de gérer vous-même les domaines d’application. Pour plus d’informations sur le modèle de complément, consultez Compléments et extensibilité.

Envisager d’utiliser le Global Assembly Cache

Placez les assemblys dans le Global Assembly Cache pour bénéficier d’un chemin d’assembly partagé qui est en dehors de l’application de base, sans perdre les avantages du contexte de chargement par défaut ou subir les inconvénients des autres contextes.

Envisager d’utiliser des domaines d’application

Si vous déterminez que certains de vos assemblys ne peuvent pas être déployés dans le chemin de recherche de l’application, envisagez de créer un domaine d’application pour ces assemblys. Utilisez AppDomainSetup pour créer le domaine d’application, et utilisez AppDomainSetup.ApplicationBase pour spécifier le chemin qui contient les assemblys que vous voulez charger. Si vous avez plusieurs répertoires où rechercher, vous pouvez définir ApplicationBase sur un répertoire racine et utiliser la propriété AppDomainSetup.PrivateBinPath pour identifier les sous-répertoires où rechercher. Vous pouvez aussi créer plusieurs domaines d’application et définir ApplicationBase pour chaque domaine d’application sur le chemin approprié pour ses assemblys.

Notez que vous pouvez utiliser la méthode Assembly.LoadFrom pour charger ces assemblys. Comme ils sont maintenant dans le chemin de recherche, ils seront chargés dans le contexte de chargement par défaut au lieu du contexte de chargement source. Cependant, nous vous recommandons de passer à la méthode Assembly.Load et de spécifier des noms d’affichage d’assemblys complets pour garantir que les versions correctes sont toujours utilisées.

Voir aussi