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

南京都昌信息科技有限公司

2026-1-15


1. 一句话介绍

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

2. 项目背景

据估计,全球范围内的WinForms开发者约有300万至500万人,占.NET开发者总数的40%至50%。生产环境中运行着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文件,两者运行效果保持高度一致。

软件下载地址https://github.com/dcsoft-yyf/MWGA

4. 竞品对比

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

  • 代码生成式迁移:使用工具软件解析WinForms的源代码,自动生成Blazor代码,后续独立维护。
  • 手动重构:参考原先的WinForms程序,从零开始手写Blazor组件,完全脱离原先的WinForms程序。
  • 混合桥接(WebView2):在WinForms程序中嵌入一个WebView2的浏览器组件,将软件功能一点点的迁移到BS结构中。

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

对比维度 MWGA 代码生成式迁移 手动重构 混合桥接
迁移效率 极致快速(数小时):导入项目即可渲染,很少的编码适配,迁移效率远超其他方案。 较快(数天) 极慢(周/月级) 中等(天/周级)
技术门槛 极低(零Blazor/前端基础要求):仅需熟悉原有WinForms项目,普通开发即可快速上手,大幅降低迁移学习成本; 中(需基础Blazor知识,需学习新的Blazor技术栈) 高(精通Blazor生态,需全面掌握Blazor+前端技术栈) 中高(需双栈知识,需同时掌握WinForms与前后端技术栈)
代码修改量 普通项目代码零修改。 复杂项目和GDI+项目代码修改量小于10% 中:生成代码后需5%-20%的适配修改(如控件事件绑定、样式调整);GDI+功能需大幅改写(30%-60%);需适配Blazor技术栈规范 100%:需全盘重写UI代码,仅可复用少量纯业务逻辑代码;GDI+绘图需完全基于Blazor/JS重构;需彻底切换至Blazor技术栈 中高:需修改30%-50% WinForms代码适配桥接层,同时编写Blazor前端交互代码;GDI+需额外适配桥接渲染逻辑;需掌握双技术栈适配规则
成本优势 极致成本优势:很少编码人力成本、无学习成本;无需后续代码维护成本;纯前端部署无服务器运维成本;含GDI+的项目可大幅节省重写成本; 中:需承担代码生成后适配人力成本,后续维护成本较低;GDI+适配需额外增加成本;需投入Blazor技术栈培训成本 极高:全量重写人力成本高,前期学习成本+后期维护成本叠加;GDI+重构成本占比超50%; 高:双栈开发人力成本高,桥接层兼容维护成本持续存在,无跨平台成本优势;GDI+适配进一步推高成本;需投入双技术栈学习与适配成本
GDI+ 支持 良好支持:通过模拟System.Drawing.Graphics等核心类型实现GDI+绘图迁移,可保留原有绘图逻辑与交互效果;同一套代码在WinForms与Blazor WASM环境下界面、逻辑一致;技术栈无变动,绘图相关开发经验可直接复用 有限支持:仅能识别基础GDI+语法,复杂绘图逻辑(如自定义渲染、动态绘图)无法直接生成代码,需大幅改写;需基于Blazor技术栈重构绘图逻辑 需完全重构:无原生GDI+支持,需基于Blazor组件/HTML5 Canvas+JS重新实现所有绘图功能,学习与开发成本极高;需彻底抛弃原有GDI+开发技术栈 部分支持:可保留WinForms原生GDI+渲染,但需适配WebView2桥接通信逻辑,存在性能损耗,且跨平台受限;需掌握双栈下GDI+适配技术
技术栈延续性 完全延续:无需改变企业现有WinForms技术栈,开发人员可复用原有WinForms开发经验与技能;项目代码结构、开发规范保持不变,仅改变前端渲染形态 部分延续:可复用WinForms业务逻辑经验,需切换至Blazor技术栈,开发规范与代码结构需适配Blazor框架要求 完全切换:需彻底抛弃WinForms技术栈,全面转向Blazor+前端技术栈,原有开发经验复用率低 双栈并存:需同时维护WinForms与Blazor两套技术栈
适配场景 快速验证迁移效果; 对跨平台需求高、数据安全敏感、迁移周期紧张、成本控制严格的场景(优势适配); 含GDI+绘图功能的WinForms项目迁移; 注重技术栈延续性、需复用现有开发团队能力的企业项目 需长期维护、逐步演进纯Blazor架构项目;无复杂GDI+功能的项目;企业可接受技术栈部分切换的项目 大型项目、复杂逻辑、追求极致性能/长期价值;可接受全量重构成本与技术栈完全切换的GDI+项目;企业有明确Blazor技术栈转型规划的项目 必须保留WinForms逻辑、仅Windows平台使用;含复杂GDI+功能但无法承担重构成本的项目;企业可接受双技术栈并存的短期过渡项目

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

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

这个程序大量使用System.Drawing.Graphics.DrawLine()/DrawImage()/FillRectangle()的接口来绘制游戏界面。

我们创建了一个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
    {
        // ...
    }
}

由于Blazor WASM是采用浏览器非阻断线程模式,为此我们实现了异步ShowDialog()函数,采用await语句来暂停当前代码执行,这样减少对旧代码的修改量。

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

/// <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中运行界面如下所示:

7. 基本原理

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上。

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

System.Drawing命名空间

  • System.Drawing.Bitmap

  • System.Drawing.Brush

  • System.Drawing.Font

  • System.Drawing.Graphics

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

  • System.Drawing.SolidBrush

  • System.Drawing.Drawing2D.Matrix

System.Windows.Forms命名空间

  • System.Windows.Forms.Application

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

  • 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

  • System.Windows.Forms.MessageBoxNew

    • async Show()
  • System.Windows.Forms.Panel

  • System.Windows.Forms.PictureBox

  • System.Windows.Forms.Screen

  • System.Windows.Forms.TextBox

  • System.Windows.Forms.Timer

资源管理

  • System.Resources.ResourceManager
  • System.ComponentModel.ComponentResourceManager

平台支持

  • 开发环境: Blazor WebAssembly 9.0/10
  • 浏览器: Chrome, Firefox and other mainstream browsers
  • 操作系统: Windows, 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文件中,编译后即可使用窗体资源文件。未来MWGA将增强对于.resources.dll的多语言的支持。

10. 开发和部署

MWGA只包含一个3.8MB大小的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文件。

第四,兼容性修改

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

标准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方法 需要在控件构造函数中调用DCSoft.MWGASystem.SetControlOwnerDraw(this);来通知MWGA要针对这个控件启用Graphics子模块。 启用Graphics子模块需要消耗点资源,非必要就不要启用。
MessageBox.Show() 可以继续使用MessageBox.Show(),但是底层调用了window.Alert()来模拟的,用户界面很丑。 如果需要高仿请使用await MessageBoxNew.Show(),需要将用户函数改造成异步模式。

第五,编译运行

编译运行程序。

MWGA支持谷歌、火狐等主流浏览器。支持Windows、Linux、Android操作系统。不支持Windows XP、Windows 7等老旧操作系统

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

11. 安全性说明

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

  1. 限制使用范围 :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. 版权说明

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

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

有任何疑问请联系:28348092@qq.com 或者在 https://github.com/dcsoft-yyf/MWGA 上留言。


南京都昌信息科技有限公司

2026年1月15日