ASP.NET Core MVC中的局部视图用法

目录

• 1.什么是局部视图
• 2.什么时候使用局部视图
• 3.引用局部视图
• 4.发现局部视图
• 5.局部视图访问数据
• 6.简单实战

1.什么是局部视图

局部视图是在其他视图中呈现的视图。通过执行局部视图生成的HTML输出呈现在调用视图中。与视图一样，局部视图使用 .cshtml 文件扩展名。当希望在不同视图之间共享网页的可重用部分时，就可以使用局部视图。

2.什么时候使用局部视图

局部视图是将大视图分成小组件的有效方法。通用的布局元素应在 _Layout.cshtml 中指定，非布局可重用内容可以封装成局部视图。

如果一个由几个逻辑部分组成的复杂页面，那么将每个逻辑部分作为局部视图是很有用。布局视图与普通视图之间没有语义差别，它们只是以不同的方式呈现。你可以直接从控制器的 ViewResult 返回视图，而这个视图也可以当局部视图来用。视图和局部视图的主要区别是呈现方式不同，局部视图不运行 _ViewStart.cshtml，而视图运行。

3.引用局部视图

在视图页面中有几种方法呈现局部视图。最简单的是使用 Html.Partial ，它通过 @ 前缀来调用并返回 IHtmlString ： @Html.Partial("AuthorPartial")。

PartialAsync 方法对包含异步代码的局部视图是可用的： @await Html.PartialAsync("AuthorPartial") 。

还可以使用 RenderPartial 方法来呈现局部视图。这个方法不返回结果：它将渲染结果直接输出到响应中。正因为它不返回响应，所以必须在 Razor 代码块中调用。通用也有一个异步方法 RenderPartialAsync:

@{
    Html.RenderPartial("AuthorPartial");
}

4.发现局部视图

当引用局部视图时，可以通过多种方式找到它的位置：

//以视图名使用当前文件夹下的视图，如果没有找到，则搜索Shared 文件夹
@Html.Partial("ViewName")

//这个名称的视图必须在相同文件夹下
@Html.Partial("ViewName.cshtml")

//依据应用根路径定位视图，以“/” 或 “~/” 开头的路径表示应用根路径
@Html.Partial("~/Views/Folder/ViewName.cshtml")

//使用相对路径
@Html.Partial("../Account/ViewName.cshtml")

局部视图可以链接。也就是说，一个局部视图可以调用另一个局部视图（只要不创建循环）。

5.局部视图访问数据

当局部视图被实例化时，它获取父视图的 ViewData 字典的副本。对局部视图中的数据所做的更新不会影响到父视图。局部视图返回时，局部视图中更改的 ViewData 将丢失。

你可以将 ViewDataDictionary 的实例传递到局部视图： @Html.Partial("PartialName",customViewData) 。

也可以将模型传递到局部视图：@Html.Partial("PartialName",viewModel) 。

也可以将ViewDataDictionary 和 模型都传递到视图：@Html.Partial("PartialName",viewModel，customViewData) 。

6.简单实战

先创建用到的模型：

namespace MVCTest.Models
{
    public class Article
    {
        public Article()
        {
            Sections = new List<ArticleSection>();
        }
        public string AuthorName { get; set; }
        public List<ArticleSection> Sections { get; set; }
    }

    public class ArticleSection
    {
        public string Title { get; set; }
        public string Content { get; set; }
    }
}

然后在控制器中实例化模型：

    public class ArticleController : Controller
    {
        // GET: Article
        public ActionResult Index()
        {
            var article = new Article();
            article.AuthorName = "test";
            article.Sections.Add(new ArticleSection() { Title="title",Content="content"});
            return View(article);
        }
    }

父视图：

@model MVCTest.Models.Article

@{
    ViewData["Title"] = "Index";
}

<h2>@Model.AuthorName</h2>
@Html.Partial("AuthorPartial",Model.AuthorName);

@foreach (var section in @Model.Sections)
{
    @Html.Partial("ArticleSection", section);
}

AuthorPartial.cshtml：

@model string

<h3>@Model</h3>

ArticleSection.cshtml：

@model MVCTest.Models.ArticleSection

<h3>@Model.Title</h3>
<h2>@Model.Content</h2>

到此这篇关于ASP.NET Core MVC局部视图的文章就介绍到这了。希望对大家的学习有所帮助，也希望大家多多支持我们。