.NET-upgradeassistent installeren

In dit artikel leert u hoe u .NET Upgrade Assistant installeert in Visual Studio of met het opdrachtregelinterfaceprogramma (CLI).

Belangrijk

.NET Upgrade Assistant is officieel afgeschaft. Gebruik in plaats daarvan de GitHub Copilot-moderniseringschatagent , die is opgenomen in Visual Studio 2026 en Visual Studio 2022 17.14.16 of hoger. Deze agent analyseert uw projecten en afhankelijkheden, produceert een stapsgewijs migratieplan met gerichte aanbevelingen en geautomatiseerde codecorrecties en voert elke wijziging door, zodat u deze kunt valideren of terugdraaien. Het automatiseert veelvoorkomende overdrachtstaken, het bijwerken van projectbestanden, het vervangen van afgeschafte API's en het oplossen van buildproblemen, zodat u sneller kunt moderniseren met minder handmatige inspanning.

Vereisten

Methoden

.NET Upgrade Assistant is ingebouwd in Visual Studio of kan worden geïnstalleerd als een .NET Global Tool.

De upgradeassistent wordt uitgevoerd in Visual Studio, op de oplossing of het project dat u hebt geopend. Het .NET Global Tool is een interactieve consoletoepassing die wordt uitgevoerd op een oplossing of projectbestand in of onder de huidige map.

Als u de gestroomlijnde ervaring van het openen van een project in Visual Studio wilt en een upgrade wilt uitvoeren, gebruikt u de upgradeassistent.

Visual Studio

Met de volgende stappen schakelt u de verouderde upgradeassistent in Visual Studio in.

  1. Open Visual Studio.

    Als het Open Recent \ Aan de slag venster opent, selecteer de link Doorgaan zonder code.

  2. Selecteer de Tools>Opties menu, waarmee het Opties venster wordt geopend.

  3. Navigeer naar Alle instellingen>Projecten en oplossingen>Modernisering.

  4. Selecteer het item Verouderde upgradeassistent inschakelen .

  5. Visual Studio opnieuw starten

    Een schermafbeelding met het venster Opties in Visual Studio met de pagina Moderniseringsinstellingen geopend.

.NET Global Tool (een wereldwijd bruikbaar hulpprogramma voor .NET)

Met de volgende stappen installeert u .NET Upgrade Assistant als een .NET Global Tool. .NET Upgrade Assistant wordt gedistribueerd in het NuGet-pakket met upgradeassistenten.

  1. Open een commandprompt met de dotnet command in Path.

  2. Voer de volgende opdracht uit om het hulpprogramma te installeren:

    dotnet tool install -g upgrade-assistant

    Belangrijk

    Het installeren van dit hulpprogramma kan mislukken als u een andere NuGet-feedbron hebt geconfigureerd. Gebruik de --ignore-failed-sources parameter om deze fouten te behandelen als waarschuwingen in plaats van fouten, waarbij deze andere NuGet-feedbronnen worden overgeslagen:

    dotnet tool install -g --ignore-failed-sources upgrade-assistant

Validatie

De volgende informatie helpt u te bepalen of .NET Upgrade Assistant is geïnstalleerd.

  • Visual Studio

    Als u wilt bepalen of .NET-upgradeassistent is ingeschakeld, klikt u met de rechtermuisknop op een .NET- of .NET Framework-project in het Solution Explorer-venster en controleert u op een menu-item Upgrade .

  • .NET Global Tool

    Open een opdrachtprompt en voer de upgrade-assistant opdracht uit. Als het opdrachtantwoord aangeeft dat de opdracht onbekend is, is het hulpprogramma niet correct geïnstalleerd of niet in PATH.

Problemen oplossen - .NET Global Tool

Als u extra NuGet-feedbronnen hebt geconfigureerd, kan de installatie mislukken met een fout die aangeeft dat het NuGet-pakket niet beschikbaar is in de feed. Gebruik de --ignore-failed-sources parameter om deze fouten te behandelen als waarschuwingen in plaats van fouten, waarbij de andere NuGet-feedbronnen worden overgeslagen:

dotnet tool install -g --ignore-failed-sources upgrade-assistant
  • Last updated on