














MWGA是Make WinForms Great Again的缩写,它是一个工具软件,能快速地将使用了GDI+的WinForm.NET程序快速迁移到Blazor WASM平台上,将程序代码修改量控制在10%以下,从而复活全球1000亿行C#代码。
据估计,全球范围内企业级生产环境中运行着1000万至1500万个WinForms应用程序。在这些应用中,60%至80%有现代化改造需求,其中40%至60%优先选择Web化迁移,涉及的C#代码可能有数千亿行。由于可复用C#代码且具备基于浏览器的跨平台能力,Blazor WebAssembly成为热门选择。
但是有大量的WinForms使用了System.Drawing模块调用GDI+进行复杂的自定义绘图和交互,这些部分难以迁移,通常需要重写或大幅修改。为此,市场上对低改动、可复用业务逻辑和绘图代码的现代化迁移解决方案需求强烈。但长期以来一直缺乏有效工具和方法,导致许多企业面临高昂的重写成本和风险,存在巨大供需矛盾。
MWGA就是专门帮助将WinForms应用程序迁移到Blazor WASM平台上,即使这些程序使用GDI+功能,我们也预期将对这些程序源码的修改量不超过10%。这极大的降低WinForms软件现代化的成本和风险。
我们的长期目标是复活全球1000亿行经过市场验证的C#代码,使其在现代Web前端平台上继续发挥价值。MWGA帮助开发者将一套C#代码同时编译成.exe和.wasm文件,两者运行效果保持高度一致。
从另外一个角度看,MWGA可以看成一个通用前端框架,但是采用了特有的WinForms编程模型,是WinForms技术栈在前端领域中的一个海外殖民地,这是一个重大的跨界融合,使得全球数百万个WinForms开发者无需更换技术栈即可在纯前端领域发挥作用。而且C#的强类型语言特性和GDI+严谨的编程模型也有助于减少AI编程产生的隐形BUG。
软件下载地址:https://github.com/dcsoft-yyf/MWGA
时间轴产品是南京都昌公司的一个WinForms软件产品,现已开源,这是一个面向医院的专业软件产品,可以认为是体温单软件的增强版,它包含了7万行C#代码,其中有数万行GDI+绘图相关代码,其运行界面如下图所示:

我们创建了一个Blazor WASM 9.0的程序,把时间轴的代码复制过来,并做一些改造,代码修改量不超过700行,也就是小于1%,比如:
if (e.ClickedItem.Text == "打开本地时间轴文档")
{
using (OpenFileDialog ofd = new OpenFileDialog())
{
if (
#if MWGA
await
#endif
ofd.ShowDialog() == DialogResult.OK)
{
var stream =
#if MWGA
await
#endif
ofd.OpenFile();
var reader = new StreamReader(stream, Encoding.UTF8, true);
var strXml = reader.ReadToEnd();
temperatureControl1.LoadDocumentFormString(strXml);
reader.Close();
}
}
}
由于Blazor WASM是采用浏览器非阻断线程模式,为此我们实现了异步ShowDialog()函数,采用await语句来暂停当前代码执行,这样减少对旧代码的修改量。并使用了条件编译,使得同一份C#代码无需修改即可编译成.exe和.wasm文件。最后编译成.wasm的程序在谷歌浏览器中运行效果如下图所示:

