Share via

De .NET Runtime en SDK verwijderen

  • Artikel

Wanneer u na verloop van tijd bijgewerkte versies van de .NET Runtime en SDK installeert, kunt u verouderde versies van .NET van uw computer verwijderen. Als u oudere versies van de runtime verwijdert, kan de gekozen runtime worden gewijzigd om gedeelde frameworktoepassingen uit te voeren, zoals beschreven in het artikel over de .NET-versieselectie.

Moet ik een versie verwijderen?

Het gedrag van de .NET-versieselectie en de runtimecompatibiliteit van .NET tussen updates maakt het veilig verwijderen van eerdere versies mogelijk. .NET Runtime-updates zijn compatibel binnen een primaire versieband, zoals 7.x en 6.x. Daarnaast behouden nieuwere releases van de .NET SDK over het algemeen de mogelijkheid om toepassingen te bouwen die gericht zijn op eerdere versies van de runtime op een compatibele manier.

Over het algemeen hebt u alleen de nieuwste SDK en de nieuwste patchversie van de runtimes nodig die nodig zijn voor uw toepassing. Exemplaren waarin u oudere SDK- of runtimeversies wilt behouden, zijn onder andere het onderhouden van project.json toepassingen. Tenzij uw toepassing specifieke redenen heeft voor eerdere SDK's of runtimes, kunt u veilig oudere versies verwijderen.

Bepalen wat er is geïnstalleerd

De .NET CLI bevat opties die u kunt gebruiken om de versies van de SDK en runtime weer te geven die op uw computer zijn geïnstalleerd. Gebruik dotnet --list-sdks deze lijst om de lijst met geïnstalleerde SDK's en dotnet --list-runtimes voor de lijst met runtimes weer te geven. Zie Controleren of .NET al is geïnstalleerd voor meer informatie.

.NET verwijderen

.NET maakt gebruik van het dialoogvenster Windows-apps en -functies om versies van de .NET-runtime en SDK te verwijderen. In de volgende afbeelding ziet u het dialoogvenster Apps en functies . U kunt zoeken naar core of .net om geïnstalleerde versies van .NET te filteren en weer te geven.

Programma's toevoegen/verwijderen om .NET te verwijderen

Selecteer alle versies die u van uw computer wilt verwijderen en klik op Verwijderen.

De beste manier om .NET te verwijderen, is door de actie die u hebt gebruikt voor het installeren van .NET te spiegelen. De details zijn afhankelijk van de gekozen Linux-distributie en de installatiemethode.

Preview-versies worden handmatig geïnstalleerd en moeten handmatig worden verwijderd. Zie de sectie Script of handmatig voor meer informatie.

Belangrijk

Raadpleeg de Red Hat-productdocumentatie voor .NET voor Red Hat-installaties.

U kunt de volgende typen verwijderen als .NET-installaties:

Pakketbeheer

U hoeft de .NET SDK niet eerst te verwijderen bij het upgraden met behulp van een pakketbeheer, tenzij u een upgrade uitvoert van een preview-versie die handmatig is geïnstalleerd. Met pakketbeheer update of refresh opdrachten wordt automatisch de oudere versie verwijderd na de geslaagde installatie van een nieuwere versie. Als u een preview-versie hebt geïnstalleerd, verwijdert u deze.

Als u .NET hebt geïnstalleerd met behulp van pakketbeheer, gebruikt u diezelfde pakketbeheerder om de .NET SDK of runtime te verwijderen. .NET-installaties ondersteunen de populairste pakketbeheerders. Raadpleeg de documentatie voor pakketbeheer van uw distributie voor de exacte syntaxis in uw omgeving:

  • apt-get(8) wordt gebruikt door Debian-systemen, waaronder Ubuntu.
  • yum(8) wordt gebruikt op Fedora, CentOS, Oracle Linux en RHEL.
  • zypper(8) wordt gebruikt op openSUSE en SUSE Linux Enterprise System (SLES).
  • dnf(8) wordt gebruikt op Fedora.

In bijna alle gevallen is removede opdracht om een pakket te verwijderen.

De pakketnaam voor de .NET SDK-installatie voor de meeste pakketbeheerders is dotnet-sdk, gevolgd door het versienummer. Alleen de primaire en secundaire versienummers zijn nodig: de .NET SDK-versie 8.0.200 kan bijvoorbeeld worden verwezen als het pakket dotnet-sdk-8.0.

Voor computers die alleen de runtime hebben geïnstalleerd en niet de SDK, is dotnet-runtime-<version> de pakketnaam voor de .NET-runtime en aspnetcore-runtime-<version> voor de volledige runtimestack.

Script of handmatig

