Vad är .NET Upgrade Assistant?
.NET Upgrade Assistant hjälper till att uppgradera projekt till nyare versioner av .NET och analyserar koden för att upptäcka och åtgärda potentiella inkompatibiliteter. Ett fokus för verktyget är att migrera ett projekt från .NET Framework, .NET Core eller .NET till den senaste versionen av .NET. Du använder tillägget eller verktyget för att uppgradera hela .NET-projekt, eller någon aspekt av projektet, till exempel migrering av en konfigurationsfil från en äldre typ till en nyare typ.
.NET Upgrade Assistant distribueras som ett Visual Studio-tillägg eller ett cli-verktyg (command-line interface).
Analysera och uppgradera
.NET Upgrade Assistant innehåller en analysmotor som söker igenom dina projekt och deras beroenden. När genomsökningen är klar genereras en rapport med detaljerad information om hur du utför en uppgradering. Du kan använda den här informationen för att uppgradera antingen hela projektet eller specifika delar av projektet.
Projekttyper som stöds
.NET Upgrade Assistant stöder uppgradering av projekt som är kodade i C# eller Visual Basic. Följande typer av projekt stöds:
- ASP.NET
- Azure Functions
- Windows Presentation Foundation
- Windows Forms
- Klassbibliotek
- Konsolappar
- Xamarin Forms
- .NET MAUI
- .NET Native UWP
Vissa produkter ger vägledning om hur du använder .NET Upgrade Assistant.
- ASP.NET
- Windows Presentation Foundation
- Windows-formulär
- Universal Windows Platform
- Windows Communication Foundation
Uppgradera sökvägar
Följande uppgraderingsvägar stöds:
- .NET Framework till .NET
- .NET Core till .NET
- Azure Functions v1-v3 till v4 isolerat (mål för net6.0+)
- UWP till WinUI 3
- Tidigare .NET-version till den senaste .NET-versionen
- Xamarin Forms till .NET MAUI
- XAML-filtransformeringar stöder endast uppgradering av namnområden. Mer omfattande omvandlingar finns i Visual Studio 2022 version 17.6 eller senare.
Uppgraderingsinformation och alternativ
När en uppgradering startas vägleder en guide dig genom att konfigurera några av alternativen innan uppgraderingen initieras. Guiden visar olika alternativ baserat på vilken typ av projekt du uppgraderar. Ett exempel på hur du uppgraderar ett projekt finns i Uppgradera projekt med .NET Upgrade Assistant.
Hur uppgraderingen ska utföras
Baserat på vilken typ av projekt du uppgraderar kanske du kan ändra hur uppgraderingen utförs. Typen av projekt påverkar vilka alternativ som är tillgängliga och ett eller flera av följande objekt kanske saknas:
Projektuppgradering på plats
Det här alternativet uppgraderar projektet utan att göra en kopia.
Projektuppgradering sida vid sida
Kopierar projektet och uppgraderar kopian och lämnar det ursprungliga projektet ensamt.
Stegvis sida vid sida
Det här är ett bra val för komplicerade webbappar. Uppgradering från ASP.NET till ASP.NET Core kräver en hel del arbete och ibland manuell refaktorisering. I det här läget placeras ett .NET-projekt bredvid det befintliga .NET Framework-projektet. Slutpunkter dirigeras via .NET-projektet, medan alla andra anrop skickas till .NET Framework-programmet.
Med det här läget kan du långsamt uppgradera din ASP.NET- eller biblioteksapp bit för bit.
Uppgraderingsresultat
När uppgraderingen är klar visas en statusskärm som visar alla artefakter som är associerade med uppgraderingen. Varje uppgraderingsartefakt kan utökas för att läsa mer information om statusen. I följande lista beskrivs statusikonerna:
- Ofylld grön bockmarkering: Verktyget hittade inget om artefakten som ska uppgraderas.
- Fylld grön bockmarkering: Artefakten har uppgraderats och slutförts.
- Gult varningstecken: Artefakten har uppgraderats, men det finns viktig information som du bör tänka på.
- Red X: Artefaktuppgradningen misslyckades.
Dessutom loggas de åtgärder som utfördes under uppgraderingen till utdatafönstret under uppgraderingsassistentens källa, enligt följande bild:
När du har uppgraderat projektet testar du det noggrant!
