Share via


De .NET Runtime en SDK verwijderen

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 de instellingenpagina voor Windows-apps en -functies of > apps geïnstalleerd apps om versies van de .NET-runtime en SDK te verwijderen. Gebruik het menu Start om te zoeken naar Programma's toevoegen of verwijderen om de pagina Instellingen te openen, zoals wordt geïllustreerd door de volgende afbeelding: afbeelding toont het dialoogvenster Apps en functies . U kunt zoeken naar core of .net om geïnstalleerde versies van .NET te filteren en weer te geven.

Het Menu Start van Windows met de tekst Toevoegen of Verwijderen om de zoekresultaten te filteren

Zoek op de instellingenpagina naar .net om de versies te vinden die op uw computer zijn geïnstalleerd. Selecteer ...>Verwijder het item om het te verwijderen. Als u Windows 10 gebruikt, selecteert u de knop Verwijderen voor het item dat u wilt verwijderen. In de volgende afbeelding ziet u de pagina Geïnstalleerde apps-instellingen in Windows 11:

Het dialoogvenster Geïnstalleerde Windows-apps met het woord '.net' in de zoekbalk. In de resultaten worden versies van .NET Framework en .NET weergegeven die zijn geïnstalleerd.

Belangrijk

Als het item dat u verwijdert, aangeeft dat het afkomstig is van Visual Studio, gebruikt u het Installatieprogramma van Visual Studio om deze versies van .NET te 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 Stream, 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-hulpprogramma voor verwijderen 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. Zie het overzicht van het .NET-hulpprogramma voor verwijderen voor meer informatie.

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.