作者：[美]Adam Freeman 来源：《精通ASP.NET MVC 4》
Razor 是微软 MVC3 引入的视图引擎的名称，并在MVC 4 中进行了修订。视图引擎处理 ASP.NET内容，并查找指令，典型的是将动态内容插入到发送给浏览器的输出。
微软维持了两个视图引擎 —— 已经支持 ASP.NET 开发许多年的基于<% 和 %>标签的 ASPX 引擎，以及以@字符标注内容范围的 Razor 引擎。
1.创建示例项目
打开Microsoft Visual Studio 2012 ，新建MVC 4项目 Razor ，选择空模板。
1.1 定义模型
在 Models 文件夹下新建类文件 Product.cs
namespace Razor.Models
{
public class Product
{
public int ProductID { get; set; }
public string Name { get; set; }
public string Description { get; set; }
public decimal Price { get; set; }
public string Category { get; set; }
}
}
1.2 定义控制器
在 Controllers 文件夹下新建控制器 HomeController ，模板为空
namespace Razor.Controllers
{
/**
* 此类定义了一个叫做 Index 的动作方法，创建了一个Product 对象，并对其进行属性填充。
* 将此Product 对象传递给了 View 方法，以便在渲染视图时使用它。
* */
public class HomeController : Controller
{
Product myProduct = new Product
{
ProductID = ,
Name = "Kayak",
Description = "A boat for one person",
Category = "Watersports",
Price = 275M
}; public ActionResult Index()
{
return View(myProduct);
} }
}
1.3 创建视图
右击 HomeController 类的 Index 方法，添加视图文件 Index.cshtml ,模型类为 Razor.Models.Product
@model Razor.Models.Product
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
</head>
<body>
<div>
</div>
</body>
</html>
2.使用模型对象
从视图第一行开始
...
@model Razor.Models.Product
...
Razor 语句以@字符开始。此处@model 语句声明了通过动作方法传递给该视图的模型对象的类型。这让用户能够通过@Model 来引用视图模型对象的方法、字段和属性。
@model Razor.Models.Product
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
</head>
<body>
<div>
产品名称：@Model.Name
</div>
<div>
产品说明：@Model.Description
</div>
<div>
产品类别：@Model.Category
</div>
</body>
</html>
显示效果：
* 声明视图模型对象的类型使用@model (小写m)，而访问Name 属性使用@Model (大写M)。
3.使用布局
Index.cshtml 视图文件中的另一个 Razor 表达式如下所示：
...
@{
Layout = null;
}
...
这是一个 Razor 代码块的例子，这种代码块能够在视图中包含C#语句。这种代码块以@{开始，以}结束，而其中的语句会在视图被渲染时进行执行。
此处将Layout 设置为null的效果是告诉 MVC 框架，改视图是自包含的，并且会渲染返回给客户端所需要的全部内容。
3.1 创建布局
右击Views 文件夹新建 "MVC 4布局页(Razor)"，文件名为 _BaseLayout.cshtml 。布局的最初内容如下：
<!DOCTYPE html> <html>
<head>
<meta name="viewport" content="width=device-width" />
<title>@ViewBag.Title</title>
</head>
<body>
<div>
@RenderBody()
</div>
</body>
</html>
布局是特殊形式的视图。对@RenderBody 方法的调用会将动作方法所指定的视图内容插入到布局标记中。布局中的另一个 Razor 表达式会在 ViewBag 中查找一个叫做 Title 的属性，目的是设置 title 元素的内容。
修改布局文件如下：
<!DOCTYPE html> <html>
<head>
<meta name="viewport" content="width=device-width" />
<title>@ViewBag.Title</title>
</head>
<body>
<div>
<h1>Product Information</h1>
<div style="padding:20px;border:solid medium black;font-size:20pt;">
@RenderBody()
</div>
<h2>Visit <a href="http://apress.com">Apress</a></h2>
</div>
</body>
</html>
3.2 运用布局
为了将布局文件运用于视图，只需要设置 Layout 属性的值。修改 Index.cshtml 如下：
@model Razor.Models.Product
@{
ViewBag.Title = "Product Info";
Layout = "~/Views/_BaseLayout.cshtml";
}
<div>
产品名称：@Model.Name
</div>
<div>
产品说明：@Model.Description
</div>
<div>
产品类别：@Model.Category
</div>
<div>
产品价格：$@Model.Price
</div>
显示效果如下图所示：
3.3 使用视图起始文件
还有个小问题要解决，这就是，必须在每一个视图中都要指定布局文件。这意味着，要重新命名布局文件，那么必须找出引用该布局的每一个视图并进行修改，这将是一个易错的过程。
通过使用视图起始文件可以解决此问题。在渲染一个视图时，MVC 框架会查找一个叫作 _ViewStart.cshtml 的文件。框架会将此文件的内容视为视图文件的一部分，于是用户可以使用这一特性为 Layout 属性自动的设置一个值。
同样，在Views 文件夹下新建"MVC 4布局页(Razor)"，文件名为 _ViewStart.cshtml ，修改文件内容为：
@{
Layout = "~/Views/_BaseLayout.cshtml";
}
此视图起始文件含有 Layout 属性的值，这意味着用户可以去除 Index.cshtml 文件中相应的语句：
@model Razor.Models.Product
@{
ViewBag.Title = "Product Info";
}
<div>
产品名称：@Model.Name
</div>
<div>
产品说明：@Model.Description
</div>
<div>
产品类别：@Model.Category
</div>
<div>
产品价格：$@Model.Price
</div>
不必以任何方式指定希望使用的视图起始文件。MVC 框架会对此文件进行定位，并自动地使用其内容。若在视图文件中重新定义了 Layout 值，会覆盖视图起始文件中所指定的布局。
3.4 演示共享布局
在控制器文件 HomeController 中新建方法 NameAndPrice 如下：
public ActionResult NameAndPrice()
{
return View(myProduct);
}
添加对应的视图文件 NameAndPrice.cshtml 如下
@model Razor.Models.Product
@{
ViewBag.Title = "NameAndPrice";
Layout = "~/Views/_BaseLayout.cshtml";
}
<h2>NameAndPrice</h2>
The product name is @Model.Name and it costs $@Model.Price
启动并导航到 /Home/NameAndPrice ，显示效果如下：
4.使用 Razor 表达式
在一个好的MVC框架应用程序中，动作方法与视图所起的作用是清晰分离的。
| 动作方法与视图所起的作用 | ||
| 组件 | 要做的事 | 不做的事 |
| 动作方法 | 向视图传递一个视图模型 | 向视图传递格式化的数据 |
| 视图 | 使用视图模型对象向用户表现内容 | 修改视图模型对象的任何方面 |
4.1插入数据值
用 Razor 表达式能做的最简单的事情是将数据值插入到标记中。用户可以用@Model 表达式来做这件事情，以引用视图模型对象所定义的属性和方法，或者使用@Viewbag 表达式，以引用通过视图包特性动态定义的属性。
在 Home 控制器中新增动作方法 DemoExpressions
public ActionResult DemoExpressions()
{
ViewBag.ProductCount = ;
ViewBag.ExpressShip = true;
ViewBag.ApplyDiscount = false;
ViewBag.Supplier = null;
return View(myProduct);
}
并创建对应的视图文件 DemoExpression.cshtml
@model Razor.Models.Product
@{
ViewBag.Title = "DemoExpressions";
}
<table>
<thead>
<tr><th>Property</th><th>Value</th></tr>
</thead>
<tbody>
<tr><th>Name</th><th>@Model.Name</th></tr>
<tr><th>Price</th><th>@Model.Price</th></tr>
<tr><th>Stock Level</th><th>@ViewBag.ProductCount</th></tr>
</tbody>
</table>
导航到对应的URL /Home/DemoExpressions ，显示效果如下：
4.2 设置标签属性的值
到此为止的所有例子都是设置元素内容，但用户也可以使用Razor 表达式来设置元素标签的值。修改视图文件 DemoExpressions.cshtml 文件如下：
@model Razor.Models.Product
@{
ViewBag.Title = "DemoExpressions";
}
<table>
<thead>
<tr><th>Property</th><th>Value</th></tr>
</thead>
<tbody>
<tr><th>Name</th><th>@Model.Name</th></tr>
<tr><th>Price</th><th>@Model.Price</th></tr>
<tr><th>Stock Level</th><th>@ViewBag.ProductCount</th></tr>
</tbody>
</table>
<div data-discount="@ViewBag.ApplyDiscount" data-express="@ViewBag.ExpressShip" data-supplier="@ViewBag.Supplier">
The containing element has data attributes
</div>
Discount:<input type="checkbox" checked="@ViewBag.ApplyDiscount"/>
Express:<input type="checkbox" checked="@ViewBag.ExpressShip" />
Supplier:<input type="checkbox" checked="@ViewBag.Supplier" />
显示效果如下：
4.3 使用条件语句
修改视图文件 DemoExpressions.cshtml 文件如下：
@model Razor.Models.Product
@{
ViewBag.Title = "DemoExpressions";
}
<table>
<thead>
<tr><th>Property</th><th>Value</th></tr>
</thead>
<tbody>
<tr><th>Name</th><th>@Model.Name</th></tr>
<tr><th>Price</th><th>@Model.Price</th></tr>
<tr><th>Stock</th>
<th>
@switch ((int)ViewBag.ProductCount)
{
case 0:
@:Out of Stock
break;
case 1:
<b>Low Stock (@ViewBag.ProductCount)</b>
break;
default:
@ViewBag.ProductCount
break;
}
</th>
</tr>
</tbody>
</table>
为了开始一个条件语句，要在C# 的条件关键字前放一个@字符。在此例中，此条件关键字 switch。就像在规则的C# 代码块中的一样，要以闭花括号{}来终止代码块
在 Razor 代码块的内部，只要通过定义HTML 以及Razor 表达式，就可以将HTML 元素和数值插入到视图输出，例如：
...
<b>Low Stock (@ViewBag.ProductCount)</b>
...
@ViewBag.ProductCount
...
不必将元素或表达式放在引号内或以特殊的方式来表示它们——Razor 引擎会将这些解释为正常方式处理的输出。然而，如果想将未包含在HTML 元素中的文字文本插入到视图，则需要使用Razor 的一个辅助工具，并以它作为这一行的前缀，例如：
...
@:Out of Stock
...
@:字符阻止Razor 将此行解释为一条C# 语句，这是Razor 遇到文本时的默认行为。
此例显示效果如下：
把此例的switch语句改成if语句，也可产生同样的效果：
@if (ViewBag.ProductCount == 0)
{
@:Out of Stock
}
else if (ViewBag.ProductCount == 1)
{
<b>Low Stock (@ViewBag.ProductCount)</b>
}
else
{
@ViewBag.ProductCount
}
4.4 枚举数组和集合
在编写MVC 应用程序时，用户会经常希望枚举一个数组或一些其他形式对象集合的内容，并生成一种细节内容。
在 Home 控制器文件 HomeController.cs 中新建动作方法 DemoArray
public ActionResult DemoArray()
{
Product[] array = {
new Product{Name="Kayak",Price=275M},
new Product{Name="Lifejacket",Price=48.95M},
new Product{Name="Soccer",Price=19.50M},
new Product{Name="Corner flag",Price=34.95M}
};
return View(array);
}
然后创建对应的视图文件DemoArray.cshtml
@model Razor.Models.Product[]
@{
ViewBag.Title = "DemoArray";
}
@if (Model.Length > 0)
{
<table>
<thead><tr><th>Product</th><th>Price</th></tr></thead>
<tbody>
@foreach(Razor.Models.Product p in Model){
<tr>
<td>@p.Name</td>
<td>$@p.Price</td>
</tr>
}
</tbody>
</table>
}
导航到对应的URL地址：/Home/DemoArray ，效果图如下：
4.5 处理命名空间
此例在最好的foreach 循环中使用了全限定名的Product 类：
...
@foreach(Razor.Models.Product p in Model)
...
可以对一个视图运用@using 表达式，以引入命名空间：
@using Razor.Models;
@model Product[] @{
ViewBag.Title = "DemoArray";
}
@if (Model.Length > 0)
{
<table>
<thead><tr><th>Product</th><th>Price</th></tr></thead>
<tbody>
@foreach(Product p in Model){
<tr>
<td>@p.Name</td>
<td>$@p.Price</td>
</tr>
}
</tbody>
</table>
}