设为首页 加入收藏

TOP

asp.net core系列 42 Web 应用 分部视图(一)
2019-09-17 18:33:45 】 浏览:32
Tags:asp.net core 系列 Web 应用 分部

一.分部视图

  对于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 的语法:

        <partial name="_PartialName" />

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

      <partial name="_PartialName.cshtml" />

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

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

    

    (2) 异步 HTML 帮助程序

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

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

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

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

 

  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

                &nb

首页 上一页 1 2 下一页 尾页 1/2/2
】【打印繁体】【投稿】【收藏】 【推荐】【举报】【评论】 【关闭】 【返回顶部
上一篇asp.net core 使用identityServer.. 下一篇现身说法:实际业务出发分析百亿..

最新文章

热门文章

Hot 文章

Python

C 语言

C++基础

大数据基础

linux编程基础

C/C++面试题目