返回

.NET Core分部视图PartialView用法

2021-06-25 .NET Core 分部视图 PartialView 1593 0

什么时候用用分部视图?

分部视图PartialView是执行下列操作的有效方式:

  • 将大型标记文件分解为更小的组件。

  • 在由多个逻辑部分组成的大型复杂标记文件中,在分部视图中处理隔开的每个部分是有利的。 标记文件中的代码是可管理的,因为标记仅包含整体页面结构和对分部视图的引用。

  • 减少跨标记文件中常见标记内容的重复。

当在标记文件中使用相同的标记元素时,分部视图会将重复的标记内容移到一个分部视图文件中。 在分部视图中更改标记后,它会更新使用该分部视图的标记文件呈现的输出。

不应使用分部视图来维护常见布局元素。 常见布局元素应在 _Layout.cshtml 文件中指定。

请勿使用需要复杂呈现逻辑或代码执行来呈现标记的分部视图。 使用视图组件而不是分部视图。

在页面中使用分部视图

直接使用partial标签

<partial name="_PartialName" />
//当存在文件扩展名时,标记帮助程序会引用分部视图,该视图必须与调用分部视图的标记文件位于同一文件夹中:
<partial name="_PartialName.cshtml" />
<partial name="~/Pages/Folder/_PartialName.cshtml" />
<partial name="../Account/_PartialName.cshtml" />

Html.PartialAsync()使用分部视图

@await Html.PartialAsync("_PartialName")
//当存在文件扩展名时,HTML 帮助程序会引用分部视图,该视图必须与调用分部视图的标记文件位于同一文件夹中:
@await Html.PartialAsync("_PartialName.cshtml")
@await Html.PartialAsync("~/Pages/Folder/_PartialName.cshtml")

分部视图发现

如果按名称(无文件扩展名)引用分部视图,则按所述顺序搜索以下位置:

Razor 页面

  • 当前正在执行页面的文件夹

  • 该页面文件夹上方的目录图

  • /Shared

  • /Pages/Shared

  • /Views/Shared

MVC

  • /Areas/<Area-Name>/Views/<Controller-Name>

  • /Areas/<Area-Name>/Views/Shared

  • /Views/Shared

  • /Pages/Shared

以下约定适用于分部视图发现:

当分部视图位于不同的文件夹中时,允许使用具有相同文件名的不同分部视图。

当按名称(无文件扩展名)引用分部视图且分部视图出现在调用方的文件夹和 文件夹中时,调用方文件夹中的分部视图会提供分部视图。 如果调用方文件夹中不存在分部视图,则会从 文件夹中提供分部视图。 文件夹中的分部视图称为“共享分部视图”或“默认分部视图”。

分部视图可以 链接,如果循环引用不是由调用构成,分部视图可以 — 调用另一分部视图。 相对路径始终相对于当前文件,而不是相对于文件的根视图或父视图。

PartialView传递数据示例

在Pages/Partial目录下创建分部视图_List.cshtml

@model IndexModel
<ul>
<li>@Model.H1</li>
</ul>

在Index.cshtml中使用分部视图

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}
<partial name="~/Pages/Partial/_List.cshtml" for="@Model" />
@await Html.PartialAsync("~/Pages/Partial/_List.cshtml", Model)
点赞 收藏

顶部