如何在运行中的Classic ASP网站中添加并启用CSHTML页面

嘿，刚好有过类似的实操经验，给你梳理下怎么在Classic ASP网站里单独加个能正常跑的CSHTML页面：

首先得确认你的服务器（一般是IIS）已经支持ASP.NET——毕竟CSHTML是Razor视图，属于ASP.NET生态的内容。如果是Windows服务器，确保已经安装了对应的.NET Framework（推荐4.5+）或者.NET Core/5+，并且IIS里的ASP.NET功能已经启用。

1. 写一个基础的CSHTML测试页 #

先搞个简单的测试文件，比如命名为TestPage.cshtml，内容可以这样：

@{
    // 关闭布局页，避免找不到布局文件报错
    Layout = null;
}
<!DOCTYPE html>
<html>
<head>
    <title>CSHTML测试页</title>
</head>
<body>
    <h1>这是我的CSHTML页面</h1>
    <p>当前时间：@DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")</p>
</body>
</html>

把这个文件放到Classic ASP网站的根目录或者你指定的子文件夹里。

2. 配置IIS让CSHTML能被解析 #

这是关键步骤，要让IIS知道该用ASP.NET来处理CSHTML文件：

• 打开IIS管理器，找到你的Classic ASP网站，查看它对应的应用池：
  右键应用池→「高级设置」，确认.NET CLR版本不是「无托管代码」（如果用.NET Framework就选v4.0.x，用.NET Core的话选对应版本或者保持「无托管代码」但要安装.NET Core托管模块）。
• 然后添加处理程序映射：
  在网站的功能视图里找到「处理程序映射」，点击「添加模块映射」：
  • 请求路径：*.cshtml
  • 模块：选择WebPageHandler（如果已经安装了ASP.NET Web Pages，这个模块会存在；如果没有，先安装ASP.NET Web Pages组件）
  • 名称：随便起个好记的，比如「CSHTML解析器」
  • 最后勾选「请求限制」，确保允许GET/POST等请求方法。

小技巧：如果不想改动整个网站的配置，可以给CSHTML文件单独建一个虚拟目录，给这个虚拟目录分配一个启用ASP.NET的应用池，这样不会影响原有Classic ASP网站的运行。比如建个叫aspnet_pages的虚拟目录，把CSHTML放进去，ASP页面里的链接就指向这个虚拟目录下的文件。

3. 在Classic ASP页面里加链接 #

直接在ASP页面的HTML里加普通的a标签就行，比如你的ASP页面是index.asp，可以这么写：

<p>点击这里打开CSHTML页面：<a href="TestPage.cshtml">跳转</a></p>

如果CSHTML在虚拟目录里，链接就写成<a href="/aspnet_pages/TestPage.cshtml">跳转</a>，注意路径要对应。

4. 测试与排错 #

• 如果出现404：检查CSHTML文件路径是否正确，IIS是否配置了CSHTML的处理程序映射，ASP.NET组件是否安装完整。
• 如果出现500错误：检查CSHTML里的代码有没有语法错误，应用池的.NET版本和代码是否兼容，网站的应用池身份有没有读取CSHTML文件的权限。
• 如果页面显示原始代码：说明IIS没把CSHTML交给ASP.NET处理，重新检查处理程序映射，或者确认ASP.NET Web Pages已安装。

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