一.分部视图

  对于MVC 视图和 Razor Pages 页面,都有分部视图功能。通常将 MVC 视图和 Razor Pages 页面统称为“标记文件”,下面会常提到该名词。使用分部视图的优势包括:(1) 将大型标记文件分解为更小的组件。(2) 减少跨标记文件中,常见标记内容的重复。

  建议:(1)不应使用分部视图来维护常见布局元素,常见布局元素应在 _Layout.cshtml 文件中指定,比如页头、页尾。(2)当需要呈现复杂逻辑或代码执行的应该使用视图组件。

  1.1 声明分部视图

    分部视图是在 Views 文件夹 (MVC) 或 Pages 文件夹 (Razor Pages) 中维护的 .cshtml 标记文件。在 ASP.NET Core MVC 中,控制器的 ViewResult 能够返回视图或分部视图。 在 ASP.NET Core 2.2 中 Razor Pages 的PageModel 可以返回 PartialViewResult分部视图。

    分部视图不会运行 _ViewStart.cshtml页,这涉及到布局以后再讲。分部视图的文件名通常以下划线 _ 开头,没有.cshtml.cs文件。

    

  1.2 引用分部视图

    在标记文件中,有多种方法可引用分部视图。 建议应用程序使用以下异步呈现方法之一:(1) 分部标记帮助程序。(2) 异步 HTML 帮助程序。 不建议使用同步HTML 帮助程序, 因为可能会出现死锁的情况, 同步方法以后版本中会删除,这里不再介绍。

    (1) 分部标记帮助程序

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

  1.      <partial name="_PartialName" />

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

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

      以下示例从应用程序根目录引用分部视图。 以 (~/) 或 (/) 开头的路径,指代应用程序根目录:

  1.     Razor 页面CSHTML
  2.     <partial name="~/Pages/Folder/_PartialName.cshtml" />
  3.   <partial name="/Pages/Folder/_PartialName.cshtml" />
  1.      MVC CSHTML
  2.      <partial name="~/Views/Folder/_PartialName.cshtml" />
  3.     <partial name="/Views/Folder/_PartialName.cshtml" />
  1.       使用相对路径的分部视图
  2.       <partial name="../Account/_PartialName.cshtml" />

    

    (2) 异步 HTML 帮助程序

      使用 HTML 帮助程序时,最佳做法是使用 PartialAsync,同步是使用Partial(不建议使用同步)。PartialAsync 返回包含在 Task<TResult> 中的 IHtmlContent 类型。通过@await来引用该方法。

  1. Razor 页面CSHTML
  2. @await Html.PartialAsync("~/Pages/Folder/_PartialName.cshtml")
  3. @await Html.PartialAsync("/Pages/Folder/_PartialName.cshtml")
  1. mvc CSHTML
  2. @await Html.PartialAsync("~/Views/Folder/_PartialName.cshtml")
  3. @await Html.PartialAsync("/Views/Folder/_PartialName.cshtml")

      也可以使用 RenderPartialAsync 呈现分部视图。 此方法不返回 IHtmlContent。它将呈现的输出,直接流式传输到响应, 因此在某些情况下它可提供更好的性能。 因为该方法不返回结果,所以必须在 Razor 代码块内调用它:

  1. @{
  2. await Html.RenderPartialAsync("_AuthorPartial");
  3. }

  1.3 分部视图发现

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

      (1) Razor 页面

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

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

3./Shared

4./Pages/Shared

5./Views/Shared

   (2) MVC

1./Areas/<Area-Name>/Views/<Controller-Name>

2./Areas/<Area-Name>/Views/Shared

3./Views/Shared

4./Pages/Shared

      

  1.4 通过分部视图访问数据

    实例化分部视图时,它会获得父视图(主视图)的 ViewData 字典的副本。 在分部视图内,对数据所做的更新不会保存到父视图中。 对分部视图中的 ViewData 更改,会在分部视图返回时丢失。

    以下示例演示如何将 ViewDataDictionary(ViewData 字典)的实例传递给分部视图:

  1.     @await Html.PartialAsync("_PartialName", customViewData)

    还可将模型(实体对象)传入分部视图。 模型可以是自定义对象。

  1.     @await Html.PartialAsync("_PartialName", model)

    

