.NET Framework 4.8 WinForms升级至.NET 6.0遇DLL未找到问题

1. .NET 6.0是否需要同时存在SampleApp.dll与SampleApp.exe，还是升级工具操作有误？ #

.NET 6及以上版本的WinForms项目，默认情况下确实需要同时存在.exe和.dll。这里的.exe是.NET的托管程序启动器（host），真正的业务逻辑代码会编译到同名.dll中，启动器负责加载并运行.dll里的程序。

你的问题不是.NET 6的要求导致的，而是升级工具在转换项目配置时出现了异常，导致生成过程没有正确输出对应的.dll文件。

2. 如何解决该问题？ #

可以按以下步骤排查修复：

• 检查并手动修正项目文件（.csproj）
  右键项目选择"编辑项目文件"，确保核心配置正确，示例如下：

  <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
      <OutputType>WinExe</OutputType>
      <TargetFramework>net6.0-windows</TargetFramework>
      <UseWindowsForms>true</UseWindowsForms>
      <!-- 以下为可选配置，根据原项目情况调整 -->
      <Nullable>disable</Nullable>
      <ImplicitUsings>enable</ImplicitUsings>
    </PropertyGroup>
  </Project>
  

  重点确认：

  • <OutputType>必须是WinExe（对应项目设置里的"Windows Application"）
  • <UseWindowsForms>设置为true，确保WinForms SDK被正确引用
  • 非发布场景下不要设置<PublishSingleFile>true</PublishSingleFile>，该配置会把所有内容打包到单个.exe，导致生成阶段不会输出.dll

• 彻底清理并重新生成

  1. 右键解决方案，选择"清理解决方案"
  2. 手动删除项目根目录下的bin和obj文件夹
  3. 右键项目选择"重新生成"
  4. 生成完成后，检查bin/Release/net6.0-windows目录，确认同时存在SampleApp.exe和SampleApp.dll

• 对比新项目配置（如果上述步骤无效）
  创建一个全新的.NET 6 WinForms项目，打开它的.csproj文件，对比现有项目的配置差异，把缺失的属性或引用补全到你的项目中，再重新生成。

内容的提问来源于stack exchange，提问作者J23