Share via


Upgraden naar een nieuwe .NET-versie

Er worden elk jaar nieuwe .NET-versies uitgebracht. Veel ontwikkelaars starten het upgradeproces zodra de nieuwe versie beschikbaar is, terwijl anderen wachten totdat de versie die ze gebruiken, niet meer wordt ondersteund. Het upgradeproces heeft meerdere aspecten die u moet overwegen.

Veelvoorkomende redenen om een upgrade uit te voeren naar een nieuwe .NET-versie:

  • De momenteel gebruikte .NET-versie wordt niet meer ondersteund
  • De nieuwe versie ondersteunt een nieuw besturingssysteem
  • De nieuwe versie heeft een belangrijke API, prestaties of beveiligingsfunctie

Ontwikkelomgeving upgraden

Als u een upgrade wilt uitvoeren naar een nieuwe .NET-versie, is de .NET SDK het primaire onderdeel dat moet worden geïnstalleerd. Het bevat een bijgewerkte .NET CLI, buildsysteem en runtime-versie.

De .NET-website biedt installatieprogramma's en archieven die u kunt downloaden en gebruiken op elk ondersteund besturingssysteem en elke ondersteunde architectuur.

Sommige besturingssystemen hebben een pakketbeheerder die u ook kunt gebruiken om een nieuwe .NET-versie te installeren, die u misschien liever gebruikt.

Visual Studio installeert automatisch nieuwe .NET SDK-versies. Voor Visual Studio-gebruikers is het voldoende om een upgrade uit te voeren naar een nieuwere Versie van Visual Studio.

Broncode bijwerken

De enige vereiste wijziging voor het bijwerken van een app is het bijwerken van de TargetFramework eigenschap in een projectbestand naar de nieuwere .NET-versie.

Ga als volgt te werk:

  • Open het projectbestand (de *.csproj, *.vbprojof *.fsproj het bestand).
  • Wijzig de <TargetFramework> eigenschapswaarde bijvoorbeeld net6.0net8.0van .
  • Hetzelfde patroon is van toepassing op de <TargetFrameworks> eigenschap als deze wordt gebruikt.

De upgradeassistent kan deze wijzigingen automatisch aanbrengen.

De volgende stap bestaat uit het bouwen van het project (of de oplossing) met de nieuwe SDK. Als er aanvullende wijzigingen nodig zijn, biedt de SDK waarschuwingen en fouten die u helpen.

Mogelijk moet u uitvoeren dotnet workload restore om workloads te herstellen met de nieuwe SDK-versie.

Meer resources:

Continue integratie bijwerken (CI)

CI-pijplijnen volgen een vergelijkbaar updateproces als projectbestanden en Dockerfiles. Normaal gesproken kunt u CI-pijplijnen bijwerken door alleen versiewaarden te wijzigen.

Hostingomgeving bijwerken

Er zijn veel patronen die worden gebruikt voor het hosten van toepassingen. Als de hostingomgeving de .NET-runtime bevat, moet de nieuwe versie van de .NET-runtime worden geïnstalleerd. In Linux moeten afhankelijkheden worden geïnstalleerd, maar ze veranderen doorgaans niet in .NET-versies.

Voor containers FROM moeten instructies worden gewijzigd om nieuwe versienummers op te nemen.

In het volgende Dockerfile-voorbeeld ziet u hoe u een ASP.NET Core 8.0-installatiekopie ophaalt.

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

In een cloudservice zoals Azure-app Service is een configuratiewijziging nodig.