Compatibilité des versions

  • Article

La compatibilité descendante signifie qu'une application développée pour une version particulière d'une plateforme s'exécutera sur les versions ultérieures de cette plateforme. Le .NET Framework essaie de maximiser la compatibilité descendante : le code source écrit pour une version du .NET Framework doit se compiler sur les versions ultérieures du .NET Framework, et les fichiers binaires qui s’exécutent sur une version du .NET Framework doivent se comporter de la même manière sur les versions ultérieures du .NET Framework.

Compatibilité des versions pour les applications

Par défaut, une application s’exécute sur la version du .NET Framework pour laquelle elle a été générée. Si cette version n’est pas présente et que le fichier de configuration de l’application ne définit pas les versions prises en charge, une erreur d’initialisation du .NET Framework peut se produire. Dans ce cas, la tentative d'exécution de l'application échouera.

Pour définir les versions spécifiques sur lesquelles votre application s’exécute, ajoutez un ou plusieurs éléments <supportedRuntime> dans le fichier de configuration de votre application. Chaque élément <supportedRuntime> fournit une liste des versions prises en charge de l'exécution ; la première spécifie la version préférée et la dernière correspond à la version la moins préférée.

<configuration>
   <startup>
      <supportedRuntime version="v2.0.50727" />
      <supportedRuntime version="v4.0" />
   </startup>
</configuration>

Pour plus d’informations, consultez Guide pratique pour configurer une application en vue de prendre en charge le .NET Framework 4 ou 4.x.

Compatibilité des versions pour les composants

Une application peut contrôler la version du .NET Framework sur laquelle elle s’exécute, mais un composant ne le peut pas. Les composants et bibliothèques de classes étant chargés dans le contexte d’une application particulière, ils s’exécutent automatiquement sur la version du .NET Framework sur lequel l’application s’exécute.

À cause de cette restriction, les garanties de compatibilité sont particulièrement importantes pour les composants. Depuis .NET Framework 4, vous pouvez spécifier le degré auquel un composant est supposé rester compatible entre plusieurs versions en appliquant l'attribut System.Runtime.Versioning.ComponentGuaranteesAttribute à ce composant. Les outils peuvent utiliser cet attribut pour détecter des violations potentielles de la garantie de compatibilité dans les versions ultérieures d'un composant.

Compatibilité descendante

.NET Framework 4.5 et versions ultérieures présentent une compatibilité descendante avec les applications générées à l’aide des versions antérieures du .NET Framework. En d’autres termes, les applications et composants générés avec les versions antérieures du .NET Framework fonctionneront sur .NET Framework 4.5 et versions ultérieures sans être modifiés. Toutefois, par défaut, les applications sont exécutées sur la version du common language runtime pour laquelle elles ont été développées. Par conséquent, il est possible que vous deviez fournir un fichier de configuration pour permettre à votre application de s’exécuter sur .NET Framework 4.5 ou versions ultérieures. Pour plus d’informations, consultez la section Compatibilité des versions pour les applications plus haut dans cet article.

Dans la pratique, cette compatibilité peut être arrêtée par des modifications apparemment sans importance du .NET Framework et des modifications des techniques de programmation. Par exemple, les améliorations des performances dans le .NET Framework 4.5 peuvent exposer une condition de concurrence critique qui ne se produit pas sur les versions antérieures. De la même façon, l’utilisation d’un chemin d’accès codé en dur aux assemblys .NET Framework, la comparaison d’égalité avec une version particulière du .NET Framework, et l’obtention de la valeur d’un champ privé à l’aide de la réflexion ne sont pas des pratiques à compatibilités descendante. De plus, chaque version du .NET Framework inclut des résolutions de bogue et des modifications relatives à la sécurité qui peuvent affecter la compatibilité de certains composants et applications.

Si votre application ou composant ne fonctionne pas comme prévu sur .NET Framework 4.5 ou une version ultérieure, utilisez les listes de vérification suivantes :

  • Si votre application a été développée pour s’exécuter sur n’importe quelle version du .NET Framework en commençant à .NET Framework 4.0, consultez Compatibilité des applications pour générer des listes de modifications entre la version du .NET Framework que vous ciblez et la version sur laquelle votre application s’exécute.

  • S’il s’agit d’une application .NET Framework 3.5, consultez également Problèmes de migration de .NET Framework 4.

  • S’il s’agit d’une application .NET Framework 2.0, consultez également Modifications dans .NET Framework 3.5 SP1.

  • S’il s’agit d’une application .NET Framework 1.1, consultez également Modifications dans .NET Framework 2.0.

  • Si vous recompilez le code source existant pour l’exécuter sur .NET Framework 4.5 ou ses versions intermédiaires, ou si vous développez une nouvelle version d’une application ou d’un composant qui cible .NET Framework 4.5 ou ses versions intermédiaires à partir d’une base de code source existante, consultez Éléments obsolètes dans la bibliothèque de classes pour connaître les types et les membres obsolètes, et appliquer la solution de contournement décrite. (Le code précédemment compilé continuera à s'exécuter sur des types et des membres marqués comme obsolètes.)

  • Si vous déterminez qu’une modification de .NET Framework 4.5 fait dysfonctionner votre application, consultez le schéma des paramètres d’exécution, et en particulier l’élément <AppContextSwitchOverrides>>, pour déterminer si vous pouvez utiliser un paramètre d’exécution dans le fichier de configuration de votre application afin de restaurer le comportement précédent.

  • Si vous rencontrez un problème qui n’est pas documenté, ouvrez un problème sur le site de la communauté des développeurs pour .NET ou ouvrez un problème dans le dépôt GitHub de Microsoft/dotnet.

Exécution côte à côte

Si vous ne trouvez pas de solution de contournement appropriée pour votre problème, rappelez-vous que .NET Framework 4.5 (ou une de ses versions intermédiaires) s’exécute côte à côte avec les versions 1.1, 2.0 et 3.5, et qu’il est une mise à jour sur place qui remplace la version 4. Pour les applications ciblant les versions 1.1, 2.0 et 3.5, vous pouvez installer la version appropriée du .NET Framework sur l’ordinateur cible pour exécuter l’application dans l’environnement qui lui convient le mieux. Pour plus d’informations sur l’exécution côte à côte, consultez Exécution côte à côte.

Voir aussi