您的位置:首页 > 编程语言 > ASP

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

2018-11-09 10:06 1131 查看

一、前言

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
SDK 2.1.401
ASP.NET Core 2.1.3
IDE Visual Studio Code 1.28
浏览器 Chrome 70

本篇代码以下代码进行调整:https://github.com/ken-io/asp.net-core-tutorial/tree/master/chapter-02

3、前置知识

你可能需要的前置知识

  • MVC框架/模式介绍

https://baike.baidu.com/item/mvc

4、准备工作

VS Code 本身不提供 ASP.NET Core MVC 视图引擎(Razor)的智能感知。
幸运的是,VS Code C#扩展 从 1.17.0 版本开始支持Razor视图引擎的智能感知。

所以,我们要将VS Code C#扩展升级到最新版本。

二、ASP.NET Core MVC 视图引擎(Razor)简介

1、ASP.NET Core MVC 视图引擎(Razor)概述

在MVC架构模式中,视图引擎/模板引擎负责将控制器(Controller)提供的数据结合视图模板进行渲染我们需要的格式(通常是HTML)。控制器(Controller)再将渲染的结果返回给请求的客户端。

在 ASP.NET Core MVC框架中,提供了视图引擎:Razor。
Razor提供了后缀为.cshtml的视图模板。Razor视图模板支持使用Razor标记语言以及C#进行编写。使用起来非常方便。

Razor 就相当于Java平台常用的 Freemarker、Thymeleaf

2、Razor视图模板文件位置与指定

视图文件位置

Razor视图模板文件通常放在根目录Views文件夹对应控制器的子目录中。
例如: ~/Views/Home/Time.cshtml。

这是因为按照 ASP.NET Core MVC框架的约定,当我们在控制器(Controller)返回一个视图(

return View();
)时,如果只指定了视图名称(ViewName),并没有指定视图的完成路径,那么MVC框架将按照以下顺序查找视图:

  • Views/[ControllerName]/[ViewName].cshtml
  • Views/Shared/[ViewName].cshtml

视图指定方式

  • 隐式指定
public class HomeController : Controller
{
public IActionResult Test(){
return View();
}
}

当没有指定ViewName的时候,ViewName=ActionName=”Test”;
框架将按照约定顺序查找视图文件

  • 显示指定视图名
public class HomeController : Controller
{
public IActionResult Test(){
return View("Test");
}

public IActionResult TestAbc(){
return View("abc");
}
}

分别手动指定了视图名;ViewName=”Test”、ViewName=”abc”;
框架将按照约定顺序查找视图文件

  • 显示指定视图文件
public class HomeController : Controller
{
public IActionResult Test(){
return View("Views/Test.cshtml");
}
}

固定查找 Views/Test.cshtml 视图文件

三、Razor视图引擎传递数据

1、准备工作

  • 创建RenderDataController

在Controllers文件夹下新增控制器RenderDataController.cs并继承于Controller

using System;
using Microsoft.AspNetCore.Mvc;

namespace Ken.Tutorial.Web.Controllers
{
public class RenderDataController : Controller
{

}
}
  • 创建对应视图文件夹

在Views目录下创建文件夹

RenderData

2、弱类型参数传递数据

