ASP.NET Core MVC 视图

ASP.NET Core MVC中视图的知识和ASP.NET MVC有很多相似之处，学习难度较低。以下内容主要体现了编程中模块化的思想，模块化才应是我们关注的重点。

Layout

布局用于提供各个页面所需的公共部分，如：菜单、页头、页尾等。在ASP.NET Core中默认的布局文件是位于/Views/Shared文件夹下的_Layout.cshtml文件：

我们通常在_Layout.cshtml中引入公共资源，如：

<link href="~/css/reset.css" rel="stylesheet" />
<link href="~/css/index.css" rel="stylesheet" />
?
<script src="~/js/common/net/ajaxHandler.js"></script>
<environment names="Development">
    <script src="~/js/lib/vue/vue.js"></script>
</environment>
<environment names="Production">
    <script src="~/js/lib/vue/vue.min.js"></script>
</environment>

指定布局文件

可以在Razor视图(即，cshtml文件)中使用Layout属性来指定使用哪个布局文件：

@{
    Layout="_Layout";
}

ASP.NET Core MVC搜索布局文件的方式与局部视图一样，下文中会详细说明。默认情况下，在布局文件中必须调用RenderBody方法。还可以使用RenderSection方法来引入section。

View Import & View Start

View Import

可以在_ViewImport.cshtm文件中添加命名空间或者Tag Helper以供其它视图中使用，如：

@using Microsoft.AspNetCore.Identity
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

在_ViewImport.cshtm文件可以使用以下指令：

  • @addTagHelper
  • @removeTagHelper
  • @tagHelperPrefix
  • @using
  • @model
  • @inherits
  • @inject

_ViewImport.cshtm文件不支持Razor文件的其它特性，如：function、section等。对于多个_ViewImports.cshtml的情况，指令运行结果遵循如下规则：

  • @addTagHelper, @removeTagHelper: 按照先后顺序执行
  • @tagHelperPrefix: 后执行的结果覆盖先执行的结果
  • @model: 后执行的结果覆盖先执行的结果
  • @inherits: 后执行的结果覆盖先执行的结果
  • @using: 引入所指定的所有命名空间，但忽略重复引用
  • @inject: 后注入覆盖先注入的同名属性

View Start

_ViewStart.cshtml文件中的代码会在所有完整视图(full view,not layout,not partial view)文件被渲染之前执行。

默认情况下，ViewImports.cshtml和ViewStart.cshtml文件直接位于Views文件夹下：

  • 相比其它位置的其它位置ViewImports.cshtml和ViewStart.cshtml，直接位于Views文件夹中的ViewImports.cshtml和ViewStart.cshtml文件会优先执行
  • 后执行的ViewImports.cshtml文件中的内容有可能会覆盖先执行ViewImports.cshtml文件中的内容
  • ViewImports.cshtml和ViewStart.cshtml文件的作用域是当前目录及子目录

Tag Helper

Tag Helper可以让服务器端代码参与到在Razor文件中创建和渲染HTML元素的工作中。

自定义Tag Helper：

public class XfhTagHelper : TagHelper
{
    public string Content { set; get; }
?
    public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output)
    {
        output.TagName = "a";
        output.Attributes.Add("href", "https://www.google.com");
        output.Content.SetContent(Content);
    }
}

使用Tag Helper：

@addTagHelper *,Web
?
<xfh content="haha">customer tag helper</xfh>

Tag Helper与HTML Helper有些相似，二者不同之处可参考：Tag Helpers compared to HTML Helpers

Tag Helper具有以下优点：

  • 类HTML语法

    这一点是我喜欢Tag Helper的原因，使用Tag Helper可以使cshtml文件中后台代码与前端的搭配更和谐，利于提升代码可读性

  • 语法智能感知

Tag Helper 作用域

  • @addTagHelper

    @addTagHelper的第一个参数表示要加载哪些Tag Helper，使用"*"表示加载所有的Tag Helper；第二个参数表示从哪个程序集中加载Tag Helper。示例如下：

    @* 需指明TagHelper的完全限定名 *@
