如何在ASP.NET Core中为.html页面应用_Layout.cshtml布局

当然能做到！不过得明确一点：.html本身是静态文件，ASP.NET默认不会用Razor引擎去解析它，所以我们得做些配置，让服务器把.html文件当成Razor视图来处理，这样就能给它用上layout.cshtml母版页了。下面是具体的操作步骤，分两种项目类型来讲：

1. 配置服务器处理.html文件 #

针对ASP.NET Core项目 #

修改Program.cs（如果是旧版本项目则修改Startup.cs），让MVC服务支持.html扩展名的视图：

builder.Services.AddControllersWithViews()
    .AddRazorOptions(options =>
    {
        // 让Razor引擎识别.html后缀的视图文件
        options.ViewLocationFormats.Add("{0}.html");
    });

另外要注意中间件的顺序，确保静态文件中间件在路由中间件之前，同时.html文件会先经过Razor处理再返回：

// 先处理静态文件，但.html会被后续路由拦截处理
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

// 配置默认路由
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

最后把你的.html文件放在对应控制器的视图目录下，比如Home控制器的视图就放在Views/Home/MyPage.html。

针对传统ASP.NET MVC项目 #

修改项目根目录的web.config，添加Razor编译和请求处理的配置：

<system.web>
  <compilation>
    <buildProviders>
      <!-- 让编译器识别.html为Razor文件 -->
      <add extension=".html" type="System.Web.WebPages.Razor.RazorBuildProvider, System.Web.WebPages.Razor"/>
    </buildProviders>
  </compilation>
  <httpHandlers>
      <!-- 把.html请求交给MVC处理器处理 -->
      <add path="*.html" verb="*" type="System.Web.Mvc.MvcHttpHandler, System.Web.Mvc"/>
  </httpHandlers>
</system.web>

2. 在.html文件中引用Layout #

现在你的.html文件已经支持Razor语法了，只需要在文件顶部添加Layout引用，和普通.cshtml视图一样操作：

@{
    // 指定要使用的母版页路径
    Layout = "~/Views/Shared/_Layout.cshtml";
}

<!-- 这里是你的页面内容 -->
<h1>我的HTML页面</h1>
<p>现在这个页面已经用上母版页啦！</p>

你也可以在Layout中使用@RenderBody()、@RenderSection()等Razor语法，页面内容会自动嵌入到母版页对应的位置。

几个注意事项 #

• 在Visual Studio中，右键.html文件→属性→生成操作，要设置为“内容”或“视图”，不要设为“静态内容”，否则服务器会直接返回文件源码，不会经过Razor处理。
• ASP.NET Core项目要确保已经引用了Microsoft.AspNetCore.Mvc.Razor包，一般MVC模板默认已经包含。
• 测试时要通过控制器路由访问页面（比如/Home/MyPage），不要直接访问静态文件路径，这样才能触发Razor的解析流程。

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