弱类型参数说明

  • ViewData

    派生自 ViewDataDictionary,因此它有可用的字典属性,如 ContainsKey、Add、Remove 和 Clear。
  • 字典中的键是字符串,因此允许有空格。 示例:ViewData[“ken”]
  • 任何非 string 类型均须在视图中进行强制转换才能使用 ViewData。
  • ViewBag

      派生自 DynamicViewData,因此它可使用点表示法 (@ViewBag.SomeKey = ) 创建动态属性,且无需强制转换。
    • ViewBag 的语法使添加到控制器和视图的速度更快。
    • ViewBag 更易于检查 NULL 值。 示例:@ViewBag.Person?.Name

    ViewData使用示例

    • 创建Action:ViewDataDemo
    public IActionResult ViewDataDemo()
    {
    ViewData["name"] = "ken";
    ViewData["birthday"] = new DateTime(2000, 1, 1);
    ViewData["hobby"] = new string[] { "跑步", "阅读", "Coding" };
    return View();
    }
    • 创建视图:ViewDataDemo.cshtml
    @{
    var hobby =ViewData["hobby"] as String[];
    }
    
    <h3>@ViewData["title"]</h3>
    <ul>
    <li>姓名:@ViewData["name"]</li>
    <li>生日:@ViewData["birthday"]</li>
    <li>爱好:@hobby[0] , @hobby[1]</li>
    </ul>
    • 访问测试

    启动项目,访问 

    /renderdata/viewdatademo
     将会看到:

    ViewData传值示例
    姓名:ken
    生日:01/01/2000 00:00:00
    爱好:跑步 , 阅读

    ViewBag使用示例

    • 创建Action:ViewBagDemo
    public IActionResult ViewBagDemo()
    {
    ViewBag.Title = "ViewBag传值示例";
    ViewBag.Name = "ken";
    ViewBag.Birthday = new DateTime(2000, 1, 1);
    ViewBag.Hobby = new string[] { "跑步", "阅读", "Coding" };
    return View();
    }
    • 创建视图:ViewBagDemo.cshtml
    @{
    var hobby =ViewBag.Hobby as String[];
    }
    
    <h3>@ViewBag.Title</h3>
    <ul>
    <li>姓名:@ViewBag.Name</li>
    <li>生日:@ViewBag.Birthday</li>
    <li>爱好:@hobby[0] , @hobby[1]</li>
    </ul>
    • 访问测试

    启动项目,访问 

    /renderdata/viewbagdemo
     将会看到:

    ViewBag传值示例
    姓名:ken
    生日:01/01/2000 00:00:00
    爱好:跑步 , 阅读

    3、强类型参数传递数据

    强类型参数说明

    视图强类型通常称为ViewModel,我们可以在

    return View();
    时指定视图参数/对象。并在视图文件(.cshtml)中通过 
    @model
     语法指定对应的类型,这样我们可以在视图文件(.cshtml)中使用
    Model
    关键字来使用传输到视图的该类型的实例。

    强类型参数示例

    • 创建Person类

    在项目根目录创建

    Models
    文件夹并在文件中创建
    Person.cs

    using System;
    
    namespace Ken.Tutorial.Web.Models
    {
    public class Person
    {
    public string Name { get; set; }
    
    public DateTime Birthday { get; set; }
    
    public string[] Hobby { get; set; }
    }
    }
    • 创建Action:ViewModelDemo
    public IActionResult ViewModelDemo()
    {
    ViewBag.Title = "ViewModel传值示例";
    var person = new Person
    {
    Name = "ken",
    Birthday = new DateTime(2000, 1, 1),
    Hobby = new string[] { "跑步", "阅读", "Coding" }
    };
    //等同于 return View("ViewModelDemo", person);
    return View(person);
    }
    • 创建视图:ViewModelDemo.cshtml
    @model Ken.Tutorial.Web.Models.Person;
    
    <h3>@ViewBag.Title</h3>
    <ul>
    <li>姓名:@Model.Name</li>
    <li>生日:@Model.Birthday</li>
    <li>爱好:@Model.Hobby[0] , @Model.Hobby[1]</li>
    </ul>
    • 访问测试

    启动项目,访问 

    /renderdata/viewmodeldemo
     将会看到:

    ViewModel传值示例
    姓名:ken
    生日:01/01/2000 00:00:00
    爱好:跑步 , 阅读

    四、备注

    1、附录

    • 本文代码示例

    https://github.com/ken-io/asp.net-core-tutorial/tree/master/chapter-05

    • 本文参考

    https://docs.microsoft.com/zh-cn/aspnet/core/mvc/views/overview?view=aspnetcore-2.1

    本文首发于我的独立博客:https://ken.io/note/asp.net-core-tutorial-mvc-view-renderdata

  • 内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
    标签: 
    相关文章推荐