在开发 MVC 应用程序（其中标记文件称为“视图” ）或 Razor Pages 应用程序（其中标记文件称为“页”）时，均会使用术语 “分部视图” 。 本主题通常将 MVC 视图和 Razor Pages 页面称为“标记文件” 。

分部视图是在 Views 文件夹 (MVC) 或 Pages 文件夹 (Razor Pages) 中维护的 .cshtml 标记文件。

在 ASP.NET Core MVC 中，控制器的 ViewResult 能够返回视图或分部视图。 在 Razor Pages 中，PageModel 可以返回表示为 PartialViewResult 对象的分部视图。 引用分部视图部分介绍了引用和呈现分部视图。

与 MVC 视图或页面呈现不同，分部视图不会运行 _ViewStart.cshtml 。 有关 _ViewStart.cshtml 的详细信息，请参阅 ASP.NET Core 中的布局。

分部视图的文件名通常以下划线 (_) 开头。 虽然未强制要求遵从此命名约定，但它有助于直观地将分部视图与视图和页面区分开来。

分部视图是在 Views 文件夹中维护的 .cshtml 标记文件。

控制器的 ViewResult 能够返回视图或分部视图。 引用分部视图部分介绍了引用和呈现分部视图。

与 MVC 视图呈现不同，分部视图不会运行 _ViewStart.cshtml 。 有关 _ViewStart.cshtml 的详细信息，请参阅 ASP.NET Core 中的布局。

分部视图的文件名通常以下划线 (_) 开头。 虽然未强制要求遵从此命名约定，但它有助于直观地将分部视图与视图区分开来。

在 Razor Pages PageModel 中使用分部视图

在 ASP.NET Core 2.0 或 2.1 中，以下处理程序方法将 _AuthorPartialRP.cshtml 分部视图呈现给响应 ：

public IActionResult OnGetPartial() =>
    new PartialViewResult
    {
        ViewName = "_AuthorPartialRP",
        ViewData = ViewData,
    };

在 ASP.NET Core 2.2 或更高版本中，处理程序方法也可以调用 Partial 方法来生成 PartialViewResult 对象：

public IActionResult OnGetPartial() =>
    Partial("_AuthorPartialRP");

在标记文件中，有多种方法可引用分部视图。 我们建议应用程序使用以下异步呈现方法之一：

• 分部标记帮助程序
• 异步 HTML 帮助程序

在标记文件中，有两种方法可引用分部视图：

• 异步 HTML 帮助程序
• 同步 HTML 帮助程序

我们建议应用程序使用异步 HTML 帮助程序。

分部标记帮助程序

分部标记帮助程序要求 ASP.NET Core 2.1 或更高版本。

分部标记帮助程序会异步呈现内容并使用类似 HTML 的语法：

<partial name="_PartialName" />

当存在文件扩展名时，标记帮助程序会引用分部视图，该视图必须与调用分部视图的标记文件位于同一文件夹中：

<partial name="_PartialName.cshtml" />

以下示例从应用程序根目录引用分部视图。 以波形符斜杠 (~/) 或斜杠 (/) 开头的路径指代应用程序根目录：

Razor 页面

<partial name="~/Pages/Folder/_PartialName.cshtml" />
<partial name="/Pages/Folder/_PartialName.cshtml" />

MVC

<partial name="~/Views/Folder/_PartialName.cshtml" />
<partial name="/Views/Folder/_PartialName.cshtml" />

以下示例引用使用相对路径的分部视图：

<partial name="../Account/_PartialName.cshtml" />

有关详细信息，请参阅 ASP.NET Core 中的部分标记帮助程序。

Razor 页面

@await Html.PartialAsync("~/Pages/Folder/_PartialName.cshtml")
@await Html.PartialAsync("/Pages/Folder/_PartialName.cshtml")

MVC

调用 Partial 或 RenderPartial 会导致 Visual Studio 分析器警告。 例如，使用 Partial 会产生以下警告消息：

使用 IHtmlHelper.Partial 可能会导致应用程序死锁。 考虑使用 <分部> 标记帮助程序或 IHtmlHelper.PartialAsync。

将对 @Html.Partial 的调用替换为 @await Html.PartialAsync 或分部标记帮助程序。 有关分部标记帮助程序迁移的详细信息，请参阅从 HTML 帮助程序迁移。

Razor 页面

1. 当前正在执行页面的文件夹
2. 该页面文件夹上方的目录图
3. /Shared
4. /Pages/Shared
5. /Views/Shared

MVC

1. /Areas/<Area-Name>/Views/<Controller-Name>
2. /Areas/<Area-Name>/Views/Shared
3. /Views/Shared
4. /Pages/Shared

1. /Areas/<Area-Name>/Views/<Controller-Name>
2. /Areas/<Area-Name>/Views/Shared
3. /Views/Shared

Razor 页面

示例应用程序中的以下标记来自 Pages/ArticlesRP/ReadRP.cshtml 页面。 此页包含两个分部视图。 第二个分部视图将模型和 ViewData 传入分部视图。 ViewDataDictionary 构造函数重载可用于传递新 ViewData 字典，同时保留现有的 ViewData 字典。

@model ReadRPModel

<h2>@Model.Article.Title</h2>
@* Pass the author's name to Pages\Shared\_AuthorPartialRP.cshtml *@
@await Html.PartialAsync("../Shared/_AuthorPartialRP", Model.Article.AuthorName)
@Model.Article.PublicationDate

@* Loop over the Sections and pass in a section and additional ViewData to 
   the strongly typed Pages\ArticlesRP\_ArticleSectionRP.cshtml partial view. *@
@{
    var index = 0;

    foreach (var section in Model.Article.Sections)
    {
        await Html.PartialAsync("_ArticleSectionRP", 
                                section,
                                new ViewDataDictionary(ViewData)
                                {
                                    { "index", index }
                                });

        index++;
    }
}

Pages/Shared/_AuthorPartialRP.cshtml 是 ReadRP.cshtml 标记文件引用的第一个分部视图：

@model string
<div>
    <h3>@Model</h3>
    This partial view from /Pages/Shared/_AuthorPartialRP.cshtml.
</div>

Pages/ArticlesRP/_ArticleSectionRP.cshtml 是 ReadRP.cshtml 标记文件引用的第二个分部视图：

@using PartialViewsSample.ViewModels
@model ArticleSection

<h3>@Model.Title Index: @ViewData["index"]</h3>
<div>
    @Model.Content
</div>

MVC

• ASP.NET Core 的 Razor 语法参考
• ASP.NET Core 中的标记帮助程序
• ASP.NET Core 中的部分标记帮助程序
• ASP.NET Core 中的视图组件
• ASP.NET Core 中的区域

• ASP.NET Core 的 Razor 语法参考
• ASP.NET Core 中的视图组件
• ASP.NET Core 中的区域