@addTagHelper Web.TagHelpers.XfhTagHelper,Web
  • @removeTagHelper

    @removeTagHelper也有两个参数，含义同@addTagHelper

  • @tagHelperPrefix

    给Tag Helper加上前缀标识，示例如下：

    @addTagHelper *,Web
@tagHelperPrefix th:
?
@* 不会被当作Tag Helper处理 *@
<xfh content="haha">customer tag helper</xfh>
<th:xfh content="tagHelperPrefix"></th:xfh>

Partial View

Partial view，局部视图是一个Razor文件，它通常嵌套在另一个Razor文件中。局部视图主要用于拆分大的Razor文件及代码复用。但请注意：

  • 局部视图不应用来维护公共布局中的内容，考虑使用_Layout.cshtml来维护公共布局

    Partial views shouldn‘t be used to maintain common layout elements.

  • 尽量不要在局部视图中使用复杂的渲染逻辑，或者需要执行一些代码片段才能获取到视图元素。这种情况考虑使用view component来替代局部视图。

    Don‘t use a partial view where complex rendering logic or code execution is required to render the markup.If you need to execute code, use a view component instead of a partial view.

声明局部视图

局部视图名通常以下划线_开头，下划线主要用于易于辨识局部视图文件。注意一点，在渲染局部视图时，不会执行_ViewStart.cshtml文件中的代码。其余与普通视图一样。

??局部视图中定义的section只对当前局部视图可见

使用局部视图

引用局部视图文件而不带扩展名cshtml时，在MVC框架中，会从以下路径中加载局部视图文件，优先级从上而下依次降低：

  1. /Areas/<Area-Name>/Views/<Controller-Name>
  2. /Areas/<Area-Name>/Views/Shared
  3. /Views/Shared
  4. /Pages/Shared

当引用局部文件带上扩展名时，局部视图文件必须和引用方位于相同目录下。

可使用以下方式引入局部视图：

  <partial name="partial.cshtml" model="Model"/>
  @* 局部视图文件后缀可以省略，如： *@
  <partial name="partial" />
  @* 也可以使用局部视图文件全名，如： *@
  <partial name="~/Views/Shared/_PartialName.cshtml" />
  • HTML Helper

    @await Html.PartialAsync("_PartialName")

也可以使用 RenderPartialAsync方法来渲染局部视图，该方法直接将渲染结果写入到response中，而不是返回 IHtmlContent，所以只能在Razor代码块中调用该方法：

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

相比于PartialAsync，RenderParatialAsync有着更好的性能。

View Component

View component，视图组件和局部视图类似，但它更强大。一个视图组件包含两部分：ViewComponent类和一个视图。

视图组件不使用模型绑定，视图组件中所用的数据有调用者提供。视图组件有以下特点：

  • 渲染数据块而非整个响应
  • 关注点分离、易于测试
  • 可以有参数和业务逻辑

    MVC本身就提倡关注点分离，所以，视图组件中应尽可能只包含与渲染视图相关的逻辑

  • 通常在层中调用

自定义视图组件

创建视图组件类：

  • 视图组件继承自ViewComponent或使用ViewComponentAttribute特性
  • 自定义类约定以ViewComponent结尾（非强制）
public class FirstViewComponent : ViewComponent
{
    // 方法名InvokeAsync是基于约定的，同步方法名为Invoke
    public async Task<IViewComponentResult> InvokeAsync(string descript)
    {
        return View<string>(descript);
    }
}

?? 视图组件类中可以使用依赖注入。需注意：视图组件不会参与到Controller的生命周期中，所以filter对它无效。

创建视图文件：

视图组件默认视图名为：Default，简单定义视图内容如下：

<label>
    @Model
</label>

在运行时按照以下顺序搜索视图文件：

  • /Views/{Controller Name}/Components/{View Component Name}/{View Name}
  • /Views/Shared/Components/{View Component Name}/{View Name}
  • /Pages/Shared/Components/{View Component Name}/{View Name}

