ASP.NET网站编译发布提示当前上下文不存在名称Abc报错

• 创建经典ASP.NET网站项目
• 添加Default.aspx页面，在App_Code文件夹中新增Abc类
• 在Abc类中定义静态方法WriteSample()
• 直接F5运行项目无任何异常
• 执行编译、发布操作时触发报错

Abc类代码（存于App_Code文件夹） #

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
    
public class Abc
{
    public Abc()
    {
      
    }

    public static void WriteSample()
    {

    }
}

Default.aspx.cs后置代码 #

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

public partial class _Default : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
       Abc.WriteSample();
    }
}

The name "Abc" does not exist in the current context

• 相同代码在其他电脑上可正常发布，无报错
• 已尝试重装、修复Visual Studio，更换多个不同VS版本，问题仍然复现

该问题和VS安装状态、版本无任何关联，核心原因是本地项目的文件生成配置错误。经典ASP.NET网站项目存在两套独立编译逻辑：

1. 本地F5调试运行时，由IIS Express/ASP.NET运行时动态识别App_Code特殊文件夹下的所有代码文件自动编译，完全不依赖Visual Studio的项目生成配置，所以无论VS中文件属性如何设置，运行阶段都不会报错
2. 执行发布、预编译操作时，由MSBuild执行预编译流程，只会将生成操作属性标记为Compile的代码文件纳入编译上下文，未标记的文件不会参与编译，直接抛出类不存在的上下文错误。

本地Abc.cs文件的生成操作属性被错误设置为Content（内容），才会出现运行正常、发布报错的现象。其他电脑上新建代码文件默认生成操作就是Compile，因此不会触发问题；重装VS不会修改项目本地的用户配置缓存，因此更换多少个VS版本都无法解决问题。

修复步骤 #

1. 在解决方案资源管理器中找到App_Code文件夹下的Abc.cs，右键选择「属性」
2. 在属性面板中找到「生成操作」项，将下拉值从Content修改为Compile
3. 保存配置后重新执行发布即可。

如果上述操作后仍报错，检查是否是手动创建的同名App_Code文件夹未被识别为ASP.NET特殊文件夹：右键项目 -> 选择「添加」->「添加ASP.NET 文件夹」-> 选择App_Code，将原有Abc.cs文件移动到新生成的App_Code文件夹中，重新发布即可。

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