Installer l’Assistant Mise à niveau de .NET

L’Assistant Mise à niveau .NET peut être installé en tant qu’extension Visual Studio ou en tant qu’outil en ligne de commande .NET. Lorsqu’ils sont installés en tant qu’extension Visual Studio, les projets chargés peuvent être mis à niveau via le menu contextuel. La version de l’outil en ligne de commande .NET fournit une expérience détaillée interactive. Pour plus d’informations sur l’outil, consultez Vue d’ensemble de l’Assistant Mise à niveau .NET.

Prérequis

Installer l'extension Visual Studio

L’Assistant Mise à niveau .NET peut être installé comme une extension Visual Studio, ce qui vous permet de mettre à niveau un projet ouvert. Procédez comme suit pour installer l’Assistant Mise à niveau .NET à partir de Visual Studio. Vous pouvez aussi télécharger directement l’extension à partir de Visual Studio Marketplace.

  1. Avec Visual Studio ouvert, appuyez sur l’élément de menu Extensions>Gérer les extensions, ce qui ouvre la fenêtre Gérer les extensions.

  2. Dans la fenêtre Gérer les extensions, entrez mise à niveau dans la zone d’entrée de recherche.

  3. Sélectionnez l’élément Assistant Mise à niveau .NET, puis sélectionnez Télécharger.

    The manage extensions window in Visual Studio, showing the .NET Upgrade Assistant.

  4. Une fois l’extension téléchargée, fermez Visual Studio. L’installation de l’extension démarre :

    A prompt to install the .NET Upgrade Assistant extension.

  5. Sélectionnez Modifier et suivez les directions pour installer l’extension.

Installer l’outil global .NET

L’Assistant Mise à niveau .NET est également disponible en tant qu’outil global .NET. Vous pouvez installer l’outil avec la commande suivante :

dotnet tool install -g upgrade-assistant

De même, étant donné que l’Assistant Mise à niveau de .NET est installé en tant qu’outil .NET, il peut être facilement mis à jour en exécutant :

dotnet tool update -g upgrade-assistant

Important

L’installation de cet outil peut échouer si vous avez configuré d’autre sources de flux NuGet. Utilisez le paramètre --ignore-failed-sources pour traiter ces échecs comme des avertissements plutôt que des erreurs :

dotnet tool install -g --ignore-failed-sources upgrade-assistant

Pour mettre à niveau des projets comportant des composants WCF, utilisez l’ancienne version de l’outil CLI. Pour plus d’informations, consultez Installation (version héritée).