MWGA - 为了复活1000亿行C#代码

1.一句话介绍

MWGA是Make WinForms Great Again的缩写,它是一个工具软件,能快速地将使用了GDI+的WinForm.NET程序快速迁移到Blazor WASM平台上,将程序代码修改量控制在10%以下,从而复活全球1000亿行C#代码。

2.项目背景

据估计,全球范围内企业级生产环境中运行着1000万至1500万个WinForms应用程序。在这些应用中,60%至80%有现代化改造需求,其中40%至60%优先选择Web化迁移,涉及的C#代码可能有数千亿行。由于可复用C#代码且具备基于浏览器的跨平台能力,Blazor WebAssembly成为热门选择。

但是有大量的WinForms使用了System.Drawing模块调用GDI+进行复杂的自定义绘图和交互,这些部分难以迁移,通常需要重写或大幅修改。为此,市场上对低改动、可复用业务逻辑和绘图代码的现代化迁移解决方案需求强烈。但长期以来一直缺乏有效工具和方法,导致许多企业面临高昂的重写成本和风险,存在巨大供需矛盾。

3.我们的目标

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

4.使用案例一:时间轴产品,1%代码修改量

时间轴产品是南京都昌公司的一个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#代码的目标又进了一大步。

5.使用案例二:扫雷游戏程序,2%代码修改量

扫雷是一个经典的Windows游戏程序,我们从https://gitee.com/dingxiaowei/MineGame下载了一个基于MS .NET Framework 2.0的扫雷程序,这是一个10年前写的Winforms程序,包含约2500行C#代码以及若干图片资源文件,编译成.exe文件后运行如下图所示:

这个程序大量使用System.Drawing.Graphics.DrawLine()/DrawImage()/FillRectangle()的接口来绘制游戏界面。此外这个程序使用了Panel、IMessageFilter、Timer、Button、MainMenu、MessageBox、ImageList等组件。

我们创建了一个Blazor WASM 9.0的程序,将扫雷程序源码文件复制过来,并做一些兼容性修改,如下所示:

#if MWGA     public static async ValueTask

后来我们对旧代码修改了不超过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);     } }

6.使用案例三:计算器,无代码修改

我们开发了一个Winform.NET的计算器程序,包含460行C#代码,其运行界面如图所示:

这里响应了窗体的大小改变事件,用于设置按钮和文本框的位置和大小,其代码如下:

private void CalculatorForm_Resize(object sender, EventArgs e) {     UpdateControlLayout(); }  ///动态更新所有控件的位置和大小(完全填充窗体,无空白)///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中运行界面如下所示:

7.基本原理

MWGA基本原理是模拟System.Windows.Forms.Control类型和System.Drawing.Graphics类型来实现WinForms代码低修改量的迁移。MWGA建立了以下的功能模块映射:

MWGA内部还模拟实现了Win32 Message loop和消息队列,构造出了一个Winforms的底层运行框架,使得用户的基于Winforms的C#代码重新编译后即可运行在Blazor WASM上。

8. MWGA支持的关键功能点(2026-1-28)

• System.Drawing.Bitmap

• System.Drawing.Brush

• System.Drawing.Font

• System.Drawing.FontFamily

• System.Drawing.Graphics
  DrawString(), DrawImage(), DrawLine(), DrawRectangle(), FillRectangle(), DrawEllipse(), FillEllipse(), MeasureString(), PageUnit, Transform

• System.Drawing.Pen

• System.Drawing.SolidBrush

• System.Drawing.Drawing2D.HatchBrush

• System.Drawing.Drawing2D.LinearGradientBrush

• System.Drawing.Drawing2D.Matrix

• System.Windows.Forms.Application
  AddMessageFilter(), Run(), RemoveMessageFilter()

• System.Windows.Forms.Button

• System.Windows.Forms.ContainerControl

• System.Windows.Forms.Control
  BackColor, ForeColor, Width, Height, Location, Size, Anchor, Dock, Visible, Enabled, Text, Font, Invalidate(), Refresh()

• System.Windows.Forms.Cursor

• System.Windows.Forms.Form
  async ShowDialog(), Show(), Close(), FormBorderStyle, StartPosition, WindowState, Resize
  Load data from Form.resx
  Support Form.Designer.cs

• System.Windows.Forms.ImageList
  Add(), Draw()

• System.Windows.Forms.MainMenu

• System.Windows.Forms.Label

• System.Windows.Forms.MessageBox
  Show(), async ShowAsync()

• System.Windows.Forms.OpenFileDialog
  async ShowDialog(), async OpenFile()

• System.Windows.Forms.Panel

• System.Windows.Forms.PictureBox

• System.Windows.Forms.Screen

• System.Windows.Forms.ScrollableControl

• System.Windows.Forms.SystemInformation(采用 Win11 的设置)

• System.Windows.Forms.TextBox

