详解ASP.NET Core 2.0 视图引擎(译)

问题

如何在ASP.NET Core 2.0中使用Razor引擎来创建视图?

答案

新建一个空项目,修改Startup.cs,添加MVC服务和请求中间件:

public void ConfigureServices(IServiceCollection services)

{

  services.AddMvc();

}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)

{

  if (env.IsDevelopment())

  {

    app.UseDeveloperExceptionPage();

  }

  app.UseMvc(routes =>

  {

    routes.MapRoute(

      name: "default",

      template: "{controller=Home}/{action=Index}/{id?}");

  });

}  

添加Controllers目录,并添加HomeController控制器:

public class HomeController : Controller

{

  public IActionResult Index()

  {

    return View();

  }

}

添加Views/Home目录,并添加Razor视图Index.cshtml:

@{

  var birthDate = new DateTime(1930, 8, 26);

}

<strong>Hello MVC Razor</strong>

<p>James Bond, you were born @birthDate.ToString("yyyy-MM-dd")</p>

<p>James Bond is about @((DateTime.Now - birthDate).Days / 365) years old</p>

<p>@("<strong>Hello World</strong>")</p>

<p>@Html.Raw("<strong>james@bond.com</strong>")</p>

@{

  var isHungry = true;

  var gender = 0;

  IEnumerable<string> friends = new[] { "Thor", "Hulk", "Iron Man" };

  var technology = "asp.net mvc";

  var count = technology.Count();

}

<p>

  @if (isHungry)

  {

    <text>I'm hungry</text>

  }

  else

  {

    <text>I'm full</text>

  }

</p>

@switch (gender)

{

  case 0:

    <p>Male</p>

    break;

  case 1:

    <p>Female</p>

    break;

  default:

    break;

}

@for (int i = 0; i < technology.Length; i++)

{

  @technology[i].ToString().ToUpper()

}

<ul>

  @foreach (var item in friends)

  {

    <li>@item</li>

  }

</ul>

@try

{

  var a = 1; var b = 0;

  var result = a / b; // divide by zero

}

catch (Exception ex)

{

  <p>@ex.Message</p>

}

此时的目录结构如下所示:

运行,此时页面显示:

讨论

当控制器返回ViewResult时,ASP.NET Core中间件会查找并执行Razor模板(.cshtml文件)。Razor模板使用C#和HTML的混合语法来生成最终的HTML页面。

查找视图

当ViewResult执行时,它会按照如下顺序查找视图所在路径:

1. Views/[Controller]/[Action].cshtml

2. Views/Shared/[Action].cshtml

如果模板文件名和控制器方法的名称不一致,可以在ViewResult中通过参数来指定视图模板的名称:

public IActionResult AboutMe()

{

  return View("Bio");

} 

Razor语法

HTML标签会原封不动的渲染到最终的HTML页面中:

<strong>Hello MVC Razor</strong>   

通过@符号从HTML过渡到C#代码。C#代码块可以用如下结构包含起来:

@{

  var birthDate = new DateTime(1930, 8, 26);

} 

C#表达式可以直接通过@符号来输出到最终HTML页面:

<p>James Bond, you were born @birthDate.ToString("yyyy-MM-dd")</p> 

