ASP.NET引用新建类库报类型或命名空间不存在问题

对应根因 #

你遇到的“解决方案全量编译通过、项目引用路径正确、类库目标框架匹配、移除引用后页面可正常运行”的现象，是VS2015创建WebForms项目时的经典配置类问题，和类库本身的代码、命名空间无直接关联——核心矛盾是WebForms页面的动态编译加载逻辑和项目生成阶段的程序集传递逻辑是两套独立流程，当你把新项目放在解决方案自定义子目录下时，VS2015的自动配置逻辑会出现失效。

分步修复操作 #

• 第一优先级：补全Web.config中的程序集加载声明
  WebForms的aspx页面动态编译，不会自动扫描站点bin目录下的所有程序集，必须在system.web > compilation > assemblies节点下显式声明要加载的类库。你可以打开项目的Web.config，参照原有可正常引用的旧项目（比如带Utilities引用的站点）的配置格式，在对应的assemblies列表中补充新建类库的条目，格式参考：

  <add assembly="Testing.Core, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <add assembly="ServiceA, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  

  注意：VS2015的老版Web项目模板不会自动在这个节点添加项目引用的对应条目，尤其是自定义解决方案目录下的新建项目，只会在生成时把dll拷到bin目录，但动态编译流程不会主动加载这些未被显式声明的程序集，自然会报类型不存在的错误。
• 第二优先级：清理ASP.NET动态编译缓存
  反复添加、移除类库引用的过程中，VS内置的iisexpress会把旧的编译结果存在系统临时目录下，缓存失效就会出现加载错位：
  1. 关闭所有Visual Studio进程、iisexpress进程
  2. 打开路径C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files，删除所有和Testing.Web站点名称对应的缓存文件夹
  3. 回到解决方案，执行“清理解决方案”后重新全量生成
• 第三优先级：核对项目引用的属性配置
  你之前仅检查了引用指向的dll路径，需要打开Testing.Web的引用列表，逐个选中新建的类库引用（Testing.Core、ServiceA），在属性面板确认：
  • 复制本地：设置为True
  • 特定版本：设置为False
    可以直接打开Testing.Web项目的本地bin目录，确认有没有对应的类库dll实体文件——很多自定义目录下的新建项目，VS会默认把“复制本地”设为False，导致项目引用配置存在，但dll根本没有被拷贝到站点运行目录，运行时自然找不到类型。
• 兜底排查项：核对全局命名空间导入与绑定重定向配置
  1. 检查Web.config中system.web > pages > namespaces节点，确认是否引入了新建类库的根命名空间，避免aspx页面因为缺少导入指令报编译错误
  2. 检查runtime > assemblyBinding节点下的程序集重定向规则，确认没有把和新建类库同名的程序集强制重定向到原有项目的dll路径上，导致运行时程序集加载被拦截

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