Als u .NET hebt geïnstalleerd met behulp van het dotnet-install-script of door een tarball te extraheren, moet u .NET verwijderen met behulp van de handmatige methode.

Wanneer u .NET handmatig installeert, wordt deze doorgaans geïnstalleerd in de map of /usr/lib/dotnet/in de /usr/share/dotnet/$HOME/.dotnet map. De SDK, runtime en .NET-host worden geïnstalleerd in afzonderlijke submappen. Deze componentmappen bevatten een map voor elke versie van .NET. Door de versiebeheermappen te verwijderen, verwijdert u die versie van .NET uit uw systeem. Deze mappen kunnen variëren, afhankelijk van uw Linux-distributie.

Er zijn drie opdrachten die u kunt gebruiken om te ontdekken waar .NET is geïnstalleerd: dotnet --list-sdks voor SDK's, dotnet --list-runtimes voor runtimes en dotnet --info voor alles. Met deze opdrachten wordt de .NET-host niet vermeld. Controleer de /usr/share/dotnet/host/fxr/ map om te bepalen welke hosts zijn geïnstalleerd. De volgende lijst vertegenwoordigt de mappen van een specifieke versie van .NET, waarbij de $version variabele de versie van .NET vertegenwoordigt:

  • SDK:

    /usr/share/dotnet/sdk/$version/

  • Runtime:

    De runtime is gebaseerd op specifieke .NET-productruntimes, zoals Microsoft.AspNetCore.All of Microsoft.NETCore.App (specifiek de .NET-runtime). Deze worden geïnstalleerd in de /usr/share/dotnet/shared/$product/$version map, waar $product de productruntime zich bevindt. U ziet bijvoorbeeld de volgende mappen:

    /usr/share/dotnet/shared/Microsoft.NETCore.App/$version/
/usr/share/dotnet/shared/Microsoft.AspNetCore.App/$version/
/usr/share/dotnet/shared/Microsoft.AspNetCore.All/$version/

  • .NET-host

    /usr/share/dotnet/host/fxr/$version/

Gebruik de rm -rf opdracht om een versie van .NET te verwijderen. Als u bijvoorbeeld de SDK 6.0.406 wilt verwijderen, voert u de volgende opdracht uit:

sudo rm -rf /usr/share/dotnet/sdk/6.0.406

Belangrijk

De versiemappen komen mogelijk niet overeen met de versie die u verwijdert. De afzonderlijke runtimes en SDK's die zijn geïnstalleerd met één .NET-release, kunnen verschillende versies hebben. U hebt bijvoorbeeld ASP.NET Core 8 Runtime geïnstalleerd, waarop de 8.0.2 ASP.NET Core-runtime en de .NET-runtime 8.0.8 zijn geïnstalleerd. Elke map heeft een andere versie. Zie Overzicht van de versie van .NET voor meer informatie.

Wanneer u .NET handmatig installeert, wordt deze doorgaans geïnstalleerd in de map of in de /usr/local/share/dotnet/$HOME/.dotnet map. De SDK, runtime en .NET-host worden geïnstalleerd in afzonderlijke submappen. Deze componentmappen bevatten een map voor elke versie van .NET. Door de versiebeheermappen te verwijderen, verwijdert u die versie van .NET uit uw systeem. Deze mappen kunnen variëren, afhankelijk van uw macOS-versie.

Er zijn drie opdrachten die u kunt gebruiken om te ontdekken waar .NET is geïnstalleerd: dotnet --list-sdks voor SDK's, dotnet --list-runtimes voor runtimes en dotnet --info voor alles. Met deze opdrachten wordt de .NET-host niet vermeld. Controleer de /usr/local/share/dotnet/host/fxr/ map om te bepalen welke hosts zijn geïnstalleerd. De volgende lijst vertegenwoordigt de mappen van een specifieke versie van .NET, waarbij de $version variabele de versie van .NET vertegenwoordigt:

  • SDK:

    /usr/local/share/dotnet/sdk/$version/

  • Runtime:

    De runtime is gebaseerd op specifieke .NET-productruntimes, zoals Microsoft.AspNetCore.All of Microsoft.NETCore.App (specifiek de .NET-runtime). Deze worden geïnstalleerd in de /usr/local/share/dotnet/shared/$product/$version map, waar $product de productruntime zich bevindt. U ziet bijvoorbeeld de volgende mappen:

    /usr/local/share/dotnet/shared/Microsoft.NETCore.App/$version/dotnet --info
/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App/$version/
/usr/local/share/dotnet/shared/Microsoft.AspNetCore.All/$version/

  • .NET-host

    /usr/local/share/dotnet/host/fxr/$version/

