Overzicht van de .NET-upgradeassistent
Nieuwe versies van .NET worden het hele jaar door uitgebracht, met een grote release eenmaal per jaar. Met de .NET Upgrade Assistant kunt u apps upgraden van eerdere versies van .NET, .NET Core en .NET Framework naar de nieuwste versie.
De .NET Upgrade Assistant is een Visual Studio-extensie en opdrachtregelprogramma dat is ontworpen om te helpen bij het upgraden van apps naar de nieuwste versie van .NET.
Problemen met betrekking tot de .NET-upgradeassistent kunnen worden opgeslagen in Visual Studio door Een probleem te selecteren bij het verzenden van feedbackrapport>.>
De upgradeassistent installeren
De .NET Upgrade Assistant kan worden geïnstalleerd als een Visual Studio-extensie of als een .NET-opdrachtregelprogramma. Zie De .NET-upgradeassistent installeren voor meer informatie.
Ondersteunde talen
De volgende codetalen worden ondersteund:
- C#
- Visual Basic
Ondersteunde projecten
De volgende typen projecten worden ondersteund:
- ASP.NET
- Azure Functions
- Windows Presentation Foundation
- Windows Forms
- Klassebibliotheken
- Console-apps
- SYSTEEMEIGEN .NET UWP
- Xamarin Forms
- .NET MAUI
Upgradepaden
De volgende upgradepaden worden ondersteund:
- .NET Framework naar .NET
- .NET Core naar .NET
- UWP naar WinUI 3
- Vorige .NET-versie naar de nieuwste .NET-versie
- Azure Functions v1-v3 naar v4 geïsoleerd
- Xamarin Forms naar .NET MAUI
- XAML-bestandstransformaties bieden alleen ondersteuning voor het upgraden van naamruimten. Gebruik Visual Studio 2022 versie 17.6 of hoger voor uitgebreidere transformaties.
Upgrade uitvoeren met de Visual Studio-extensie
Nadat u de extensie .NET Upgrade Assistant hebt geïnstalleerd, klikt u met de rechtermuisknop op het project in het Solution Explorer-venster en selecteert u Upgraden.
Let op
Zorg ervoor dat u een back-up maakt van uw projecten voordat u een upgrade uitvoert als u geen broncodebeheer gebruikt.
Er wordt een tabblad geopend dat, op basis van uw projecttype, verschillende stijlen voor upgrade biedt:
In-place projectupgrade
Met deze optie wordt uw project bijgewerkt zonder een kopie te maken.
Projectupgrade naast elkaar
Kopieert uw project en werkt de kopie bij, waardoor uw oorspronkelijke project alleen blijft.
Incrementeel naast elkaar
Een goede keuze voor gecompliceerde web-apps. Het upgraden van ASP.NET naar ASP.NET Core vereist nogal wat werk en soms handmatige herstructurering. In deze modus wordt een .NET-project naast uw bestaande .NET Framework-project geplaatst en worden eindpunten gerouteerd die zijn geïmplementeerd in het .NET-project, terwijl alle andere aanroepen naar de .NET Framework-toepassing worden verzonden.
Met deze modus kunt u uw ASP.NET- of bibliotheek-app stapsgewijs upgraden.
Zodra uw app is bijgewerkt, wordt er een statusscherm weergegeven waarin alle artefacten worden weergegeven die betrekking hebben op uw project dat is gekoppeld aan de upgrade. Elk upgradeartefact kan worden uitgebreid voor meer informatie over de status. In de volgende lijst worden de statuspictogrammen beschreven:
- Ingevuld groen vinkje: het artefact is bijgewerkt en voltooid.
- Niet-ingevuld groen vinkje: het hulpprogramma heeft niets gevonden over het artefact dat moet worden bijgewerkt.
- Geel waarschuwingsteken: het artefact is bijgewerkt, maar er is belangrijke informatie die u moet overwegen.
- Red X: Het artefact moet worden bijgewerkt, maar de upgrade is mislukt.
Daarnaast worden de acties die de upgradeassistent heeft uitgevoerd, vastgelegd in het uitvoervenster onder de bron upgradeassistent , zoals wordt weergegeven in de volgende afbeelding:
Na het upgraden van uw project moet u het grondig testen.
Upgrade uitvoeren met het CLI-hulpprogramma
Nadat u het CLI-hulpprogramma .NET Upgrade Assistant hebt geïnstalleerd, opent u een terminalvenster en gaat u naar de map met het project dat u wilt upgraden. U kunt de upgrade-assistant --help
opdracht gebruiken om de beschikbare opties te bekijken die de CLI biedt.
Let op
Zorg ervoor dat u een back-up maakt van uw projecten voordat u een upgrade uitvoert als u geen broncodebeheer gebruikt.
Voer het hulpprogramma uit met de upgrade-assistant upgrade
opdracht, alle projecten uit de huidige map en hieronder, worden weergegeven. Het CLI-hulpprogramma biedt een interactieve manier om te kiezen welk project u wilt upgraden. Gebruik de pijltoetsen om een item te selecteren en druk op Enter om het item uit te voeren. Selecteer het project dat u wilt upgraden. In het voorbeeld van dit artikel bevinden zich vier projecten onder de huidige map:
Selected options
───────────────────────────────────────────────────────────
No options specified, follow steps below to continue
Steps
─────────────────
Source project
─────────────────
Which project do you want to upgrade (found 9)?
> MatchingGame (winforms\MatchingGame\MatchingGame.csproj)
MatchingGame.Logic (winforms\MatchingGame.Logic\MatchingGame.Logic.csproj)
StarVoteControl (csharp\StarVoteControl\StarVoteControl.csproj)
WebSiteRatings (csharp\WebSiteRatings\WebSiteRatings.csproj)
Navigation
Exit
Afhankelijk van het project dat u bijwerkt, krijgt u mogelijk een optie te zien om op te geven hoe de upgrade moet worden voortgezet:
In-place projectupgrade
Met deze optie wordt uw project bijgewerkt zonder een kopie te maken.
Projectupgrade naast elkaar
Deze optie is alleen beschikbaar voor .NET Framework-projecten. Kopieert uw project en werkt de kopie bij, waardoor uw oorspronkelijke project alleen blijft.
Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Source project C:\Code\winforms\MatchingGame\MatchingGame.csproj
Steps
───────────────────────────────
Source project / Upgrade type
───────────────────────────────
How do you want to upgrade project MatchingGame?
> In-place project upgrade
Side-by-side project upgrade
Navigation
Back
Exit
Als er na deze stap meer dan één upgradable doelframework is, kiest u een doel:
Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Source project C:\Code\Work\dotnet\dotnet-docs\docs\core\porting\snippets\upgrade-assistant-wpf-framework\winforms\MatchingGame\MatchingGame.csproj
Ugrade type Inplace
Steps
──────────────────────────────────────────────────
Source project / Ugrade type / Target framework
──────────────────────────────────────────────────
What is your preferred target framework?
> .NET 6.0 (Supported until November, 2024)
.NET 7.0 (Supported until May, 2024)
.NET 8.0 (Try latest preview features)
Navigation
Back
Exit
Na het upgraden van uw project moet u het grondig testen.
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor