ASP.NET Core 中的布局

项目
11/30/2023

作者：Steve Smith 和 Dave Brock

页面和视图经常共享视觉对象和程序元素。本文演示了以下内容的操作方法：

使用通用布局。
共享指令。
在呈现页面或视图之前运行通用代码。

本文档讨论了 ASP.NET Core MVC 的两种不同方法的布局：Razor Pages 和带有视图的控制器。在本主题中，差异很小：

Razor Pages 位于“页面”文件夹。
具有视图的控制器使用视图的“视图”文件夹。

什么是布局

大多数 Web 应用都有一个通用布局，可在页面间切换时为用户提供一致体验。该布局通常包括应用标头、导航或菜单元素以及页脚等常见的用户界面元素。

Page Layout example

应用中的许多页面也经常使用常见的 HTML 结构，如脚本和样式表。所有这些共享元素均可在布局文件中进行定义，应用内使用的任何视图随后均可引用此文件。布局可减少视图中的重复代码。

按照约定，ASP.NET Core 应用的默认布局名为 _Layout.cshtml。使用模板创建的新 ASP.NET Core 项目的布局文件为：

Razor Pages：Pages/Shared/_Layout.cshtml
具有视图的控制器：Views/Shared/_Layout.cshtml

布局定义应用中的视图的最高级别模板。应用不需要布局。应用可以定义多个布局，其中不同的视图指定不同的布局。

下面的代码演示了使用控制器和视图创建的项目模板的布局文件：

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>@ViewData["Title"] - WebApplication1</title>

    <environment include="Development">
        <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" />
        <link rel="stylesheet" href="~/css/site.css" />
    </environment>
    <environment exclude="Development">
        <link rel="stylesheet" href="https://ajax.aspnetcdn.com/ajax/bootstrap/3.3.7/css/bootstrap.min.css"
              asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css"
              asp-fallback-test-class="sr-only" asp-fallback-test-property="position" asp-fallback-test-value="absolute" />
        <link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" />
    </environment>
</head>
<body>
    <nav class="navbar navbar-inverse navbar-fixed-top">
        <div class="container">
            <div class="navbar-header">
                <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                    <span class="sr-only">Toggle navigation</span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </button>
                <a asp-page="/Index" class="navbar-brand">WebApplication1</a>
            </div>
            <div class="navbar-collapse collapse">
                <ul class="nav navbar-nav">
                    <li><a asp-page="/Index">Home</a></li>
                    <li><a asp-page="/About">About</a></li>
                    <li><a asp-page="/Contact">Contact</a></li>
                </ul>
            </div>
        </div>
    </nav>

    <partial name="_CookieConsentPartial" />

    <div class="container body-content">
        @RenderBody()
        <hr />
        <footer>
            <p>&copy; 2018 - WebApplication1</p>
        </footer>
    </div>

    <environment include="Development">
        <script src="~/lib/jquery/dist/jquery.js"></script>
        <script src="~/lib/bootstrap/dist/js/bootstrap.js"></script>
        <script src="~/js/site.js" asp-append-version="true"></script>
    </environment>
    <environment exclude="Development">
        <script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-3.3.1.min.js"
                asp-fallback-src="~/lib/jquery/dist/jquery.min.js"
                asp-fallback-test="window.jQuery"
                crossorigin="anonymous"
                integrity="sha384-tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT">
        </script>
        <script src="https://ajax.aspnetcdn.com/ajax/bootstrap/3.3.7/bootstrap.min.js"
                asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.min.js"
                asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal"
                crossorigin="anonymous"
                integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa">
        </script>
        <script src="~/js/site.min.js" asp-append-version="true"></script>
    </environment>

    @RenderSection("Scripts", required: false)
</body>
</html>

指定布局

Razor 视图具有 Layout 属性。单个视图通过设置此属性来指定布局：

@{
    Layout = "_Layout";
}

指定的布局可以使用完整路径（例如 /Pages/Shared/_Layout.cshtml 或 /Views/Shared/_Layout.cshtml）或部分名称（例如 _Layout）。如果提供了分部名称，则 Razor 视图引擎使用其标准发现过程来搜索布局文件。首先搜索处理程序方法（或控制器）所在的文件夹，然后搜索 Shared 文件夹。此发现过程与用于发现分部视图的过程相同。

默认情况下，每个布局必须调用 RenderBody。无论在何处调用 RenderBody，都会呈现视图的内容。

章节

布局可以通过调用 RenderSection 来选择引用一个或多个节。节提供一种方法来组织某些页面元素应当放置的位置。每次调用 RenderSection 时都可指定该部分是必需还是可选：

<script type="text/javascript" src="~/scripts/global.js"></script>