?? 推荐使用Default作为视图组件的视图文件名，且视图文件存放路径为：Views/Shared/Components/{View Component Name}/{View Name}

可以使用如下两种方式来调用视图组件：

  • Component.InvokeAsync
  • Tag Helper
@addTagHelper *,Web
?
<div class="text-center">
    @await Component.InvokeAsync("First", new { descript = "invoking view component" })
    <br />
    @* Tag Helper方式调用ViewComponent，需以vc:作为前缀 *@
    <vc:first descript="tag helper">
    </vc:first>
</div>

?? 注意，使用Tag Helper形式调用视图组件时，组件名和组件的方法参数使用 kebab case方式，即，组件PriorityList有参数maxPriority，则调用方式如下：

<vc:priority-list max-priority="2">
</vc:priority-list>

除此之外，还可以在Controller中调用视图组件：

public IActionResult InvokeVC()
{
    // 注意，视图组件名称大小写敏感
    return ViewComponent("First", new { Descript = "controller"});
}

View component methods

抄录一段微软官网上对于View component methods的总结，人太懒，就不翻译了??，留意加粗部分：

A view component defines its logic in an InvokeAsync method that returns a Task<IViewComponentResult> or in a synchronous Invoke method that returns an IViewComponentResult. Parameters come directly from invocation of the view component, not from model binding. A view component never directly handles a request. Typically, a view component initializes a model and passes it to a view by calling the View method. In summary, view component methods:

  • Define an InvokeAsync method that returns a Task<IViewComponentResult> or a synchronous Invokemethod that returns an IViewComponentResult.
  • Typically initializes a model and passes it to a view by calling the ViewComponent View method.
  • Parameters come from the calling method, not HTTP. There‘s no model binding.
  • Are not reachable directly as an HTTP endpoint. They‘re invoked from your code (usually in a view). A view component never handles a request.
  • Are overloaded on the signature rather than any details from the current HTTP request.

小结

本文主要对ASP.NET Core中的视图部分做了简要概述，相比于文中的各种概念，我们应该把注意力放到模块化设计上。模块化、抽象思维是程序员应该掌握的两种能力。他们可以让我们写出高内聚、低耦合的代码。

点击下载Demo源码

推荐阅读

Tag Helpers in ASP.NET Core

View components in ASP.NET Core

Areas in ASP.NET Core

原文地址：https://www.cnblogs.com/Cwj-XFH/p/10885745.html

时间： 2024-10-10 09:55:10

ASP.NET Core MVC 视图的相关文章

ASP.NET Core 入门教程 5、ASP.NET Core MVC 视图传值入门

原文:ASP.NET Core 入门教程 5.ASP.NET Core MVC 视图传值入门 一.前言 1.本教程主要内容 ASP.NET Core MVC 视图引擎(Razor)简介 ASP.NET Core MVC 视图(Razor)ViewData使用示例 ASP.NET Core MVC 视图(Razor)ViewBag使用示例 ASP.NET Core NVC 视图(Razor)强类型传值(ViewModel)页示例 2.本教程环境信息 软件/环境 说明 操作系统 Windows 10

ASP.NET Core 入门教程 7、ASP.NET Core MVC 分部视图入门

原文:ASP.NET Core 入门教程 7.ASP.NET Core MVC 分部视图入门 一.前言 1.本教程主要内容 ASP.NET Core MVC (Razor)分部视图简介 ASP.NET Core MVC (Razor)分部视图基础教程 ASP.NET Core MVC (Razor)强类型分部视图教程 2.本教程环境信息 软件/环境 说明 操作系统 Windows 10 SDK 2.1.401 ASP.NET Core 2.1.3 IDE Visual Studio Code 1

asp.net core mvc权限控制：在视图中控制操作权限

