點(diǎn)擊上方藍(lán)字關(guān)注“汪宇杰博客”

導(dǎo)語

我作為社區(qū)里的“拖控件之王”，拖控件賊心不死，有時(shí)候會(huì)維護(hù)一些老項(xiàng)目，其中包括一個(gè)2004年的WinForms 軟件。9月份的時(shí)候我曾經(jīng)將它遷移到了 .NET Core 3.0，因?yàn)榇a實(shí)現(xiàn)完全沒動(dòng)，所以基本沒領(lǐng)福報(bào)。然而 .NET Core 3.1 有一些升級(jí)上的變化，需要注意。

背景

這個(gè) WinForms 工程是一個(gè)開源的屏幕尺工具，用于測(cè)量屏幕上元素的尺寸，由? Jeff Key 在 15 年前開發(fā)，至今好用。原作者不維護(hù)后，我將源代碼接盤維護(hù)，繼續(xù)開源在 GitHub上。

https://github.com/EdiWang/Ruler

雖然我自己也用UWP實(shí)現(xiàn)過類似的屏幕尺，公眾號(hào)里也發(fā)文章介紹過《》，可惜后來，UWP這個(gè)技術(shù)……嗯，不提了，話說這把屏幕尺支持橫豎兩種排版、固頂顯示、透明度調(diào)整等常用功能，大家有需要的話歡迎下載使用。

升級(jí)到.NET Core 3.1

這個(gè)工程最早是 .NET Framework 2.0 的，升級(jí)到 .NET Core 3.0 的步驟我不多介紹了，官網(wǎng)或社區(qū)都有詳細(xì)的教程，由于功能簡(jiǎn)單，并不需要代碼實(shí)現(xiàn)和邏輯上的修改。但是 .NET Core 3.1 移除了一些老控件，因此這次升級(jí)需要修改代碼。

先來看看官方的說明：

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/

在這個(gè)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);

這段函數(shù)升級(jí)后的完整代碼：

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控件里，“-” 字符串代表分隔符，這個(gè)現(xiàn)在也有專門的類型表示，所以老代碼：

AddMenuItem("-");

修改為

_menu.Items.Add(new ToolStripSeparator());

現(xiàn)在就能成功編譯運(yùn)行了，新版菜單控件效果如下：

至此，升級(jí).NET Core 3.1的工作全部完成！

創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)

總結(jié)

以上是生活随笔為你收集整理的将 WinForms 应用从 .NET Core 3.0 升级到 3.1的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。