程序中数万行内容排版和绘图代码未做修改,比如:
this.Document.InnerBehaviorMode = this.BehaviorMode;
RectangleF clipRectangle = (RectangleF)e.ClipRectangle;
clipRectangle = this.ViewTransform.TransformRectangleF(clipRectangle);
e.Graphics.PageUnit = this.Document.GraphicsUnit;
PointF lp = this.ClientToView(0, 0);
e.Graphics.TranslateTransform(-lp.X, -lp.Y);
this.Document.ViewMode = this.ViewMode;
if (this.ViewMode == DocumentViewMode.Page)
{
// 页面视图模式
// 绘制页面边框
clipRectangle.Inflate(1, 1);
if (this.Document.Config.BackColor.A != 0)
{
// 填充背景色
e.Graphics.FillRectangle(
GraphicsObjectBuffer.GetSolidBrush(this.Document.Config.BackColor),
clipRectangle);
}
RectangleF pb2 = RectangleF.Intersect(this._PageViewBounds, clipRectangle);
if (pb2.IsEmpty)
{
return;
}
这个使用案例展示了MWGA处理复杂图形软件的能力,使得它距离复活1000亿行C#代码的最终目标又进了一大步。
扫雷是一个经典的Windows游戏程序,我们从https://gitee.com/dingxiaowei/MineGame下载了一个基于MS .NET Framework 2.0的扫雷程序,这是一个10年前写的Winforms程序,包含约2500行C#代码以及若干图片资源文件,编译成.exe文件后运行如下图所示:

这个程序大量使用System.Drawing.Graphcis.DrawLine()/DrawImage()/FillRectangle()的接口来绘制游戏界面。此外这个程序使用了Panel、IMessageFilter、Timer、Button、MainMenu、MessageBox、ImageList等组件。
我们创建了一个Blazor WASM 9.0的程序,将扫雷程序源码文件复制过来,并做一些兼容性修改,如下所示:
#if MWGA
public static async ValueTask<ShowSelfResult> ShowSelf(...)
#else
public static ShowSelfResult ShowSelf(...)
#endif
{
bool result;
frmCustomGame cg = new frmCustomGame();
cg.tbHeight.Text = height.ToString();
cg.tbWidth.Text = width.ToString();
cg.tbMineCount.Text = mineCount.ToString();
cg.Location = location;
#if MWGA
if (await cg.ShowDialog(parent) == DialogResult.OK)
#else
if (cg.ShowDialog(parent) == DialogResult.OK)
#endif
{
// ...
}
}
最终我们对旧代码修改了不超过50行(占比2%)就让同一套代码可以无需修改即可编译成.exe和.wasm文件。最后编译成.wasm的扫雷程序在谷歌浏览器中的运行结果如下:

程序中的上千行图形绘制代码和游戏逻辑判断未做任何修改,如下所示:
protected override void OnPaint(PaintEventArgs e)
{
Rectangle rect = ClientRectangle;
Graphics g = e.Graphics;
g.FillRectangle(grayBrush, rect);
drawFrame(g, new Rectangle(rect.Left, rect.Top, rect.Width - 1, rect.Height - 1));
if (Image != null)
{
int offset;
if (pressed)
offset = 1;
else
offset = 0;
g.DrawImage(Image, rect.Left + 4 + offset, rect.Top + 4 + offset);
}
}
我们开发了一个Winform.NET的计算器程序,包含460行C#代码,其运行界面如图所示:

这里响应了窗体的大小改变事件,用于设置按钮和文本框的位置和大小,其代码如下:
private void CalculatorForm_Resize(object sender, EventArgs e)
{
UpdateControlLayout();
}
/// <summary>
/// 动态更新所有控件的位置和大小(完全填充窗体,无空白)
/// </summary>
private void UpdateControlLayout()
{
// 获取窗体客户端区域(排除边框)
Rectangle clientRect = this.ClientRectangle;
// 1. 处理显示屏(占顶部整行,高度占客户端区域的1/6,剩余部分给按钮)
int displayHeight = clientRect.Height / 6;
// 显示屏位置:左、上、右间距为fixedPadding,高度为displayHeight
txtDisplay.Location = new Point(_fixedPadding, _fixedPadding);
var newSize = new Size(clientRect.Width - 2 * _fixedPadding, displayHeight - 2 * _fixedPadding);
// ...
}
这份C#代码未做任何修改,借助MWGA,它在Blazor WASM中运行界面如下所示:

MWGA基本原理是模拟System.Windows.Forms.Control类型和System.Drawing.Graphics类型来实现WinForms代码低修改量的迁移。MWGA建立了以下的功能模块映射:
| HTML功能模块 | MWGA功能模块 |
|---|---|
| <canvas> | System.Drawing.Graphics |
| <button> | System.Windows.Forms.Button |
| <img> | System.Windows.Forms.PictureBox |
| <div> | System.Windows.Forms.Form System.Windows.Forms.Panel System.Windows.Forms.Control System.Windows.Forms.Label |
| <nav> | System.Windows.Forms.MainMenu |
| <input type="text">或<textarea> | System.Windows.Forms.TextBox |
| window.alert() | System.Windows.Forms.MessageBox |
| <div> | System.Windows.Forms.MessageBoxNew |
| element.style.cursor | System.Windows.Forms.Cursor |
| window.setTimeout() | System.Windows.Forms.Timer |
| MouseEvent, KeyEvent | Win32 Message,包括WM_KEYUP、WM_KEYDOWN、WM_LBUTTONDOWN、WM_LBUTTONUP等等 |
MWGA内部还模拟实现了Win32 Message loop和消息队列,构造出了一个Winforms的底层运行框架,使得用户的基于Winforms的C#代码重新编译后即可运行在Blazor WASM上。
DrawString( ), DrawImage( ), DrawLine( ), DrawRectangle( ), FillRectangle( ), DrawEllipse( ), FillEllipse(), MeasureString( ), PageUnit, Transform
AddMessageFilter( ), Run( ), RemoveMessageFilter( )
BackColor, ForeColor, Width, Height, Location, Size, Anchor, Dock, Visible, Enabled, Text, Font, Invalidate( ), Refresh( )
async ShowDialog( ), Show( ), Close( ), FormBorderStyle, StartPosition, WindowState, Resize
Load data from Form.resx
Support Form.Designer.cs
Add( ) , Draw( )
Show() ,async ShowAsync( )
async ShowDialog(), async OpenFile()
System.Windows.Forms.ScrollableControl
System.Windows.Forms.SystemInformation(采用 Win11 的设置)
System.Windows.Forms.ToolStrip
System.Windows.Forms.UserControl
开发环境: Blazor Webassembly 9.0/10
浏览器: Chrome (v95 or later), Firefox (v113 or later) and other mainstream browsers
操作系统 : Windows (7 or later), Linux, Android
MWGA支持多语言开发。MWGA内部所有的字符串都剥离出来形成一个字符串资源JS文件,其内容如图所示:
window.__DCResourceStrings = {
AboutBoxDesc: "显示该组件的"关于"对话框",
AccDGCollapse: "折叠",
AccDGEdit: "编辑",
AccDGExpand: "展开",
AccDGNavigate: "定位",
AccDGNavigateBack: "向后定位",
AccDGNewRow: "(新建)",
AccDGParentRow: "父行",
AccDGParentRows: "父行",
AccessibleActionCheck: "选中",
AccessibleActionClick: "单击",
AccessibleActionCollapse: "折叠",
AccessibleActionExpand: "展开",
AccessibleActionPress: "按",
AccessibleActionUncheck: "取消选中",
// ...
};
我们目前提供简体中文版和英文版,用户可以修改这个JS文件来使用自己的语言。
另外MWGA支持ComponentResourceManager类型,如图所示:
private void InitializeComponent()
{
var resources = new System.ComponentModel.ComponentResourceManager(typeof(dlgMessage));
this.panel1 = new System.Windows.Forms.Panel();
this.pictureBox1 = new System.Windows.Forms.PictureBox();
this.label1 = new System.Windows.Forms.Label();
this.txtMessage = new System.Windows.Forms.TextBox();
this.btnOK = new System.Windows.Forms.Button();
this.btnCancel = new System.Windows.Forms.Button();
this.panel1.SuspendLayout();
((System.ComponentModel.ISupportInitialize)(this.pictureBox1)).BeginInit();
this.SuspendLayout();
// ...
}
用户可以将程序资源设置到Form.resx文件中,编译后即可使用窗体资源文件。
MWGA只包含一个4MB大小的DCSoft.MWGA.dll文件,就已经包含了所有的功能,不依赖任何其他第三方组件。
创建一个Blazor WASM 9.0/10.0的程序,添加对DCSoft.MWGA.dl的程序集引用。目前不支持Blazor WASM 7.0/8.0。
将要迁移的WinForms程序的源代码以及资源文件全部复制到项目中。
添加标准化的MWGA的引导程序代码,添加运行程序界面的HTML文件。
对用户程序代码进行必要的兼容性检查和修改,主要修改点有:
| 标准WinForms功能点 | MWGA修改说明 |
|---|---|
| 显示对话框可直接使用Form.ShowDialog() | 要将用户函数改造成异步模式,然后使用await Form.ShowDialog() |
| 支持P/Invoke,可以使用[DllImport]来导入外界API函数。 | 不支持P/Invoke,必须修改用户代码来删除P/Invoke功能。不过如果P/Invoke功能没被触发,程序仍然能正常运行。 |
| 窗体资源文件.resx | 由于源代码文件目录结构改变导致生成的.resx文件重命名,需要调整用户代码来设置正确的名称。 MWGA自己提供的ComponentResourceManager、ResourceManager已经能自动处理这种.resx的重命名。 |
| 可直接重写Control.OnPaint方法 |
由于启用Graphics子模块需要消耗点资源,所以默认情况下MWGA中所有的WinForms控件没启用自定义绘图操作,都是用HTML DOM来模拟WinForms控件的界面和行为。 |
|
MessageBox.Show() |
可以继续使用MessageBox.Show(),但是底层调用了window.Alert()来模拟的,用户界面很丑。 如果需要高仿请使用await MessageBoxNew.Show(),需要将用户函数改造成异步模式。 |
|
OpenFileDialog.ShowDialog() |
await OpenFileDialog.ShowDialog() |
|
OpenFileDialog.OpenFile() |
await OpenFileDialog.OpenFile() |
| 本地文件访问 |
MWGA不支持new FileStream(fileName)模式打开本地文件,只能调用OpenFileDialog.OpenFile()来只读打开本地文件。 |
|
Button, MenuItem, ToolStripItem.Click事件 |
可以继续使用,但提供新的事件ClickAsync可以使用,新的事件以异步方式运行,可以安全使用await。 |
|
窗体设计器 |
MWGA是轻量级的前端框架,不支持可视化的窗体设计器。开发者需要使用传统的窗体设计器来设计窗体,比如使用VS.NET或SharpDevelop等工具。 |
|
单步及断点调试 |
MWGA借助Blazor WASM可以实现单步及断点调试,但使用效果没有传统的WinForms开发工具好,建议开发者使用传统WinForms开发调试工具把软件流程彻底做好,然后移植到MWGA。 |
|
内存和CPU的性能调优 |
MWGA没有性能调优工具。建议开发者在传统的WinForms开发工具中把性能调优做好,然后移植到MWGA中。 |
|
客户端大内存 |
MWGA运行在浏览器沙盒中,留给用户的内存不多,建议不要超过1GB,这就要求开发者需要使用传统WinForms开发工具来非常仔细的优化内存占用,不要浪费每个字节的内存。 |
编译运行程序。
MWGA支持谷歌(v95及后续版本)、火狐(v133及后续版本)等主流浏览器。支持Windows、Linux、Android操作系统。不支持Windows XP等老旧操作系统。
MWGA并不是开源软件,但我们采取以下措施来保证这个软件是安全的:
将WinForms程序迁移到Blazor WASM上,目前业界还有以下解决方案:
代码生成式迁移:使用工具软件解析WinForms的源代码,自动生成Blazor代码,后续独立维护。
手动重构:参考原先的WinForms程序,从零开始手写Blazor组件,完全脱离原先的WinForms程序。
混合桥接(WebView2):在WinForms程序中嵌入一个WebView2的浏览器组件,将软件功能一点点的迁移到BS结构中。
MWGA为商业闭源产品,南京都昌信息科技有限公司拥有全部版权,严禁破解和盗版。
演示项目为开源示例,用于演示迁移流程与验证兼容性。
有任何疑问请联系:28348092@qq.com 或者在 https://github.com/dcsoft-yyf/MWGA 上留言。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。