如何将旧版Web Forms项目转换为新版SDK csproj格式？

Web Forms项目支持转换为新版SDK风格csproj格式，你遇到的Program does not contain a static 'Main' method suitable for an entry point报错属于配置缺失问题，不是转换本身不支持，修复方案如下：

报错原因 #

新版SDK风格csproj默认会为项目自动生成Program入口类，而基于.NET Framework的传统Web Forms项目本质是类库项目，不需要独立入口点，自动生成的逻辑和原有项目结构冲突就会触发该报错。

具体修复步骤 #

1. 修正csproj基础配置 #

修改你的csproj文件根节点和基础属性组，示例配置如下：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <!-- 替换为你实际使用的.NET Framework版本，支持net472、net48等 -->
    <TargetFramework>net48</TargetFramework>
    <!-- 指定输出类型为类库，不需要生成可执行文件 -->
    <OutputType>Library</OutputType>
    <!-- 关闭自动生成Program入口和默认程序集信息，避免和原有自定义信息冲突 -->
    <GenerateProgramFile>false</GenerateProgramFile>
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
    <!-- 保留Web Forms运行所需的Web服务配置 -->
    <WebProjectOutputDir>$(MSBuildProjectDirectory)\</WebProjectOutputDir>
    <UseIISExpress>true</UseIISExpress>
  </PropertyGroup>

2. 配置自动文件包含规则 #

添加如下配置即可实现文件自动包含，新增内容无需手动修改csproj，彻底解决合并冲突问题：

<ItemGroup>
    <!-- 自动包含所有Web Forms相关资源 -->
    <Content Include="**\*.aspx;**\*.ascx;**\*.ashx;**\*.asmx;**\*.master" />
    <Content Include="**\*.config;**\*.css;**\*.js;**\*.html;**\*.png;**\*.jpg;**\*.svg" />
    <!-- 排除编译缓存目录，避免报错 -->
    <Compile Remove="bin\**;obj\**" />
    <Content Remove="bin\**;obj\**" />
  </ItemGroup>

3. 迁移NuGet引用 #

直接把原有packages.config内的所有包转换为<PackageReference>格式添加到csproj中即可，SDK风格csproj原生支持.NET Framework项目的PackageReference引用模式。

4. 验证生效 #

保存修改后删除项目根目录的bin、obj文件夹，重新构建项目即可解决入口点报错，正常运行项目。

注意事项 #

• 该方案仅适用于基于.NET Framework的Web Forms项目，.NET Core/.NET 5+本身不支持Web Forms，不存在转换可能性
• 如果你的项目有自定义的AssemblyInfo.cs内容，必须保留<GenerateAssemblyInfo>false</GenerateAssemblyInfo>配置，避免自动生成的程序集信息和自定义内容冲突

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