二. 演示

  下面演示一个Razor的分部视图(MVC的参考官网示例)。示例中Pages/ArticlesRP/ReadRP.cshtml是主视图,Pages/Shared/_AuthorPartialRP.cshtml是第一个分部视图,传入“作者”。Pages/ArticlesRP/_ArticleSectionRP.cshtml 是第二个分部视图,传入ViewData字典和section模型二个参数,这二个参数是PartialAsync的方法重载。 三个文件结构如下:

  (1) 创建实体类

  1. public class Article
  2. {
  3. public string Title { get; set; }
  4.  
  5. public string AuthorName { get; set; }
  6.  
  7. public string PublicationDate { get; set; }
  8.  
  9. public List<ArticleSection> Sections { get; set; }
  10. }
  11.  
  12. public class ArticleSection
  13. {
  14. public string Title { get; set; }
  15. public string Content { get; set; }
  16. }

  (2)主视图

  1. public class ReadRPModel : PageModel
  2. {
  3. public Article Article { get; set; }
  4.  
  5. public void OnGet()
  6. {
  7. Article = new Article()
  8. {
  9. Title = "来自 <共享分部视图文件路径> 的分部视图",
  10. AuthorName = "Abraham Lincoln",
  11. PublicationDate= "1863 年 11 月 19 日中午 12:00:00",
  12. Sections = new List<ArticleSection>() {
  13. new ArticleSection (){ Title="第一节索引", Content="八十七年前..." },
  14. new ArticleSection (){ Title="第二节索引", Content="如今,我们正在进行一场伟大的内战,考验着......" },
  15. new ArticleSection (){ Title="第三节索引", Content="然而,从更广泛的意义上说,我们无法奉献..." },
  16. }
  17. };
  18. }
  19. }
  1. @page
  2. @model ReadRPModel
  3.  
  4. <h2>@Model.Article.Title</h2>
  5.  
  6. @Model.Article.PublicationDate
  7.  
  8. @* 将作者名字传到 Pages\Shared\_AuthorPartialRP.cshtml*@
  9. <p>---------------------------------第一个分部视图/Views/Shared/_AuthorPartial.cshtml</p>
  10. @await Html.PartialAsync("../Shared/_AuthorPartialRP.cshtml", Model.Article.AuthorName)
  11.  
  12. <p></p>
  13. @* Loop over the Sections and pass in a section and additional ViewData to
  14. the strongly typed Pages\ArticlesRP\_ArticleSectionRP.cshtml partial view. *@
  15. <p>---------------------------------第二个分部视图/Views/Shared/_ArticleSection.cshtml</p>
  16. @{
  17. var index = 0;
  18.  
  19. @foreach (var section in Model.Article.Sections)
  20. {
  21. @await Html.PartialAsync("_ArticleSectionRP", section,
  22. new ViewDataDictionary(ViewData)
  23. {
  24. { "index", index }
  25. })
  26.  
  27. index++;
  28. }
  29. }

  (3) 分部视图 _AuthorPartialRP.cshtm

  1. @* 将传过来的string类型映射*@
  2. @model string
  3. <div>
  4. <h3>@Model</h3>
  5. </div>

  (4) 分部视图 _ArticleSectionRP.cshtml 

  1. @using StudyRazorDemo.Models;
  2.  
  3. @* 将传过来的对象映射到ArticleSection中*@
  4. @model ArticleSection
  5.  
  6. <h3>@Model.Title Index: @ViewData["index"]</h3>
  7. <div>
  8. @Model.Content
  9. </div>
  10. <p></p>

  

  启动程序,运行http://localhost:42921/ArticlesRP/ReadRP,显示如下:

  参考资料

    ASP.NET Core 中的分部视图

   

