Lire en anglais

Partager via

Mise à niveau vers une nouvelle version de .NET

  • Article

De nouvelles versions de .NET sont mises en production chaque année. De nombreux développeurs démarrent le processus de mise à niveau dès que la nouvelle version est disponible, alors que d’autres attendent jusqu’à la fin de la prise en charge de la version qu’ils utilisent. Le processus de mise à niveau a plusieurs points à prendre en compte.

Raisons courantes d’une mise à niveau vers une nouvelle version de .NET :

  • La version de .NET actuellement utilisée n’est plus prise en charge
  • La nouvelle version prend en charge un nouveau système d’exploitation
  • La nouvelle version dispose d’une fonctionnalité de sécurité, d’un niveau de performance ou d’une API importante

Mise à niveau de l’environnement de développement

Pour effectuer une mise à niveau vers une nouvelle version de .NET, le Kit de développement logiciel (SDK) .NET constitue le principal composant à installer. Il inclut une version de runtime, un système de génération et une interface Azure CLI .NET mis à jour.

Le site web de .NET propose des programmes d’installation et des archives que vous pouvez télécharger et utiliser sur n’importe quel système d’exploitation et n’importe quelle architecture pris en charge.

Certains systèmes d’exploitation disposent également d’un gestionnaire de package que vous préférerez peut-être utiliser pour installer une nouvelle version de .NET.

Visual Studio installe les nouvelles versions du Kit de développement logiciel (SDK) .NET automatiquement. Pour les utilisateurs de Visual Studio, une mise à jour vers une version plus récente de Visual Studio est suffisante.

Mise à niveau de code source

La seule modification requise pour la mise à niveau d’une application consiste à mettre à jour la propriété TargetFramework dans un Fichier projet vers la dernière version de .NET.

Voici comment procéder :

  • Ouvrez le Fichier projet (le fichier *.csproj, *.vbproj ou *.fsproj).
  • Remplacez la valeur de propriété <TargetFramework> à partir de net6.0, par exemple, par net8.0.
  • Le même modèle s’applique pour la propriété <TargetFrameworks> si elle est en cours d’utilisation.

L’Assistant Mise à niveau peut automatiquement apporter ces modifications.

L’étape suivante consiste à générer le projet (ou solution) avec le nouveau Kit de développement logiciel (SDK). Si d’autres modifications sont nécessaires, le Kit de développement logiciel (SDK) vous fournira des avertissements et des erreurs pour vous guider.

Il est possible que vous deviez exécuter dotnet workload restore pour restaurer des charges de travail avec la nouvelle version du Kit de développement logiciel (SDK).

Autres ressources :

Mise à jour de l’intégration continue (CI)

Les pipelines d’intégration suivent un processus de mise à jour similaire aux Fichiers projets et Dockerfiles. Vous pouvez généralement mettre à jour des Pipelines d’intégration continue en modifiant uniquement les valeurs de version.

Mise à jour d’un environnement d’hébergement

Il existe plusieurs modèles utilisés pour des applications d’hébergement. Si l’environnement d’hébergement comprend le runtime .NET, vous devez alors installer la nouvelle version du runtime .NET. Sur Linux, vous devez installer des dépendances. Toutefois, elles ne changent généralement pas entre les versions .NET.

Pour les conteneurs, vous devez modifier les instructions FROM pour inclure les nouveaux numéros de version.

L’exemple Dockerfile suivant illustre l’extraction d’une image ASP.NET Core 9.0.

Dockerfile 
FROM mcr.microsoft.com/dotnet/aspnet:9.0

Dans un service cloud comme Azure App Service, une modification de configuration est nécessaire.