Dela via

Uppgradera till en ny .NET-version

  • Artikel

Nya .NET-versioner släpps varje år. Många utvecklare startar uppgraderingsprocessen så snart den nya versionen är tillgänglig, medan andra väntar tills den version de använder inte längre stöds. Uppgraderingsprocessen har flera aspekter att tänka på.

Vanliga orsaker till att uppgradera till en ny .NET-version:

  • Den .NET-version som används stöds inte längre
  • Den nya versionen stöder ett nytt operativsystem
  • Den nya versionen har en viktig API-funktion, prestanda eller säkerhetsfunktion

Uppgradera utvecklingsmiljön

Om du vill uppgradera till en ny .NET-version är .NET SDK den primära komponent som ska installeras. Den innehåller en uppdaterad .NET CLI-version, byggsystem och körningsversion.

På .NET-webbplatsen finns installationsprogram och arkiv som du kan ladda ned och använda på alla operativsystem och arkitekturer som stöds.

Vissa operativsystem har en pakethanterare som du också kan använda för att installera en ny .NET-version, vilket du kanske föredrar.

Visual Studio installerar nya .NET SDK-versioner automatiskt. För Visual Studio-användare räcker det att uppgradera till en nyare Visual Studio-version.

Uppgradera källkod

Den enda nödvändiga ändringen för att uppgradera en app är att uppdatera TargetFramework egenskapen i en projektfil till den nyare .NET-versionen.

Så här gör du:

  • Öppna projektfilen ( *.csprojfilen , *.vbprojeller *.fsproj ).
  • Ändra egenskapsvärdet <TargetFramework> från till exempel net6.0 till net8.0.
  • Samma mönster gäller för egenskapen om den <TargetFrameworks> används.

Uppgraderingsassistenten kan göra dessa ändringar automatiskt.

Nästa steg är att skapa projektet (eller lösningen) med den nya SDK:n. Om ytterligare ändringar behövs kommer SDK:n att ge varningar och fel som vägleder dig.

Du kan behöva köra dotnet workload restore för att återställa arbetsbelastningar med den nya SDK-versionen.

Fler resurser:

Uppdatera kontinuerlig integrering (CI)

CI-pipelines följer en liknande uppdateringsprocess som projektfiler och Dockerfiles. Vanligtvis kan du uppdatera CI-pipelines genom att endast ändra versionsvärden.

Uppdatera värdmiljön

Det finns många mönster som används för att hantera program. Om värdmiljön innehåller .NET-körningen måste den nya versionen av .NET-körningen installeras. I Linux måste beroenden installeras, men de ändras vanligtvis inte mellan .NET-versioner.

För containrar FROM måste instruktioner ändras för att inkludera nya versionsnummer.

Följande Dockerfile-exempel visar hur du hämtar en ASP.NET Core 9.0-avbildning.

FROM mcr.microsoft.com/dotnet/aspnet:9.0

I en molntjänst som Azure App Service krävs en konfigurationsändring.