Partager via


Mettre à niveau des projets avec l’Assistant Mise à niveau .NET

L’objectif de cet article est de fournir les étapes de base pour mettre à niveau un projet avec l’Assistant Mise à niveau .NET. Cela implique de lancer la mise à niveau et d’examiner les résultats. En fonction de la complexité de votre projet, vous devrez peut-être effectuer des mises à jour manuelles de votre code.

Certains types de projets ont des conseils spécifiques sur la mise à niveau. Pour plus d’informations, consultez Types de projets pris en charge.

Prérequis

Mettre à niveau un projet dans Visual Studio

Procédez comme suit pour mettre à niveau un projet dans Visual Studio.

  1. Sauvegardez votre code.

  2. Ouvrez Visual Studio.

  3. Ouvrez un projet ou une solution.

  4. Dans la fenêtre Explorateur de solutions, cliquez avec le bouton droit sur le projet>Mettre à niveau.

    Fenêtre Explorateur de solutions dans Visual Studio, affichant le menu contextuel d’un projet. L’élément de menu Mettre à niveau est mis en surbrillance.

  5. Sous l’onglet Mise à niveau , sélectionnez les options de mise à niveau appropriées.

    En fonction du type de projet et de la version du framework cible, différentes options sont présentées. L’image suivante montre deux options lors de la mise à niveau d’un projet Windows Forms pour .NET Framework. Ces options ne s’affichent pas lors de la mise à niveau d’un projet .NET :

    Écran d’accueil de l’Assistant Mise à niveau .NET dans Visual Studio.

    Dans cet exemple, sélectionnez Mettre à niveau le projet vers une version plus récente de .NET.

  6. Sélectionnez la façon dont vous souhaitez effectuer la mise à niveau. Sélectionnez Mise à niveau du projet sur place, puis sélectionnez Suivant.

    Certains projets ne peuvent vous présenter qu’une seule option. Pour plus d’informations sur ces options, consultez Comment effectuer la mise à niveau.

    Assistant Mise à niveau .NET montrant la sélection « Qu’est-ce que votre type de mise à niveau ». La mise à niveau du projet sur place est mise en surbrillance, comme le bouton « Suivant ».

  7. Sélectionnez le framework cible, par exemple .NET 8.0. Sélectionnez ensuite Suivant.

    Assistant Mise à niveau .NET montrant la sélection « Qu’est-ce que votre framework cible préféré ». '.NET 8.0' est mis en surbrillance, comme c’est le bouton « Suivant ».

  8. Sélectionnez les composants à mettre à niveau, puis sélectionnez Mettre à niveau la sélection.

    Assistant Mise à niveau .NET montrant la sélection « Sélectionner les composants à mettre à niveau ». La liste des composants est mise en surbrillance, comme le bouton « Mettre à niveau la sélection ».

  9. Une fois la mise à niveau terminée, une liste d’éléments traités s’affiche.

    Assistant Mise à niveau .NET montrant l’écran récapitulatif. Chaque artefact traité par la mise à niveau est répertorié, avec une icône d’état.

Chaque artefact traité par la mise à niveau est répertorié, ainsi que son état. Pour plus d’informations, consultez Les résultats de la mise à niveau.

Mettre à niveau un projet à partir de l’interface CLI

Procédez comme suit pour mettre à niveau un projet à l’aide du terminal. L’outil global .NET est un outil interactif qui vous guide tout au long des options de mise à niveau. Utilisez les touches Flèche haut et Bas pour modifier l’option mise en surbrillance, puis Entrez pour exécuter l’option Sélectionner l’option. Chaque écran vous présente des options sur la façon dont vous souhaitez configurer la mise à niveau.

  1. Sauvegardez votre code.

  2. Ouvrez un terminal et accédez au dossier contenant la solution ou le projet que vous souhaitez mettre à niveau.

  3. Pour démarrer l’outil, exécutez la upgrade-assistant upgrade commande.

    Vous êtes invité à savoir ce que vous souhaitez mettre à niveau. Selon ce qui est détecté, certaines options peuvent être appliquées automatiquement ou manquantes entièrement.

    Terminal montrant l’écran initial des options de l’Outil global de l’Assistant Mise à niveau .NET. La question « Quel projet voulez-vous mettre à niveau » est posée.

  4. Si plusieurs projets sont trouvés, choisissez l’un des projets, puis appuyez sur Entrée.

    Mettez à niveau les projets dans l’ordre de leur dépendance. Par exemple, l’image précédente a montré deux projets : MatchingGame et MatchingGame.Logic. MatchingGame dépend MatchingGame.Logicde , il doit donc MatchingGame.Logic être mis à niveau en premier.

  5. Si vous avez la possibilité de modifier le type de mise à niveau, choisissez-en un, puis appuyez sur Entrée. Si une seule option était disponible, elle aurait été sélectionnée automatiquement.

    Pour plus d’informations sur ces options, consultez Comment effectuer la mise à niveau.

    Conseil

    Si vous avez sauvegardé votre code, il est sûr de sélectionner La mise à niveau du projet sur place.

  6. Choisissez un framework cible, tel que .NET 8.0, puis appuyez sur Entrée.

  7. L’invite finale est une confirmation, affichant toutes les options sélectionnées. Appuyez sur Entrée pour démarrer la mise à niveau.

    Terminal montrant l’écran récapitulatif des options pour l’outil global de l’Assistant Mise à niveau .NET. L’utilisateur est invité à continuer.

  8. Une fois la mise à niveau terminée, un résumé s’affiche.

    Terminal montrant les résultats de la commande de mise à niveau lors de l’utilisation de l’outil global de l’Assistant Mise à niveau .NET.