在asp.net core mvc中提供了权限验证框架,前面的文章中已经介绍了如何进行权限控制配置,权限配置好后,权限验证逻辑自动就会执行,但是在某些情况下,我们可能需要在代码里或者视图中通过手工方式判断权限,我们现在就来介绍下具体的操作方法. 如果在控制器方法里想要判断当前用户是否具有某个权限,可以直接使用HttpContext.User.HasClaim(string cliamtype,string cliamvalue)方法进行判断,该方法返回bool类型,返回true表示具有权限,否则

007.Adding a view to an ASP.NET Core MVC app -- 【在asp.net core mvc中添加视图】

Adding a view to an ASP.NET Core MVC app 在asp.net core mvc中添加视图 2017-3-4 7 分钟阅读时长 本文内容 1.Changing views and layout pages 修改视图和布局页 2.Change the title and menu link in the layout file 在布局文件中修改标题与菜单 3.Passing Data from the Controller to the View 从控制器向视图

从零开始实现ASP.NET Core MVC的插件式开发(一) - 使用ApplicationPart动态加载控制器和视图

标题:从零开始实现ASP.NET Core MVC的插件式开发(一) - 使用Application Part动态加载控制器和视图作者:Lamond Lu地址:https://www.cnblogs.com/lwqlun/p/11137788.html源代码:https://github.com/lamondlu/Mystique 前言# 如果你使用过一些开源CMS的话,肯定会用过其中的的插件化功能,用户可以通过启用或者上传插件包的方式动态添加一些功能,那么在ASP.NET Core MVC中如

ASP.NET Core MVC通过IViewLocationExpander扩展视图搜索路径

原文:ASP.NET Core MVC通过IViewLocationExpander扩展视图搜索路径 IViewLocationExpander API ExpandViewLocations Razor视图路径,视图引擎会搜索该路径. PopulateValues 每次调用都会填充路由 项目目录如下所示 创建区域扩展器,其实我并不需要多区域,我目前只需要达到一个区域中有多个文件夹进行存放我的视图. 所以我通过实现IViewLocationExpander进行扩展添加我自定义视图路径规则即可正如

Pro ASP.NET Core MVC 6th 第三章

第三章 MVC 模式,项目和约定 在深入了解ASP.NET Core MVC的细节之前,我想确保您熟悉MVC设计模式背后的思路以及将其转换为ASP.NET Core MVC项目的方式. 您可能已经了解本章中讨论的一些想法和约定,特别是如果您已经完成了高级ASP.NET或C#开发. 如果没有,我鼓励你仔细阅读 - 深入地理解隐藏在MVC背后的东西可以帮助你在通读本书时更好地与MVC框架的功能联系起来. MVC的历史 模型视图控制器模式起源于20世纪70年代后期,来自施乐PARC的Smalltalk

Pro ASP.NET Core MVC 第6版 第二章（后半章）

增加动态输出 整个web应用平台的关注点在于构建并显示动态输出内容.在MVC里,控制器负责构建一些数据并将其传给视图.视图负责渲染成HTML. 从控制器向视图传递数据的一种方式是使用ViewBag 对象,它是一个控制器基类的成员.ViewBag是一个动态对象,你可以给他赋值任意属性给视图来渲染用.代码2-5 演示了如何在HomeController里传递简单对象. Listing 2-5. 设置视图数据 using System; using Microsoft.AspNetCore.Mvc;

Pro ASP.NET Core MVC 第6版 第一章

第一章 ASP.NET Core MVC 的前世今生 ASP.NET Core MVC 是一个微软公司开发的Web应用程序开发框架,它结合了MVC架构的高效性和简洁性,敏捷开发的思想和技术,和.NET 平台的最好的部分.在本章,我们将学习为什么微软创建ASP.NET Core MVC, 看看他和他的前辈的比较以及和其他类似框架的比较,最后,大概讲一下ASP.NET core MVC里面有什么新东西,还有本书中包括哪些内容. 了解ASP.NET Core MVC的历史 最开始的ASP.NET 诞生