.NET 6 API引用含.NET Framework 4.72 WinForms依赖的第三方程序集报错如何解决

兼容可行性结论 #

该场景存在成熟的兼容方案，无需降低.NET版本，.NET 6可以完整支持该需求。

已解决的WinForms依赖问题说明 #

你已经添加的<FrameworkReference Include="Microsoft.WindowsDesktop.App" />配置是正确的，该配置会将Windows桌面运行时的相关基础库（包含WinForms、WPF等）引入到项目中，解决了System.Windows.Forms程序集加载失败的问题。如果希望减少不必要的依赖引入，也可以将配置改为更精准的WinForms单独引用：

<FrameworkReference Include="Microsoft.WindowsDesktop.App.WindowsForms" />

System.Web.Services缺失问题解决方案 #

System.Web.Services是.NET Framework时代用于ASMX服务调用的专属程序集，.NET 6中没有内置该程序集，可通过以下两种方案解决：

• 方案1：安装官方兼容NuGet包
  直接搜索安装System.Web.Services官方兼容包即可，该包由微软维护，覆盖了绝大多数常用的System.Web.Services公开API，适配.NET 6版本，可解决90%以上的引用缺失问题。
• 方案2：补充WCF相关依赖
  如果第三方程序集用到了兼容包未覆盖的冷门API，可在项目csproj文件的<PropertyGroup>节点中添加配置开启WCF支持：

<UseWCF>true</UseWCF>

同时按需安装System.ServiceModel.Http、System.ServiceModel.Primitives等WCF相关NuGet包，补充缺失的服务调用类型。如果触发运行时兼容性校验错误，可添加以下配置关闭校验：

<EnableUnsupportedDesktopRuntimeTargetingCheck>false</EnableUnsupportedDesktopRuntimeTargetingCheck>

部署注意事项 #

• 由于依赖了WinForms和.NET Framework兼容组件，该API只能部署在Windows操作系统上，不支持跨平台运行。
• 如果部署到无桌面环境的Windows Server系统，需要开启「桌面体验」功能，避免第三方程序集调用UI相关接口时触发GDI+运行时错误。
• 不需要降级.NET版本，最低.NET Core 3.0版本即可支持该场景，但.NET 6作为长期支持版本更推荐继续使用。

内容的提问来源于stack exchange，提问作者Łukasz Lech