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 fromForm.resx
  SupportForm.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、命令行等等不会产生任何效果。

1. 
   

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日

推荐阅读：