@RenderSection("Scripts", required: false)

如果找不到所需的节，将引发异常。单个视图使用 @sectionRazor 语法指定要在节中呈现的内容。如果某个页面或视图定义了一个部分，则必须呈现该部分（否则将发生错误）。

Razor Pages 视图中的示例 @section 定义：

@section Scripts {
     <script type="text/javascript" src="~/scripts/main.js"></script>
}

在上面的代码中，scripts/main.js 添加到了页面或视图的 scripts 部分。相同应用中的其他页面或视图可能不需要此脚本且不会定义脚本部分。

以下标记使用分部标记帮助程序来呈现 _ValidationScriptsPartial.cshtml：

@section Scripts {
    <partial name="_ValidationScriptsPartial" />
}

前面的标记由基架 Identity生成。

在页面或视图中定义的部分仅在其即时布局页面中可用。不能从部分、视图组件或视图系统的其他部分引用它们。

忽略节

默认情况下，必须由布局页面呈现内容页中的正文和所有节。 Razor 视图引擎通过跟踪是否已呈现正文和每个节来强制执行此操作。

要让视图引擎忽略正文或节，请调用 IgnoreBody 和 IgnoreSection 方法。

必须呈现或忽略 Razor 页面中的正文和每个节。

导入共享指令

视图和页面可以使用 Razor 指令来导入命名空间并使用依赖项注入。可在一个共同的 _ViewImports.cshtml 文件中指定由许多视图共享的指令。 _ViewImports 文件支持以下指令：

@addTagHelper
@removeTagHelper
@tagHelperPrefix
@using
@model
@inherits
@inject
@namespace

该文件不支持函数和节定义等其他 Razor 功能。

示例 _ViewImports.cshtml 文件：

@using WebApplication1
@using WebApplication1.Models
@using WebApplication1.Models.AccountViewModels
@using WebApplication1.Models.ManageViewModels
@using Microsoft.AspNetCore.Identity
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

ASP.NET Core MVC 应用的 _ViewImports.cshtml 文件通常放在“页面”（或“视图”）文件夹中。_ViewImports.cshtml _ViewImports.cshtml 文件可以放在任何文件夹中，在这种情况下，它只会应用于该文件夹及其子文件夹中的页面或视图。_ViewImports.cshtml 从根级别开始处理 _ViewImports 文件，然后处理在页面或视图本身的位置之前的每个文件夹。可以在文件夹级别覆盖根级别指定的 _ViewImports 设置。

例如，假设：

根级 _ViewImports.cshtml 文件包含 @model MyModel1 和 @addTagHelper *, MyTagHelper1。
子文件夹 _ViewImports.cshtml 文件包含 @model MyModel2 和 @addTagHelper *, MyTagHelper2。

子文件夹中的页面和视图将有权访问标记帮助程序和 MyModel2 模型。

如果在文件层次结构中找到多个 _ViewImports.cshtml 文件，指令的合并行为是：_ViewImports.cshtml

@addTagHelper@removeTagHelper：按顺序全部运行
@tagHelperPrefix：最接近视图的文件会替代任何其他文件
@model：最接近视图的文件会替代任何其他文件
@inherits：最接近视图的文件会替代任何其他文件
@using：全部包括在内；忽略重复项
@inject：针对每个属性，最接近视图的属性会替代具有相同属性名的任何其他属性

在呈现每个视图之前运行代码

需要在每个视图或页面之前运行的代码应置于 _ViewStart.cshtml 文件中。_ViewStart.cshtml 按照约定，_ViewStart.cshtml 文件位于“页面”（或“视图”）文件夹。_ViewStart.cshtml 在呈现每个完整视图（不是布局，也不是分部视图）之前运行 _ViewStart.cshtml 中列出的语句。与 ViewImports.cshtml 一样，_ViewStart.cshtml 是分层的。如果在视图或页面文件夹中定义了 _ViewStart.cshtml 文件，则它将在页面（或视图）的根目录中定义的文件之后运行）文件夹（如果有）。_ViewStart.cshtml

示例 _ViewStart.cshtml 文件：

@{
    Layout = "_Layout";
}

上述文件指定所有视图都将使用 _Layout.cshtml 布局。

_ViewStart.cshtml 和 _ViewImports.cshtml 通常不置于 /Pages/Shared（或 /Views/Shared）文件夹中。_ViewStart.cshtml_ViewImports.cshtml 这些应用级别版本的文件应直接放置在 /Pages（或 /Views）文件夹中。

通过

ASP.NET Core 中的布局

什么是布局

指定布局

章节

忽略节

导入共享指令

在呈现每个视图之前运行代码

其他资源