Dela via


Uppgradera projekt med .NET Upgrade Assistant

Fokus i den här artikeln är att tillhandahålla de grundläggande stegen för att uppgradera ett projekt med .NET Upgrade Assistant. Det innebär att du initierar uppgraderingen och granskar resultaten. Baserat på hur komplext ditt projekt är kan du behöva utföra manuella uppdateringar av koden.

Vissa projekttyper har specifik vägledning om uppgradering. Mer information finns i Projekttyper som stöds.

Förutsättningar

Uppgradera ett projekt i Visual Studio

Följ de här stegen för att uppgradera ett projekt i Visual Studio.

  1. Säkerhetskopiera koden.

  2. Öppna Visual Studio.

  3. Öppna ett projekt eller en lösning.

  4. I fönstret Solution Explorer högerklickar du på projektet>Uppgradera.

    Solution Explorer-fönstret i Visual Studio som visar högerklicksmenyn för ett projekt. Menyalternativet Uppgradera är markerat.

  5. På fliken Uppgradera väljer du lämpliga uppgraderingsalternativ.

    Olika alternativ visas baserat på typen av projekt och målramverksversionen. Följande bild visar två alternativ när du uppgraderar ett Windows Forms för .NET Framework-projekt. De här alternativen visas inte när du uppgraderar ett .NET-projekt:

    Välkomstskärmen för .NET Upgrade Assistant i Visual Studio.

    I det här exemplet väljer du Uppgradera projektet till en nyare .NET-version.

  6. Välj hur du vill utföra uppgraderingen. Välj Projektuppgradering på plats och välj sedan Nästa.

    Vissa projekt kan bara ge dig ett enda alternativ. Mer information om de här alternativen finns i Så här ska uppgraderingen utföras.

    Guiden .NET Upgrade Assistant visar valet

  7. Välj målramverket, till exempel .NET 8.0. Välj sedan Nästa.

    Guiden .NET Upgrade Assistant visar valet

  8. Välj de komponenter som ska uppgraderas och välj sedan Alternativet Uppgradera.

    Guiden .NET Upgrade Assistant visar valet

  9. När uppgraderingen är klar visas en lista över bearbetade objekt.

    Guiden .NET Upgrade Assistant som visar sammanfattningsskärmen. Varje artefakt som bearbetas av uppgraderingen visas med en statusikon.

Varje artefakt som bearbetas av uppgraderingen visas tillsammans med dess status. Mer information finns i Uppgradera resultat.

Uppgradera ett projekt från CLI

Följ de här stegen för att uppgradera ett projekt med hjälp av terminalen. .NET Global Tool är ett interaktivt verktyg som vägleder dig genom uppgraderingsalternativen. Använd uppåtpilen och nedåtpilen för att ändra det markerade alternativet och Retur för att köra alternativet Välj. Varje skärm visar alternativ för hur du vill konfigurera uppgraderingen.

  1. Säkerhetskopiera koden.

  2. Öppna en terminal och navigera till mappen som innehåller den lösning eller det projekt som du vill uppgradera.

  3. Starta verktyget genom att upgrade-assistant upgrade köra kommandot .

    Du tillfrågas om vad du vill uppgradera. Beroende på vad som identifieras kan vissa alternativ tillämpas automatiskt eller saknas helt.

    En terminal som visar den första skärmen med alternativ för .NET Upgrade Assistant Global Tool. Frågan

  4. Om fler än ett projekt hittas väljer du ett av projekten och trycker på Retur.

    Uppgradera projekt i beroendeordning. Till exempel visade den föregående bilden två projekt: MatchingGame och MatchingGame.Logic. MatchingGame är beroende av MatchingGame.Logic, så MatchingGame.Logic bör uppgraderas först.

  5. Om du har möjlighet att ändra uppgraderingstypen väljer du en och trycker på Retur. Om endast ett alternativ var tillgängligt skulle det ha valts automatiskt.

    Mer information om de här alternativen finns i Så här ska uppgraderingen utföras.

    Dricks

    Om du har säkerhetskopierat koden är det säkert att välja Projektuppgradering på plats.

  6. Välj ett målramverk, till exempel .NET 8.0, och tryck på Retur.

  7. Den sista prompten är en bekräftelse som visar alla valda alternativ. Starta uppgraderingen genom att trycka på Retur .

    En terminal som visar sammanfattningsskärmen med alternativ för .NET Upgrade Assistant Global Tool. Användaren uppmanas att fortsätta.

  8. När uppgraderingen är klar visas en sammanfattning.

    En terminal som visar resultatet av uppgraderingskommandot när du använder .NET Upgrade Assistant Global Tool.