ASP.NET Core 中的部分标记帮助程序Partial Tag Helper in ASP.NET Core

有关标记帮助程序的概述，请参阅 。

查看或下载示例代码（）

Partial 标记帮助程序用于在 Razor 页面和 MVC 应用中呈现分部视图。请考虑：

  • 需要 ASP.NET Core 2.1 或更高版本。
  • 是 的替代方法。

用于呈现分部视图的 HTML 帮助程序选项包括：

本文档中的示例均使用产品模型：

namename

需要 name 属性。它指示要呈现的分部视图的名称或路径。提供分部视图名称时，会启动进程。提供显式路径时，将绕过该进程。有关所有可接受的 name 值，请参阅分部视图发现。

以下标记使用显式路径，指示要从共享文件夹加载 _ProductPartial.cshtml。使用 属性，将模型传递给分部视图进行绑定。

  1. <partial name="Shared/_ProductPartial.cshtml" for="Product">

for 属性分配要根据当前模型评估的 ModelExpression。ModelExpression 推断 @Model. 语法。例如，可使用 for="Product" 而非 for="@Model.Product"。通过使用 @ 符号定义内联表达式来替代此默认推理行为。

以下标记加载 _ProductPartial.cshtml：

  1. <partial name="_ProductPartial" for="Product">

分部视图绑定到关联页模型的 属性：

modelmodel

在以下标记中，实例化新的 Product 对象并将其传递给 model 属性进行绑定：

  1. <partial name="_ProductPartial"
  2.          model='new Product { Number = 1, Name = "Test product", Description = "This is a test" }'>

view-data 属性分配 ViewDataDictionary，以传递到分部视图。以下标记使整个 ViewData 集合可访问分部视图：

  1. @{
  2.     ViewData["IsNumberReadOnly"] = true;
  4. <partial name="_ProductViewDataPartial" for="Product" view-data="ViewData">

在前面的代码中，IsNumberReadOnly 键值设置为 并添加到 ViewData 集合中。因此，在以下分部视图中可访问 ViewData["IsNumberReadOnly"]：

在此示例中，ViewData["IsNumberReadOnly"] 的值确定 Number 字段是否显示为只读。

从 HTML 帮助程序迁移Migrate from an HTML Helper

请考虑以下异步 HTML 帮助程序示例。循环访问和显示产品集合。依据 PartialAsync 方法的第一个参数，加载 _ProductPartial.cshtml 分部视图。Product 模型的实例传递给分部视图进行绑定。

  1. @foreach (var product in Model.Products)
  2. {
  3.     @await Html.PartialAsync("_ProductPartial", product)
  4. }
  1. @foreach (var product in Model.Products)
  2. {
  4. }