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
- Information om Visual Studio finns i Installera .NET Upgrade Assistant – Visual Studio-tillägget
- Information om det globala .NET-verktyget finns i Installera .NET Upgrade Assistant – .NET Global Tool
Uppgradera ett projekt i Visual Studio
Följ de här stegen för att uppgradera ett projekt i Visual Studio.
Säkerhetskopiera koden.
Öppna Visual Studio.
Öppna ett projekt eller en lösning.
I fönstret Solution Explorer högerklickar du på projektet>Uppgradera.
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:
I det här exemplet väljer du Uppgradera projektet till en nyare .NET-version.
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.
Välj målramverket, till exempel .NET 8.0. Välj sedan Nästa.
Välj de komponenter som ska uppgraderas och välj sedan Alternativet Uppgradera.
När uppgraderingen är klar visas en lista över bearbetade objekt.
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.
Säkerhetskopiera koden.
Öppna en terminal och navigera till mappen som innehåller den lösning eller det projekt som du vill uppgradera.
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.
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
ochMatchingGame.Logic
.MatchingGame
är beroende avMatchingGame.Logic
, såMatchingGame.Logic
bör uppgraderas först.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.
Välj ett målramverk, till exempel .NET 8.0, och tryck på Retur.
Den sista prompten är en bekräftelse som visar alla valda alternativ. Starta uppgraderingen genom att trycka på Retur .
När uppgraderingen är klar visas en sammanfattning.