前言
随着企业对网页端访问、界面现代化、跨平台支持、云集成和安全合规等能力的需求日益迫切,传统 .NET WinForms 应用的现代化转型已势在必行。Blazor WebAssembly(WASM)凭借其可复用 C# 代码与基于浏览器的跨平台特性,成为迁移路径中的热门选择。然而大量 WinForms 应用程序使用了System.Drawing模块调用GDI+进行复杂的自定义绘图和交互,使得常规迁移方案难以奏效,从而导致众多企业面临着高昂的重写成本和风险。
今天大姚给大家分享一个专门设计用于帮助 WinForms 应用程序迁移到 Blazor WASM 平台的项目:MWGA(Make WinForms Great Again)。
MWGA 项目介绍
MWGA(Make WinForms Great Again)是一个专门设计用于帮助 WinForms 应用程序迁移到 Blazor WASM 平台的项目,即使这些 WinForms 应用程序使用 GDI+ 功能,MWGA项目也预期将对这些程序源码的修改量不超过10%。这极大的降低 WinForms 软件现代化的成本和风险。注意该项目是一个巨大的工程目前还在逐步规划、完善中,当前已开源演示项目,主要用于给大家演示迁移流程与验证兼容性(大家有更好的想法或解决方案欢迎前往开源地址提Issues)。
开源地址:https://github.com/dcsoft-yyf/MWGA
WinForms 介绍
Windows Forms(简称 WinForms)是一个用于构建 Windows 桌面应用程序的用户界面框架。它是对 Windows 原生用户界面库(如 User32 和 GDI+)的 .NET 封装,并提供了 WinForms 特有的控件及其他功能。
应用场景
传统 WinForms 应用现代化:全球范围内存在大量基于 WinForms 开发的传统桌面应用,这些应用面临界面老化、跨平台支持差等问题,急需现代化改造。
网页端访问需求:随着 Web 应用的普及,用户期望能够通过浏览器访问原本仅限于桌面端的应用,提升使用的便捷性和灵活性。
云集成与安全合规:企业需要将应用迁移至云端,以满足数据安全、合规性要求,并实现更好的资源管理和扩展性。
跨平台访问需求:原本仅支持 Windows 的应用需在 macOS、Linux 或移动设备浏览器中运行。
降低重写成本与技术风险:避免从零开发新 Web 前端带来的高成本、长周期和功能遗漏风险。
演示项目源代码
运行环境:.NET 9.0
演示项目效果展示
演示项目在线访问:https://dcsoft-yyf.github.io/MWGA/WinFormCalculator.html
WinForm 计算器项目演示:
下面是还未迁移到 Blazor WASM 平台的 WinForm 计算器项目演示效果:
迁移到 Blazor WASM 平台演示:
下面是已经通过MWGA项目迁移到 Blazor WASM 平台的 WinForm 计算器项目演示效果:
Windows 浏览器和运行效果:
安卓手机浏览器运行效果:
结论:
我实测后确认,同一套Form.cs和Form.Designer.cs代码,在 WinForms 环境下和 Blazor WASM 环境下,程序具有相同的用户界面和相同的运行逻辑。button.Click事件和form.Resize事件处理也符合预期。初步展示了将 WinForms 代码无修改的移植到 Blazor WASM 中的能力。这是MWGA的第一滴血,虽然还有很多不足,但还是为快速低成本的迁移 Winforms 程序带来明确的曙光。
演示项目核心代码
Program.cs:
DCWasmWinFormEngine.cs:
namespace DCSoft.WinForm2WASM { public partial class DCWasmWinFormEngine { /// <summary> /// 封装 Invoke 调用,强制使用「标识符 + params object[]」重载 /// </summary> public static T InvokeJSFunction<T>(string identifier, params object?[]? args) { // 直接调用 params 重载(因为 args 是显式的 object[]) return _jsRuntime.Invoke<T>(identifier, args); } [JSInvokable] public static void InstallFontNames(string[] fontNames) { WinForm2WASMPublish.SetFamilies(fontNames); } [JSInvokable] public static void AddStandardControlTypeName(string typeName) { WinForm2WASMPublish.AddStandardControlTypeName(typeName); } private static Microsoft.JSInterop.JSInProcessRuntime _jsRuntime; public static void Start(Microsoft.JSInterop.JSInProcessRuntime rt) { if (rt == null) { throw new ArgumentNullException("rt"); } _jsRuntime = rt; WinForm2WASMPublish.Start(new MyJSRuntime(rt), typeof(DCWasmWinFormEngine).Assembly); } private class MyJSRuntime :DCSoft.IDCJSRuntime { public MyJSRuntime(JSInProcessRuntime rt) { if(rt == null ) { throw new ArgumentNullException("rt"); } this._rt = rt; } private JSInProcessRuntime _rt = null; public T Invoke<T>(string identifier, params object?[]? args) { return _rt.Invoke<T>(identifier, args); } public ValueTask<T> InvokeAsync<T>(string identifier, params object?[]? args) { return _rt.InvokeAsync<T>(identifier, args); } public async void InvokeVoidAsync(string identifier, params object?[]? args) { _rt.InvokeVoidAsync(identifier, args); } } /// <summary> /// 设置屏幕大小 /// </summary> /// <param name="width">宽度</param> /// <param name="height">高度</param> /// <param name="defaultFontName">默认字体名称</param> /// <param name="defaultFontSize">Point为单位的默认字体大小</param> [JSInvokable] public static void SetScreenSize( int width, int height, string defaultFontName, float defaultFontSize) { WinForm2WASMPublish.SetScreenSize(width, height, defaultFontName, defaultFontSize); } [JSInvokable] public static int PackageArgumentObjectToHandle( JsonNode json ) { return WinForm2WASMPublish.PackageToHandle(json); } [JSInvokable] public static void SendMessage_WM_WINDOWPOSCHANGED( int handle , JsonObject args ) { WinForm2WASMPublish.SendMessage_WM_WINDOWPOSCHANGED(handle, args); } /// <summary> /// 发送消息到控件 /// </summary> /// <param name="handle">控件句柄</param> /// <param name="msg">消息类型</param> /// <param name="wParam">参数1</param> /// <param name="lParam">参数2</param> [JSInvokable] public async static void SendMessageToControl(int handle , int msg, int wParam, int lParam) { WinForm2WASMPublish.SendMessageToControl(handle, msg, wParam, lParam); } /// <summary> /// 处理已经发送的消息 /// </summary> [JSInvokable] public static void HandlePostedMessage() { WinForm2WASMPublish.HandlePostedMessage(); } } }