为何现有.NET WebForms网站无.csproj文件？部署构建失败求解决

一、手动添加.csproj文件的具体步骤 #

• 先在Visual Studio里新建一个目标框架为net461的空白WebForms项目，把它生成的.csproj文件拷贝到你的项目根目录
• 打开这个.csproj文件编辑：
  • 确认<TargetFrameworkVersion>节点的值是v4.6.1
  • 把项目里的现有文件按类型添加到对应节点，比如：

    <Compile Include="App_Code\*.cs" />
    <Content Include="*.aspx" />
    <Content Include="*.ascx" />
    <Content Include="web.config" />
    <Content Include="packages.config" />
    <Content Include="Scripts\**" />
    <Content Include="Styles\**" />
    

  • 保留文件里的NuGet相关导入节点，确保能正常还原packages.config里的依赖
• 保存后用Visual Studio打开这个.csproj，检查是否能正常加载、编译，没问题的话就可以用它走构建管道了

二、其他替代解决方案 #

• 直接部署文件系统网站：如果项目本身是动态编译的WebForms（bin目录已有编译好的dll，或者代码都是在aspx/ascx里的脚本），完全可以跳过构建，直接把网站根目录的所有文件（包括bin、web.config、packages.config等）打包上传到App Service。App Service原生支持这种“文件系统网站”部署，不需要csproj。
• 转为标准Web应用项目：如果后续要长期维护，建议把项目转成标准Web应用项目。除了添加csproj，还要把所有后台代码文件的“生成操作”设为“编译”，清理掉不需要的动态编译配置，测试编译通过后再部署。

三、构建管道的变通方法 #

• 跳过MSBuild编译，直接打包部署：在Azure DevOps或其他构建工具里，删掉找csproj并编译的任务，换成：
  1. 执行nuget restore命令还原依赖：nuget restore 你的项目目录\packages.config -PackagesDirectory $(Build.SourcesDirectory)\packages
  2. 用归档任务把项目根目录的所有文件打包成压缩包
  3. 把这个压缩包部署到App Service
• 用MSBuild直接发布网站：即使没有csproj，也能通过MSBuild的网站发布命令处理，示例命令：

  msbuild /t:Build /p:ProjectType=WebSite /p:TargetFrameworkVersion=v4.6.1 /p:WebProjectOutputDir=$(Build.ArtifactStagingDirectory)\PublishedSite /p:OutDir=$(Build.ArtifactStagingDirectory)\PublishedSite\bin 你的项目目录\web.config
  

  这个命令会把项目当作文件系统网站处理，自动完成编译、打包，之后直接部署生成的PublishedSite目录即可

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