問題
如何在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/
