将 WinForms 应用从 .NET Core 3.0 升级到 3.1
點擊上方藍字關注“汪宇杰博客”
導語
我作為社區里的“拖控件之王”，拖控件賊心不死，有時候會維護一些老項目，其中包括一個2004年的WinForms 軟件。9月份的時候我曾經將它遷移到了 .NET Core 3.0，因為代碼實現完全沒動，所以基本沒領福報。然而 .NET Core 3.1 有一些升級上的變化，需要注意。
背景
這個 WinForms 工程是一個開源的屏幕尺工具，用于測量屏幕上元素的尺寸，由? Jeff Key 在 15 年前開發，至今好用。原作者不維護后，我將源代碼接盤維護，繼續開源在 GitHub上。
https://github.com/EdiWang/Ruler
雖然我自己也用UWP實現過類似的屏幕尺，公眾號里也發文章介紹過《》，可惜后來，UWP這個技術……嗯，不提了，話說這把屏幕尺支持橫豎兩種排版、固頂顯示、透明度調整等常用功能，大家有需要的話歡迎下載使用。
升級到.NET Core 3.1
這個工程最早是 .NET Framework 2.0 的，升級到 .NET Core 3.0 的步驟我不多介紹了，官網或社區都有詳細的教程，由于功能簡單，并不需要代碼實現和邏輯上的修改。但是 .NET Core 3.1 移除了一些老控件，因此這次升級需要修改代碼。
先來看看官方的說明：
Windows Forms Controls Removal
The following Windows Forms controls have been removed from .NET Core 3.1:
DataGrid
ToolBar
ContextMenu
Menu
MainMenu
MenuItem
These controls were replaced with more powerful controls in .NET Framework 2.0, back in 2005. They have not been available by default in the Visual Studio Designer Toolbox for many years. As a result, we decided to remove these controls and focus only on the new ones.
官方也給出了這些被刪庫的老控件的替換方案：
參見?https://devblogs.microsoft.com/dotnet/announcing-net-core-3-1/
在這個Ruler工程中，我需要遷移的主要就是菜單控件。
類型替換
將?ContextMenu 替換為?ContextMenuStrip
將?MenuItem 替換為?ToolStripMenuItem
如：
private readonly ContextMenu _menu = new ContextMenu();
private MenuItem _verticalMenuItem;
private MenuItem _toolTipMenuItem;
替換為
private readonly ContextMenuStrip _menu = new ContextMenuStrip();
private ToolStripMenuItem _verticalMenuItem;
private ToolStripMenuItem _toolTipMenuItem;
API 差異
Shortcut 枚舉類型被刪庫，老代碼：
private MenuItem AddMenuItem(string text, Shortcut shortcut = Shortcut.None)
{
? ? MenuItem mi = new MenuItem(text);
? ? mi.Click += MenuHandler;
? ? mi.Shortcut = shortcut;
? ? _menu.MenuItems.Add(mi);
? ? return mi;
}
改為
Keys shortcut = Keys.None
...
mi.ShortcutKeys = shortcut;
類似的，MenuItems屬性被刪庫，老代碼：
_menu.MenuItems.Add(mi);
改為
_menu.Items.Add(mi);
這段函數升級后的完整代碼：
private ToolStripMenuItem AddMenuItem(string text, Keys shortcut = Keys.None)
{
? ? ToolStripMenuItem mi = new ToolStripMenuItem(text);
? ? mi.Click += MenuHandler;
? ? mi.ShortcutKeys = shortcut;
? ? _menu.Items.Add(mi);
? ? return mi;
}
在舊版Menu控件里，“-” 字符串代表分隔符，這個現在也有專門的類型表示，所以老代碼：
AddMenuItem("-");
修改為
_menu.Items.Add(new ToolStripSeparator());
現在就能成功編譯運行了，新版菜單控件效果如下：
至此，升級.NET Core 3.1的工作全部完成！
創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎總結
以上是生活随笔為你收集整理的将 WinForms 应用从 .NET Core 3.0 升级到 3.1的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： C# Lazy Loading
- 下一篇： asp.net ajax控件工具集 Au