• System.Windows.Forms.Timer

• System.Windows.Forms.ToolStrip

• System.Windows.Forms.UserControl

• System.Resources.ResourceManager

• System.ComponentModel.ComponentResourceManager

• Platform
  Development: Blazor WebAssembly 9.0/10
  Browser: Chrome (v95 or later), Firefox (v113 or later) and other mainstream browsers
  OS: Windows (7 or later), Linux, Android

9.多语言支持

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文件中,编译后即可使用窗体资源文件。

10.开发和部署

MWGA只包含一个4MB大小的DCSoft.MWGA.dll文件,就已经包含了所有的功能,不依赖任何其他第三方组件。

开发者可参考https://github.com/dcsoft-yyf/MWGA提供的演示程序来进行基于MWGA的开发。主要步骤是:

首先,创建Blazor WASM项目

创建一个Blazor WASM 9.0/10.0的程序,添加对DCSoft.MWGA.dll的程序集引用。目前不支持Blazor WASM 7.0/8.0。

第二,复制源代码

将要迁移的WinForms程序的源代码以及资源文件全部复制到项目中。

第三,添加引导程序

添加标准化的MWGA的引导程序代码,添加运行程序界面的HTML文件。

第四,兼容性修改

对用户程序代码进行必要的兼容性检查和修改,主要修改点有:

第五,编译运行

编译运行程序。

MWGA支持谷歌(v95及后续版本)、火狐(v133及后续版本)等主流浏览器。支持Windows、Linux、Android操作系统。不支持Windows XP等老旧操作系统。

发布到生产环境时,可以考虑使用https://github.com/dcsoft-yyf/BlazorWASMPackager将Blazor WASM程序文件打包成一个单独的JS文件,方便部署和维护。

11.安全性说明

MWGA并不是开源软件,但我们采取以下措施来保证这个软件是安全的:

限制使用范围:MWGA的只有的文件DCSoft.MWGA.dll限制为只能用于Blazor WASM开发。对于其他的软件类型,比如WinForms、ASP.NET CORE、命令行等等不会产生任何效果。

2. 纯前端组件:MWGA是一个纯前端的软件组件,没有服务器端程序,只能运行在浏览器沙盒中,没有访问数据库、本地文件系统、注册表和硬件的权限。

3. 无网络操作:MWGA承诺不会执行任何网络操作,包括http、ftp、Web Socket等等。而且用户监控浏览器的异常网络行为也是很容易的事情。

4. 打包建议:我们建议用户使用https://github.com/dcsoft-yyf/BlazorWASMPackager将Blazor WASM软件打包成一个单独的JS文件。可以减少下载程序文件的网络操作,甚至使用本地file://协议运行。进一步的减少网络安全风险。

5. 无本地数据访问:MWGA承诺不访问任何本地数据,包括访问浏览器cookies、localStorage、IndexDB、navigator对象等等。

6. 无高权限操作:MWGA承诺不会执行高权限有风险的操作。比如操作摄像头、位置信息获取等等。

7. 用户代码安全管控:对于用户提供的WinForms应用程序发出访问文件或者数据库连接的请求,MWGA都会触发JS事件,让开发者自己写代码响应事件来处理这种高权限的行为。对于相关的安全风险MWGA完全避嫌。未来MWGA会提供高频变化的安全Token机制,强化Winforms用户代码安全行为的管控。

8. 错误隔离:当MWGA或用户代码由于BUG导致程序错误和卡死,由于它是纯前端组件,只能影响到当前终端,重启客户端浏览器即可恢复,不会影响服务器,安全风险小。

9. 信创认证:MWGA的姐妹软件DCWriter5采用了相同的软件架构。DCWriter5已经拿到统信、麒麟、方德操作系统原厂适配认证。这间接说明MWGA符合国产信创的要求。

10. 安全提醒:当MWGA出现了本文档说明之外的高权限行为,可以怀疑DCSoft.MWGA.dll不是正版的,或者遭到病毒和木马的侵犯。即使如此,由于浏览器安全沙盒的限制,用户的运行环境仍然是安全的。

12.同类方案对比

将WinForms程序迁移到Blazor WASM上,目前业界还有以下解决方案:

• 代码生成式迁移:使用工具软件解析WinForms的源代码,自动生成Blazor代码,后续单独维护。

• 手动重构:参考原先的WinForms程序,从零开始手写Blazor组件,完全脱离原先的WinForms程序。

• 混合桥接(WebView2):在WinForms程序中嵌入一个WebView2的浏览器组件,将软件功能一点点的迁移到BS结构中。

MWGA和其他相同目标的解决方案的对比如下:

13.版权说明

MWGA为商业闭源产品,南京都昌信息科技有限公司拥有全部版权,严禁破译和盗版。

演示项目为开源示例,用于演示迁移流程与验证兼容性。

南京都昌信息科技有限公司
2026年1月28日