共用方式為


將 .NET Framework Windows Forms 傳統型應用程式升級至至 .NET 8

本文說明如何使用升級小幫手,將 Windows Forms 傳統型應用程式升級至 .NET 8。 雖然 Windows Forms 是在 .NET 上執行,但跨平台技術 Windows Forms 仍是是僅限 Windows 的架構。 您可以使用 .NET 升級小幫手來升級下列 Windows Forms 相關專案類型:

  • Windows Forms 專案
  • 控制項程式庫
  • .NET 程式庫

必要條件

先升級相依性

如果您要升級多重專案,請從沒有相依性的專案開始。 在比對遊戲範例中,MatchingGame 專案相依於 MatchingGame.Logic 程式庫,因此應先升級 MatchingGame.Logic

提示

請務必備份您的程式碼,例如在原始檔控制或複本中。

使用下列步驟升級 Visual Studio 中的專案:

  1. 以滑鼠右鍵按一下 [方案總管] 視窗中的 MatchingGame.Logic 專案,然後選取 [升級]

    此螢幕擷取畫面顯示 Visual Studio 中 .NET 升級小幫手的 [升級] 功能表項目。

    隨即開啟新的索引標籤,提示您選擇要執行的升級類型。

  2. 選取 [將專案升級為較新的 .NET 版本]

    此螢幕擷取畫面顯示 .NET 升級小幫手索引標籤。其中強調顯示 [將專案升級至較新的 .NET 版本] 選項。

  3. 選取 [就地專案升級]

    此螢幕擷取畫面顯示 .NET 升級小幫手索引標籤。其中強調顯示 [就地專案升級] 選項。

  4. 接下來,選取目標 Framework。 根據您要升級的專案類型,系統會顯示不同的選項。 .NET Framework 和 .NET 都可以使用 .NET Standard 2.0。 如果程式庫不依賴 Windows Forms 之類的桌面技術,這是不錯的選擇。 不過,最新的 .NET 版本透過 .NET Standard 提供許多語言和編譯器的改進項目。

    選取 [.NET 8.0 ],然後選取 [下一步]

    此螢幕擷取畫面顯示 .NET 升級小幫手。已開啟目標 Framework 提示,並強調顯示 .NET 8 和 [下一步] 按鈕。

  5. 樹狀結構會顯示與專案相關的所有成品,例如程式碼檔案和程式庫。 您可以升級個別成品或整個專案,這是預設值。 選取 [升級選取項目] 以開始升級。

  6. 升級完成時,會顯示結果:

    此螢幕擷取畫面顯示 .NET 升級小幫手的升級結果索引標籤,其中顯示從專案移轉的項目。

    已升級具有實心綠色圓圈的成品,同時略過空的綠色圓圈。 略過的成品表示升級小幫手找不到任何升級項目。

現在已升級應用程式的支援程式庫,請升級主應用程式。

升級主要專案

升級所有支援程式庫之後,即可升級主應用程式專案。 使用範例應用程式時,只有一個要升級的程式庫專案,已在上一節中升級。

  1. 以滑鼠右鍵按一下 [方案總管] 視窗中的 MatchingGame 專案,然後選取 [升級]
  2. 選取 [將專案升級為較新的 .NET 版本]
  3. 選取 [就地專案升級] 做為升級模式。
  4. 針對目標 Framework 選取 [.NET 8.0],然後選取 [下一步]
  5. 保留選取的所有成品,然後選取 [升級選取項目]

升級完成後,會顯示結果。 請注意,Windows Forms 專案是如何產生警告符號。 展開該項目,並顯示有關該步驟的詳細資訊:

此螢幕擷取畫面顯示 .NET 升級小幫手的升級結果索引標籤,其中顯示部分結果項目有警告符號。

請注意,專案升級元件提到預設字型已變更。 因為字型可能會影響控制項版面配置,因此您必須檢查專案中的每個表單和自訂控制項,以確保 UI 排列正確。

產生全新組建

升級主要專案之後,請清除專案並加以編譯。

  1. 以滑鼠右鍵按一下 [方案總管] 視窗中的 MatchingGame 專案,然後選取 [清除]
  2. 以滑鼠右鍵按一下 [方案總管] 視窗中的 MatchingGame 專案,然後選取 [組建]

如果您的應用程式發生任何錯誤,您可以在 [錯誤清單] 視窗中找到這些錯誤,以及如何修正這些錯誤的建議。

Windows Forms Matching Game 範例專案現已升級至 .NET 8。