Gebruik de rm -rf opdracht om een versie van .NET te verwijderen. Als u bijvoorbeeld de SDK 6.0.406 wilt verwijderen, voert u de volgende opdracht uit:

sudo rm -rf /usr/local/share/dotnet/sdk/6.0.406

Belangrijk

De versiemappen komen mogelijk niet overeen met de versie die u verwijdert. De afzonderlijke runtimes en SDK's die zijn geïnstalleerd met één .NET-release, kunnen verschillende versies hebben. U hebt bijvoorbeeld ASP.NET Core 8 Runtime geïnstalleerd, waarop de 8.0.2 ASP.NET Core-runtime en de .NET-runtime 8.0.8 zijn geïnstalleerd. Elke map heeft een andere versie. Zie Overzicht van de versie van .NET voor meer informatie.

Belangrijk

Als u een Op Arm gebaseerde Mac gebruikt, zoals een mac met een M1-chip, raadpleegt u de mappaden die worden beschreven in .NET installeren op Arm-macs.

.NET-hulpprogramma voor verwijderen

Met het .NET Uninstall Tool (dotnet-core-uninstall) kunt u .NET SDK's en runtimes uit een systeem verwijderen. Er is een verzameling opties beschikbaar om op te geven welke versies moeten worden verwijderd.

Notitie

Momenteel biedt het .NET-hulpprogramma voor verwijderen geen ondersteuning voor .NET 8+. Zie GitHub - dotnet-uninstall-tool Roadmap voor meer informatie over het releaseschema van het hulpprogramma.

Visual Studio-afhankelijkheid van .NET SDK-versies

VoorDat Visual Studio 2019 versie 16.3, Visual Studio-installatieprogramma's het zelfstandige SDK-installatieprogramma voor .NET Core versie 2.1 of 2.2 genoemd. Als gevolg hiervan worden de SDK-versies weergegeven in het dialoogvenster Windows-apps en -functies . Als u .NET SDK's verwijdert die door Visual Studio zijn geïnstalleerd met behulp van het zelfstandige installatieprogramma, kan Visual Studio worden verbroken. Als Visual Studio problemen ondervindt nadat u SDK's hebt verwijderd, voert u Repair uit op die specifieke versie van Visual Studio. In de volgende tabel ziet u enkele van de Visual Studio-afhankelijkheden van .NET Core SDK-versies:

Visual Studio-versie .NET Core SDK-versie
Visual Studio 2019 versie 16.2 .NET Core SDK 2.2.4xx, 2.1.8xx
Visual Studio 2019 versie 16.1 .NET Core SDK 2.2.3xx, 2.1.7xx
Visual Studio 2019 versie 16.0 .NET Core SDK 2.2.2xx, 2.1.6xx
Visual Studio 2017 versie 15.9 .NET Core SDK 2.2.1xx, 2.1.5xx
Visual Studio 2017 versie 15.8 .NET Core SDK 2.1.4xx

Vanaf Visual Studio 2019 versie 16.3 is Visual Studio belast met een eigen exemplaar van de .NET SDK. Daarom ziet u deze SDK-versies niet meer in het dialoogvenster Apps en functies .

De NuGet-terugvalmap verwijderen

Vóór .NET Core 3.0 SDK gebruikten de .NET Core SDK-installatieprogramma's een map met de naam NuGetFallbackFolder om een cache van NuGet-pakketten op te slaan. Deze cache is gebruikt tijdens bewerkingen zoals dotnet restore of dotnet build /t:Restore. De NuGetFallbackFolder bevindt zich onder de sdk-map waar .NET is geïnstalleerd. Het kan bijvoorbeeld zijn op C:\Program Files\dotnet\sdk\NuGetFallbackFolder in Windows en op /usr/local/share/dotnet/sdk/NuGetFallbackFolder in macOS.

U kunt deze map verwijderen als:

  • U ontwikkelt alleen met .NET Core 3.0 SDK of .NET 5 of hoger.
  • U ontwikkelt met behulp van .NET Core SDK-versies ouder dan 3.0, maar u kunt online werken.

Als u de NuGet-terugvalmap wilt verwijderen, kunt u deze verwijderen, maar hiervoor hebt u beheerdersbevoegdheden nodig.

Het is niet raadzaam om de dotnet-map te verwijderen. Als u dit doet, worden alle algemene hulpprogramma's verwijderd die u eerder hebt geïnstalleerd. Ook in Windows:

  • U verbreekt Visual Studio 2019 versie 16.3 en nieuwere versies. U kunt Herstellen uitvoeren om te herstellen.
  • Als er .NET Core SDK-vermeldingen in het dialoogvenster Apps en functies staan, worden ze zwevend.