或者用@( //C#表达式 )来包含起来:

<p>James Bond is about @((DateTime.Now - birthDate).Days / 365) years old</p> 

Razor默认会对C#表达式进行HTML编码,观察下面的Razor代码以及生成到页面上的HTML结构:

<p>@("<strong>Hello World</strong>")</p> 

<p><strong>Hello World</strong></p>

@Html.Raw可以避免C#表达式被HTML编码,如下所示:

<p>@Html.Raw("<strong>james@bond.com</strong>")</p> 

<p><strong>james@bond.com</strong></p>

    

控制结构

Razor视图中,我们可以在C#代码块中使用各种控制结构,比如@if, @switch, @for, @foreach, @while, @do while和@try。具体示例可以查看Views/Home/Index.cshtml代码。

指令

Razor视图会被转化为继承自RazorPage的C#类(内部实现,对用户透明)。而指令可以改变这些类或者视图引擎的行为。常用的指令有:

@using

向生成的C#类添加一个using指令。类似于普通的C#类,这个指令用来导入命名空间。

@model

指定传入RazorPage的泛型类型T。当控制器返回ViewResult时,可以通过参数来指定模型类型。然后在视图页面中通过Model属性来获取模型实例。

@inject

用来向视图注入服务(首先需要在Startup中在服务容器中注册此服务)。你需要提供服务类型和名称(视图中通过此名称访问服务)。视图的依赖注入用于为视图提供强类型的数据查询服务,否则我们就需要动态的ViewData或者ViewBag属性来实现。

视图的依赖注入

下面通过一个较完整的示例来讲解@using,@model和@inject指令的用法。

首先创建一个服务:

public interface IGreeter

{

  string Greet(string firstname, string surname);

}

public class Greeter : IGreeter

{

  public string Greet(string firstname, string surname)

  {

    return $"Hello {firstname} {surname}";

  }

} 

在Startup的服务容器中注册此服务:

public void ConfigureServices(IServiceCollection services)

{

  services.AddScoped<IGreeter, Greeter>();

  services.AddMvc();

}

创建一个模型:

public class AboutViewModel

{

  public string Firstname { get; set; }

  public string Surname { get; set; }

}

从控制器方法中返回模型实例:

public class HomeController : Controller

{

  public IActionResult Index()

  {

    return View();

  }

  public IActionResult AboutMe()

  {

    var model = new AboutViewModel

    {

      Firstname = "Tahir",

      Surname = "Naushad"

    };

    return View("Bio", model);

  }

}

现在我们可以在视图中使用模型和服务了:

 @using RazorEngine.Models

@model AboutViewModel

@inject IGreeter GreeterService

<p>@GreeterService.Greet(Model.Firstname, Model.Surname)</p>

运行,此时页面显示:

源代码下载

原文:https://tahirnaushad.com/2017/08/23/asp-net-core-2-0-mvc-razor/

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。

(0)

相关推荐

  • 浅谈ASP.NET Core 2.0 带初始参数的中间件(译)

    问题 如何在ASP.NET Core 2.0向中间件传入初始参数? 答案 在一个空项目中,创建一个POCO(Plain Old CLR Object)来保存中间件所需的参数: public class GreetingOptions { public string GreetAt { get; set; } public string GreetTo { get; set; } } 添加一个中间件: public class GreetingMiddleware { private readon

  • ASP.NET Core 2.0 带初始参数的中间件问题及解决方法

    问题 如何在ASP.NET Core 2.0向中间件传入初始参数? 答案 在一个空项目中,创建一个POCO(Plain Old CLR Object)来保存中间件所需的参数: public class GreetingOptions { public string GreetAt { get; set; } public string GreetTo { get; set; } } 添加一个中间件: public class GreetingMiddleware { private readon

  • 浅谈ASP.NET Core 2.0 中间件(译)

    问题 如何创建一个最简单的ASP.NET Core中间件? 答案 使用VS创建一个ASP.NET Core 2.0的空项目,注意Startup.cs中的Configure()方法: public void Configure(IApplicationBuilder app, IHostingEnvironment env) { app.Run(async (context) => { await context.Response.WriteAsync("Hello World! (Run)

  • [译]ASP.NET Core 2.0 网址重定向的方法

    问题 如何在ASP.NET Core 2.0中实现网址重定向? 答案 新建一个空项目,在Startup.cs文件中,配置RewriteOptions参数并添加网址重定向中间件(UseRewriter): public void Configure(IApplicationBuilder app, IHostingEnvironment env) { var rewrite = new RewriteOptions() .AddRedirect("films", "movies

  • Amazing ASP.NET Core 2.0

    前言 ASP.NET Core 的变化和发展速度是飞快的,当你发现你还没有掌握 ASP.NET Core 1.0 的时候, 2.0 已经快要发布了,目前 2.0 处于 Preview 1 版本,意味着功能已经基本确定,还没有学习过 ASP.NET Core 的同学可以直接从 2.0 开始学起,但是如果你已经掌握了 1.0 的话,那么你只需要了解在 2.0 中增加和修改的一些功能即可. 每一次大版本的发布和升级,总会带给开发人员一些惊喜和令人兴奋的特性,有关 ASP.NET Core 本次的 2.

  • ASP.NET Core 2.0 支付宝扫码支付的实现代码

    前言 自从微软更换了CEO以后,微软的战略方向有了相当大的变化,不再是那么封闭,开源了许多东西,拥抱开源社区,.NET实现跨平台,收购xamarin并免费提供给开发者等等.我本人是很喜欢.net的,并希望.net core能够崛起.我是从.net core 1.1的时候开始使用的,到现在的.net core 2.0..net core 2.0比1.1有了一些改变,api也增加了很多,用着更顺手了,最近在做asp.net core 对接支付宝,百度了一下没找到关于core的支付宝支付相关资料,所以

  • ASP.NET Core 2.0 使用支付宝PC网站支付实现代码

    前言 最近在使用ASP.NET Core来进行开发,刚好有个接入支付宝支付的需求,百度了一下没找到相关的资料,看了官方的SDK以及Demo都还是.NET Framework的,所以就先根据官方SDK的源码,用.NET Standard 2.0 实现了支付宝服务端SDK,Alipay.AopSdk.Core(github:https://github.com/stulzq/Alipay.AopSdk.Core) ,支持.NET CORE 2.0.为了使用方便,已上传至Nuget可以直接使用. 支付

  • CodeFirst从零开始搭建Asp.Net Core2.0网站

    一步步教大家如何搭建Asp.Net Core2.0网站,以下所有都是建立在.NETCore2.0环境已经搭建好 右键解决方案>新建项目> 选择Web>ASP.NETCoreWeb应用程序(.NET Core) 选择Web应用程序,暂时不选择启用Docker,身份验证选择个人用户账户(会自动生成一系列和用户认证的代码) 随后生代码层次目录如下: 其中会包含身份信息的相关实现,比如相关实体信息(user)之类的,如果想对扩展微软自动的生成的用户实体类,可在Models中的Applicatio

  • [译]ASP.NET Core 2.0 路由引擎详解

    本文介绍了ASP.NET Core 2.0 路由引擎详解,分享给大家,具体如下: 问题 ASP.NET Core 2.0的路由引擎是如何工作的? 答案 创建一个空项目,为Startup类添加MVC服务和请求中间件: public void ConfigureServices(IServiceCollection services) { services.AddMvc(); } public void Configure(IApplicationBuilder app, IHostingEnvir

  • ASP.NET Core 2.0 本地文件操作问题及解决方案

    问题 如何在ASP.NET Core 2.0中受限地访问本地目录和文件信息? 答案 新建一个空项目,修改Startup类,添加访问本地文件所需的服务: public void ConfigureServices(IServiceCollection services) { services.AddSingleton<IFileProvider>( new PhysicalFileProvider(Directory.GetCurrentDirectory())); } 创建一个中间件,读取根目

随机推荐