Co je Pomocník pro upgrade .NET?

Pomocník pro upgrade platformy .NET pomáhá s upgradem projektů na novější verze .NET a analyzuje váš kód a zjistí a opraví potenciální nekompatibilitu. Jedním z nástrojů je pomoct s upgradem projektu z rozhraní .NET Framework, .NET Core nebo .NET na nejnovější verzi .NET. Rozšíření nebo nástroj použijete k upgradu celých projektů .NET nebo některého aspektu projektu, například upgrade konfiguračního souboru ze staršího typu na novější typ.

Pomocník pro upgrade .NET se distribuuje jako rozšíření sady Visual Studio nebo nástroj rozhraní příkazového řádku (CLI).

Důležité

Pomocník pro upgrade platformy .NET je oficiálně zastaralý. Místo toho použijte agenta chatu modernizace aplikace GitHub Copilot, který je součástí sady Visual Studio 2026 a sady Visual Studio 2022 verze 17.14.16 nebo novější. Tento agent analyzuje vaše projekty a závislosti, vytvoří podrobný plán migrace s cílenými doporučeními a automatizovanými opravami kódu a potvrdí každou změnu, abyste ji mohli ověřit nebo vrátit zpět. Automatizuje běžné úlohy přenosu – aktualizace souborů projektu, nahrazení zastaralých rozhraní API a řešení problémů se sestavením– abyste mohli rychleji modernizovat s menším ručním úsilím.

Analýza a upgrade

Pomocník pro upgrade platformy .NET obsahuje analytický modul, který kontroluje vaše projekty a jejich závislosti. Po dokončení kontroly se vygeneruje sestava s podrobnými informacemi o provedení upgradu. Tyto informace můžete použít k upgradu celého projektu nebo konkrétních částí projektu.

Podporované typy projektů

Pomocník pro upgrade .NET podporuje upgrade projektů kódovaných v jazyce C# nebo Visual Basic. Podporují se následující typy projektů:

• ASP.NET
• Azure Functions
• Windows Presentation Foundation
• model Windows Forms
• Knihovny tříd
• Aplikace konzoly
• Xamarin Forms
• .NET MAUI
• UpW nativní pro .NET

Některé produkty poskytují pokyny k používání pomocníka pro upgrade platformy .NET.

• ASP.NET
• Prezentační základ Windows
• Windows Forms
• Univerzální platforma Windows
• Windows Communication Foundation

Cesty upgradu

Podporují se tyto možnosti upgradu:

• .NET Framework do .NET
• .NET Core do .NET
• Izolované řešení Azure Functions v1–v3 až v4 (cílení na net6.0+)
• UPW na WinUI 3
• Předchozí verze .NET na nejnovější verzi .NET
• Xamarin Forms do .NET MAUI
  • Transformace souborů XAML podporují pouze upgrade oborů názvů. Pokud chcete komplexnější transformace, použijte Visual Studio 2022 nebo novější.

Podrobnosti a možnosti upgradu

Po spuštění upgradu vás průvodce provede konfigurací některých možností před zahájením upgradu. Na základě typu projektu, který upgradujete, zobrazí průvodce různé možnosti. Příklad upgradu projektu najdete v tématu Upgrade projektů pomocí pomocníka s upgradem platformy .NET.

Jak se má upgrade provést

Na základě typu projektu, který upgradujete, můžete změnit způsob provedení upgradu. Typ projektu ovlivňuje, které možnosti jsou k dispozici, a některé z následujících položek můžou chybět:

• Místní upgrade projektu

  Tato možnost upgraduje projekt bez vytvoření kopie.

• Souběžný upgrade projektu

  Zkopíruje projekt a upgraduje kopii a ponechá původní projekt sám.

• Přírůstkové souběžné

  To je dobrá volba pro složité webové aplikace. Upgrade z ASP.NET na ASP.NET Core vyžaduje poměrně hodně práce a občas ruční refaktoring. Tento režim umístí projekt .NET vedle existujícího projektu .NET Framework. Koncové body se směrují přes projekt .NET, zatímco všechna ostatní volání se posílají do aplikace .NET Framework.

  Tento režim umožňuje pomalu upgradovat ASP.NET nebo knihovnu aplikace kus po kusu.

Výsledky upgradu

Po dokončení upgradu se zobrazí stavová obrazovka zobrazující všechny artefakty přidružené k upgradu. Každý artefakt upgradu je možné rozbalit a přečíst si další informace o stavu. Následující seznam popisuje ikony stavu:

• Nezaplněná zelená značka zaškrtnutí: Nástroj nenalezl nic o artefaktu, který se má upgradovat.
• Plná zelená značka zaškrtnutí: Artefakt byl upgradován a úspěšně dokončen.
• Žluté upozornění: Artefakt byl upgradován, ale měli byste zvážit důležité informace.
• Červený X: Upgrade artefaktu nebyl úspěšný.

Kromě toho se akce provedené během upgradu zaprotokolují do okna Výstup ve zdroji Pomocníka pro upgrade, jak je znázorněno na následujícím obrázku:

Po upgradu projektu ho důkladně otestujte!

Související obsah

• Co je analýza kódu pomocí pomocníka pro upgrade .NET?
• Instalace Pomocníka s upgradem na .NET
• Analýza projektů pomocí pomocníka pro upgrade platformy .NET
• Upgrade projektů pomocí pomocníka pro upgrade platformy .NET