如何为ASP.NET Core MVC所有Identity页面统一重写布局？

原因分析 #

你遇到的问题核心有两点：

1. Identity的Account/Manage目录下的页面默认引用了本地的_Layout.cshtml，优先级高于上层Identity/Pages目录的_ViewStart.cshtml
2. 嵌套布局报错是因为全局布局_LoginLayout.cshtml要求渲染SectionTitle1节，但原Identity页面并未定义该节

下面是几种可行的解决方法：

方法一：修改全局布局，兼容原有页面的节要求 #

直接修改/Views/Shared/_LoginLayout.cshtml中关于SectionTitle1的渲染代码，将其设置为可选节，这样原Identity页面即使没有定义该节也不会报错：

@* 把原来的必填节改成可选 *@
@RenderSection("SectionTitle1", required: false)

之后在/Areas/Identity/Pages/_ViewStart.cshtml中保留你的全局布局设置：

@{ Layout = "~/Views/Shared/_LoginLayout.cshtml"; }

这种方法最简单，无需改动Identity的任何页面或子目录文件。

方法二：创建中间布局层，兼容原有节 #

如果不想修改全局布局的必填节要求，可以在/Areas/Identity/Pages/Account/Manage目录下创建一个新的_Layout.cshtml作为中间层，同时衔接原页面的节和全局布局：

@{
    // 引用全局布局
    Layout = "~/Views/Shared/_LoginLayout.cshtml";
}

@* 渲染原页面需要的SectionTitle1节，传递给全局布局 *@
@section SectionTitle1 {
    @RenderSection("SectionTitle1", required: true)
}

@* 渲染页面主体内容 *@
@RenderBody()

这样原Identity页面的SectionTitle1节会被中间布局接收并传递给全局布局，既保留了全局布局的要求，又兼容了原有页面的结构。

方法三：通过代码配置全局指定Identity页面布局 #

在项目的Program.cs（.NET Core 6+）或Startup.cs中，通过配置Identity的Razor页面选项，强制指定所有Identity页面使用全局布局：

builder.Services.AddRazorPages()
    .AddIdentityPagesOptions(options =>
    {
        // 对Identity区域下的所有页面统一设置布局
        options.Conventions.ForArea("Identity", convention =>
        {
            convention.ForAllPages().Layout("~/Views/Shared/_LoginLayout.cshtml");
        });
    });

同样，这种方法需要配合方法一，把全局布局的SectionTitle1设为可选，避免节缺失报错。

方法四：覆盖子目录的_ViewStart #

在/Areas/Identity/Pages/Account/Manage目录下创建_ViewStart.cshtml，直接指定全局布局：

@{ Layout = "~/Views/Shared/_LoginLayout.cshtml"; }

此方法会覆盖该目录下所有页面的布局设置，但同样需要处理节的问题，参考方法一修改全局布局的节为可选。

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