Delen via

Projecten upgraden met .NET Upgrade Assistant

  • Artikel

Het is de focus van dit artikel om de basisstappen te bieden voor het upgraden van een project met .NET Upgrade Assistant. Dit omvat het initiëren van de upgrade en het controleren van de resultaten. Op basis van hoe complex uw project is, moet u mogelijk handmatige updates voor uw code uitvoeren.

Sommige projecttypen hebben specifieke richtlijnen voor het upgraden. Zie Ondersteunde projecttypen voor meer informatie.

Vereisten

Een project upgraden in Visual Studio

Volg deze stappen om een project bij te werken in Visual Studio.

  1. Maak een back-up van uw code.

  2. Open Visual Studio.

  3. Open een project of oplossing.

  4. Klik in het venster Solution Explorer met de rechtermuisknop op de projectupgrade>.

    Het Solution Explorer-venster in Visual Studio met het snelmenu van een project. Het menu-item Upgrade is gemarkeerd.

  5. Selecteer op het tabblad Upgrade de juiste upgradeopties.

    Op basis van het type project en de doelframeworkversie worden verschillende opties weergegeven. In de volgende afbeelding ziet u twee opties bij het upgraden van een Windows Forms voor .NET Framework-project. Deze opties worden niet weergegeven wanneer u een .NET-project bijwerkt:

    Het welkomstscherm van de .NET Upgrade Assistant in Visual Studio.

    In dit voorbeeld selecteert u Een upgradeproject naar een nieuwere .NET-versie.

  6. Selecteer hoe u de upgrade wilt uitvoeren. Selecteer In-place projectupgrade en selecteer vervolgens Volgende.

    Sommige projecten kunnen u slechts met één optie presenteren. Zie Hoe de upgrade moet worden uitgevoerd voor meer informatie over deze opties.

    De wizard .NET-upgradeassistent met de selectie 'Wat is uw upgradetype'. 'In-place projectupgrade' is gemarkeerd, net als de knop 'Volgende'.

  7. Selecteer het doelframework, bijvoorbeeld .NET 8.0. Selecteer vervolgens Volgende.

    De wizard .NET-upgradeassistent met de selectie 'Wat is uw voorkeursdoelframework'. .NET 8.0 is gemarkeerd, net als de knop Volgende.

  8. Selecteer de onderdelen die u wilt upgraden en selecteer vervolgens Upgradeselectie.

    De wizard .NET-upgradeassistent met de selectie Onderdelen selecteren die u wilt upgraden. De lijst met onderdelen is gemarkeerd, net als de knop Upgradeselectie.

  9. Zodra de upgrade is voltooid, wordt een lijst met verwerkte items weergegeven.

    De wizard .NET-upgradeassistent met het overzichtsscherm. Elk artefact dat door de upgrade wordt verwerkt, wordt weergegeven met een statuspictogram.

Elk artefact dat door de upgrade wordt verwerkt, wordt vermeld, samen met de status. Zie Upgraderesultaten voor meer informatie.

Een project upgraden vanuit de CLI

Volg deze stappen om een project bij te werken met behulp van de terminal. Het .NET Global Tool is een interactief hulpprogramma dat u begeleidt bij de upgradeopties. Gebruik de toetsen Pijl-omhoog en Pijl-omlaag om de gemarkeerde optie te wijzigen en Voer Enter uit om de optie te selecteren. Elk scherm bevat opties voor het configureren van de upgrade.

  1. Maak een back-up van uw code.

  2. Open een terminal en navigeer naar de map met de oplossing of het project dat u wilt upgraden.

  3. Voer de upgrade-assistant upgrade opdracht uit om het hulpprogramma te starten.

    U wordt gevraagd wat u wilt upgraden. Afhankelijk van wat wordt gedetecteerd, kunnen sommige opties automatisch worden toegepast of volledig ontbreken.

    Een terminal met het eerste scherm met opties voor .NET Upgrade Assistant Global Tool. De vraag 'Welk project wilt u upgraden' wordt gevraagd.

  4. Als er meer dan één project wordt gevonden, kiest u een van de projecten en drukt u op Enter.

    Werk projecten in de volgorde van hun afhankelijkheid bij. In de vorige afbeelding zijn bijvoorbeeld twee projecten getoond: MatchingGame en MatchingGame.Logic. MatchingGame is afhankelijk MatchingGame.Logicvan, dus MatchingGame.Logic moet eerst worden bijgewerkt.

  5. Als u een optie hebt om het upgradetype te wijzigen, kiest u er een en drukt u op Enter. Als er slechts één optie beschikbaar was, zou deze automatisch zijn geselecteerd.

    Zie Hoe de upgrade moet worden uitgevoerd voor meer informatie over deze opties.

    Tip

    Als u een back-up van uw code hebt gemaakt, kunt u een in-place projectupgrade selecteren.

  6. Kies een doelframework, zoals .NET 8.0, en druk op Enter.

  7. De laatste prompt is een bevestiging, waarin alle geselecteerde opties worden weergegeven. Druk op Enter om de upgrade te starten.

    Een terminal met het overzichtsscherm met opties voor .NET Upgrade Assistant Global Tool. De gebruiker wordt gevraagd door te gaan.

  8. Zodra de upgrade is voltooid, wordt een samenvatting weergegeven.

    Een terminal met de resultaten van de upgradeopdracht bij gebruik van het algemene hulpprogramma .NET Upgrade Assistant.

Gerelateerde inhoud