asp.net core系列 42 Web 应用 分部视图的更多相关文章

  1. asp.net core系列 41 Web 应用 MVC视图

    一.MVC视图 在Web开发的MVC和Razor中,都有使用视图,在Razor中称为"页"..cshtml视图是嵌入了Razor标记的HTML模板. Razor 标记使用C#代码, ...

  2. asp.net core系列 40 Web 应用MVC 介绍与详细示例

    一. MVC介绍 MVC架构模式有助于实现关注点分离.视图和控制器均依赖于模型. 但是,模型既不依赖于视图,也不依赖于控制器. 这是分离的一个关键优势. 这种分离允许模型独立于可视化展示进行构建和测试 ...

  3. asp.net core系列 39 Web 应用Razor 介绍与详细示例

    一. Razor介绍 在使用ASP.NET Core Web开发时, ASP.NET Core MVC 提供了一个新特性Razor. 这样开发Web包括了MVC框架和Razor框架.对于Razor来说 ...

  4. asp.net core 系列 18 web服务器实现

    一. ASP.NET Core Module 在介绍ASP.NET Core Web实现之前,先来了解下ASP.NET Core Module.该模块是插入 IIS 管道的本机 IIS 模块(本机是指 ...

  5. asp.net core 系列 16 Web主机 IWebHostBuilder

    一.概述 在asp.net core中,Host主机负责应用程序启动和生存期管理.host主机包括Web 主机(IWebHostBuilder)和通用主机(IHostBuilder).Web 主机是适 ...

  6. asp.net core系列 44 Web应用 布局

    一.概述 MVC的视图与Razor页面经常共享视觉和程序元素,通过使用布局来完成,布局还可减少重复代码.本章演示了以下内容的操作方法:(1)使用通用布局,(2)自定义布局,(3) 共享指令,(4)在呈 ...

  7. asp.net core系列 43 Web应用 Session分布式存储(in memory与Redis)

    一.概述 HTTP 是无状态的协议. 默认情况下,HTTP 请求是不保留用户值或应用状态的独立消息. 本文介绍了几种保留请求间用户数据和应用状态的方法.下面以表格形式列出这些存储方式,本篇专讲Sess ...

  8. asp.net core系列 67 Web压力测试工具WCAT

    一.介绍 最近搭建了一套CQRS框架,需要在投入开发前,进行必要的压力测试.Web Capacity Analysis Tool  (Wcat)是一种轻量级HTTP负载生成工具,主要用于衡量受控环境中 ...

  9. asp.net core系列 45 Web应用 模型绑定和验证

    一. 模型绑定 ASP.NET Core MVC 中的模型绑定,是将 HTTP 请求中的数据映射到action方法参数. 这些参数可能是简单类型的参数,如字符串.整数或浮点数,也可能是复杂类型的参数. ...

随机推荐

  1. 使用Navicat for MySQL把本地数据库上传到服务器

    服务器系统基本都是基于linux的,这个数据库上传的方式适用于linux的各种版本,比如Ubuntu和Centos(尽管这两个版本各种大坑小坑,但至少在数据库传输上保持了一致性) 当然本地数据库上传到 ...

  2. 利用Python进行数据分析

    最近在阅读<利用Python进行数据分析>,本篇博文作为读书笔记 ,记录一下阅读书签和实践心得. 准备工作 python环境配置好了,可以参见我之前的博文<基于Python的数据分析 ...

  3. Mac下MySQL无my-default.cnf

    转自https://www.jianshu.com/p/628bcf8bb557 As of MySQL 5.7.18, my-default.ini is no longer included in ...

  4. IAAS-虚拟化技术组件介绍

    虚拟化技术组件涉及众多,下面对一些组件所处的层级以及定位做个简单的汇总介绍,部分信息来自于网络整理,如有不准确之处,请指正.

  5. 关于easyui Datagrid一些样式记录

    此篇文章主要记录在使用datagrid中常见的修改样式方式以及样式效果配图!!!! 一丶存在选中框的时候标题栏合并显示序号字段. 代码展示: onLoadSuccess: function (data ...

  6. Fiddler抓包工具证书安装

    转自:https://www.cnblogs.com/hushaojun/p/6385947.html Fiddler证书安装(查看HTTPS) 现在很多带有比较重要信息的接口都使用了安全性更高的HT ...

  7. python_自定日历

    >>> from datetime import date>>> daysOfMonth=[31,28,31,30,31,30,31,31,30,31,30,31] ...

  8. SSM-Spring-22:Spring+Mybatis+JavaWeb的整合

    ------------吾亦无他,唯手熟尔,谦卑若愚,好学若饥------------- 众所周知,框架Spring来整合别的框架,但是Mybatis出现的晚,Spring就没有给他提供支持,那怎么办 ...

  9. mysql各种引擎对比、实战

    1)存储引擎概述: (2)MySQL各大存储引擎: (3)InnoDB和MyIsam使用及其原理对比: (4)InnoDB和MyIsam引擎原理: (5)剩余引擎的使用DEMO(主要是Mrg_Myis ...

  10. LoadRunner 11 中Analysis分析

    原文:http://www.cnblogs.com/Chilam007/p/6445165.html analysis简介 分析器就是对测试结果数据进行分析的组件,它是LR三大组件之一,保存着大量用来 ...