Vue d’ensemble de l’Assistant Mise à niveau de .NET

De nouvelles versions de .NET sont mises en production tout au long de l’année, avec une version majeure une fois par an. L’Assistant Mise à niveau .NET vous aide à mettre à niveau les applications des versions précédentes de .NET, .NET Core et .NET Framework vers la dernière version.

L’Assistant Mise à niveau .NET est une extension Visual Studio et un outil en ligne de commande conçus pour faciliter la mise à niveau des applications vers la dernière version de .NET.

Les problèmes liés à l’Assistant Mise à niveau .NET peuvent être signalés dans Visual Studio en sélectionnant Aide>Envoyer des commentaires>Signaler un problème.

Installer l’Assistant Mise à niveau

L’Assistant Mise à niveau .NET peut être installé en tant qu’extension Visual Studio ou en tant qu’outil en ligne de commande .NET. Pour plus d’informations, consultez Installer l’Assistant Mise à niveau .NET.

Langues prises en charge

Les langages de code suivants sont pris en charge :

• C#
• Visual Basic

Projets pris en charge

Les types de projets suivants sont pris en charge :

• ASP.NET
• Azure Functions
• Windows Presentation Foundation
• Windows Forms
• bibliothèques de classes ;
• Applications de console
• UWP .NET Native
• Xamarin Forms
• .NET MAUI

Chemins de mise à jour

Les chemins de mise à niveau suivants sont pris en charge :

• .NET Framework vers .NET
• .NET Core vers .NET
• UWP vers WinUI 3
• Version précédente de .NET à la dernière version de .NET
• Azure Functions v1-v3 à v4 isolé
• Xamarin Forms vers .NET MAUI
  • Les transformations de fichiers XAML prennent uniquement en charge la mise à niveau des espaces de noms. Pour des transformations plus complètes, utilisez Visual Studio 2022 version 17.6 ou ultérieure.

Mettre à niveau avec l’extension Visual Studio

Une fois que vous avez installé l’extension de l’Assistant Mise à niveau .NET, cliquez avec le bouton de droite sur le projet dans la fenêtre Explorateur de solutions, puis sélectionnez Mettre à niveau.

Attention

Veillez à sauvegarder vos projets avant la mise à niveau si vous n’utilisez pas le contrôle de code source.

Un onglet est ouvert qui fournit, en fonction du type de votre projet, différents styles de mise à niveau :

• Mise à niveau de projet sur place

  Cette option met à niveau votre projet sans effectuer de copie.

• Mise à niveau de projet côte à côte

  Copie votre projet et met à niveau la copie, en laissant votre projet d’origine seul.

• Incrémentielle côte à côte

  Un bon choix pour les applications web complexes. La mise à niveau de ASP.NET vers ASP.NET Core nécessite beaucoup de travail et parfois une refactorisation manuelle. Ce mode place un projet .NET en regard de votre projet .NET Framework existant et achemine les points de terminaison implémentés dans le projet .NET, tandis que tous les autres appels sont envoyés à l’application .NET Framework.

  Ce mode vous permet de mettre à niveau lentement votre application ASP.NET ou bibliothèque, pièce par pièce.

Une fois votre application mise à niveau, un écran d’états s’affiche et affiche tous les artefacts associés à votre projet qui ont été associés à la mise à niveau. Chaque artefact de mise à niveau peut être développé pour lire plus d’informations sur l’état. La liste suivante décrit les icônes d’états :

• Coche verte remplie : l’artefact a été mis à niveau et s’est terminé avec succès.
• Coche verte non remplie : l’outil n’a rien trouvé concernant l’artefact à mettre à niveau.
• Signe d’avertissement jaune : l’artefact a été mis à niveau, mais vous devez prendre en compte des informations importantes.
• X rouge : l’artefact devait être mis à niveau, mais la mise à niveau a échoué.

De plus, les actions effectuées par l’Assistant Mise à niveau sont enregistrées dans la fenêtre Sortie sous la source de l’Assistant Mise à niveau, tel qu’illustré dans l’image suivante :

Après la mise à niveau de votre projet, vous devez le tester minutieusement.

Mettre à niveau avec l’outil CLI

Après avoir installé l’outil CLI de l’Assistant Mise à niveau .NET, ouvrez une fenêtre de terminal et accédez au répertoire qui contient le projet que vous souhaitez mettre à niveau. Vous pouvez utiliser la commande upgrade-assistant --help pour afficher les options disponibles de l’interface CLI.

Attention

Veillez à sauvegarder vos projets avant la mise à niveau si vous n’utilisez pas le contrôle de code source.

Exécutez l’outil avec la commande upgrade-assistant upgrade, tous les projets du dossier actif et ci-dessous sont répertoriés. L’outil CLI offre un moyen interactif de choisir le projet à mettre à niveau. Utilisez les touches de direction pour sélectionner un élément, puis appuyez sur Entrée pour exécuter l’élément. Sélectionnez le projet à supprimer. Dans l’exemple fourni par cet article, il existe quatre projets sous le dossier actif :

 Selected options
───────────────────────────────────────────────────────────
 No options specified, follow steps below to continue

 Steps
─────────────────
 Source project
─────────────────

Which project do you want to upgrade (found 9)?

> MatchingGame (winforms\MatchingGame\MatchingGame.csproj)
  MatchingGame.Logic (winforms\MatchingGame.Logic\MatchingGame.Logic.csproj)
  StarVoteControl (csharp\StarVoteControl\StarVoteControl.csproj)
  WebSiteRatings (csharp\WebSiteRatings\WebSiteRatings.csproj)

  Navigation
    Exit

Selon le projet que vous mettez à niveau, une option peut vous être présentée pour spécifier la façon dont la mise à niveau doit se poursuivre :

• Mise à niveau de projet sur place

  Cette option met à niveau votre projet sans effectuer de copie.

• Mise à niveau de projet côte à côte

  Cette option est disponible uniquement pour les projets .NET Framework. Copie votre projet et met à niveau la copie, en laissant votre projet d’origine seul.

 Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 Source project     C:\Code\winforms\MatchingGame\MatchingGame.csproj

 Steps
───────────────────────────────
 Source project / Upgrade type
───────────────────────────────

How do you want to upgrade project MatchingGame?

> In-place project upgrade
  Side-by-side project upgrade

  Navigation
    Back
    Exit

Après cette étape, s’il existe plusieurs versions cibles de .Net Framework pouvant être mises à niveau, vous choisirez une cible :

 Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 Source project     C:\Code\Work\dotnet\dotnet-docs\docs\core\porting\snippets\upgrade-assistant-wpf-framework\winforms\MatchingGame\MatchingGame.csproj
 Ugrade type        Inplace

 Steps
──────────────────────────────────────────────────
 Source project / Ugrade type / Target framework
──────────────────────────────────────────────────

What is your preferred target framework?

> .NET 6.0 (Supported until November, 2024)
  .NET 7.0 (Supported until May, 2024)
  .NET 8.0 (Try latest preview features)

  Navigation
    Back
    Exit

Après la mise à niveau de votre projet, vous devez le tester minutieusement.