Postup upgradu desktopové aplikace model Windows Forms na .NET 7

Článek
02/06/2024

Tento článek popisuje, jak upgradovat desktopovou aplikaci model Windows Forms na .NET 7. I když model Windows Forms běží na platformě .NET, technologie pro různé platformy, model Windows Forms je stále jen pro Windows. Pomocí pomocníka pro upgrade platformy .NET je možné upgradovat následující typy projektů souvisejících s model Windows Forms:

projekt model Windows Forms
Knihovna ovládacích prvků
Knihovna .NET

Měli byste také zkontrolovat informace v průvodci portováním z rozhraní .NET Framework do .NET .

Požadavky

Ukázková aplikace

Tento článek byl napsán v kontextu upgradu projektu model Windows Forms Matching Game Sample, který si můžete stáhnout z úložiště GitHub s ukázkami .NET.

Zahájení upgradu

Pokud upgradujete více projektů, začněte projekty, které nemají žádné závislosti. V ukázce odpovídající hry projekt MatchingGame závisí na knihovně MatchingGame.Logic, takže matchingGame.Logic by se měl nejprve upgradovat.

Tip

Nezapomeňte mít zálohu kódu, například ve správě zdrojového kódu nebo kopii.

Pomocí následujících kroků upgradujte projekt v sadě Visual Studio:

V okně Průzkumník řešení klikněte pravým tlačítkem na projekt MatchingGame.Logic a vyberte Upgradovat:

Otevře se nová karta s výzvou k výběru způsobu provedení upgradu.
Vyberte místní upgrade projektu.
Dále vyberte cílovou architekturu. Na základě typu projektu, který upgradujete, se zobrazí různé možnosti. .NET Standard 2.0 je dobrou volbou, pokud knihovna nespoléhá na desktopovou technologii, jako je Windows Froms, a je možné ji používat v projektech .NET Framework i projektech .NET. Nejnovější verze .NET však poskytují mnoho vylepšení jazyka a kompilátoru oproti .NET Standard.

Vyberte .NET 7.0 a pak vyberte Další.
Zobrazí se strom se všemi artefakty souvisejícími s projektem, jako jsou soubory kódu a knihovny. Můžete upgradovat jednotlivé artefakty nebo celý projekt, což je výchozí nastavení. Výběrem možnosti Upgradovat spustíte upgrade.

Po dokončení upgradu se zobrazí výsledky:

Artefakty s plným zeleným kruhem byly upgradovány, zatímco prázdné zelené kruhy byly vynechány. Vynechané artefakty znamenají, že pomocník s upgradem nic nenalezl.

Teď, když je upgradovaná podpůrná knihovna aplikace, upgradujte hlavní aplikaci.

Upgrade aplikace

Po upgradu všech podpůrných knihoven je možné upgradovat hlavní projekt aplikace. V ukázkové aplikaci existuje pouze jeden projekt knihovny, který se upgradoval v předchozí části.

V okně Průzkumník řešení klikněte pravým tlačítkem na projekt MatchingGame a vyberte Upgradovat:
Jako režim upgradu vyberte místní upgrade projektu.
Vyberte .NET 7.0 pro cílovou architekturu a vyberte Další.
Ponechte všechny vybrané artefakty a vyberte Upgradovat výběr.

Po dokončení upgradu se zobrazí výsledky. Všimněte si, jak má projekt model Windows Forms symbol upozornění. Rozbalte tuto položku a zobrazí se další informace o daném kroku:

The .NET Upgrade Assistant's upgrade results tab, showing some of the result items have warning symbols.

Všimněte si, že komponenta upgradu projektu uvádí, že se změnilo výchozí písmo. Vzhledem k tomu, že písmo může mít vliv na rozložení ovládacího prvku, musíte zkontrolovat každý formulář a vlastní ovládací prvek v projektu, aby se zajistilo správné uspořádání uživatelského rozhraní.

Vygenerování čistého sestavení

Po upgradu projektu ho vyčistěte a zkompilujte.

V okně Průzkumník řešení klikněte pravým tlačítkem myši na projekt MatchingGame a vyberte Vyčistit.
V okně Průzkumník řešení klikněte pravým tlačítkem na projekt MatchingGame a vyberte Sestavit.

Pokud vaše aplikace zjistila nějaké chyby, můžete je najít v okně Seznam chyb s doporučením, jak je opravit.

Závěr

Projekt model Windows Forms Matching Game Sample je nyní upgradován na .NET 7. Výsledky se budou lišit při migraci vlastního projektu. Po upgradu na .NET z článku .NET Framework nezapomeňte zkontrolovat průvodce portováním z rozhraní .NET Framework na .NET a modernizovat.