【Razor语法规则小手册....】

在经过长达半年的Windows开发后，Razor的一些语法有些生疏了。搜集些，再熟悉下。呵呵，甚是怀念以前做web 项目的时候，基于动软代码生成器自定义T4模板，后来vs2010后开始支持T4模板。

又是一顿.tt文件。最后动软也升级了T4模板。然后就呵呵呵了。但是vs2010出现 Razor引擎！！又是一套模板引擎.............更新迭代速度越来越快......

ASP.NET mvc 1-2 的View引擎就是基于T4模板引擎，标记为 ：<##>

（动软代码生成器确实是T4引擎，不是做广告的 呵呵）

T4模板引擎：

Microsoft.VisualStudio.TextTemplating

核心：Microsoft.VisualStudio.TextTemplating.dll

四、分离T4引擎

在前几篇文章中，我使用大量的篇幅来介绍T4在VisualStudio中如何使用。虽然在一定程度上可以提高我们的工作效率，但并没有实质上的改变。不过从另一方面来说，我们确实了解到了T4的强大。如何让这个强大的工具为我们所用呢？本章将讲解如何在自己的程序中使用T4。在原来的解决方案中新建一个窗体项目T4Generator。T4引擎被封装在了：

Microsoft.VisualStudio.TextTemplating.10.0.dll

Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll

..............

地址：/article/5333757.html
http://www.cnblogs.com/hanzhaoxin/p/3790165.html
Razor模板引擎：cshtml 或者vbhtml

工具介绍：理解模板引擎Razor 的原理

/article/4685840.html

自己以前使用的基于Razor的验证C#代码工具 RazorPad---基于MVC3



下载地址：http://pan.baidu.com/s/1eRxdt9S

【来源与网络】

1.开发工具

　　Razor是MVC3中的一个视图模板引擎，所以，我们只需要在VS2010中安装一个MVC3的工具，就可以使用Razor了。

　　如果你不想使用MVC3，还有另外一种选择，那便是WebMatrix + VS 2010；WebMatrix提供了Razor模板的网站，但它并不是一个优秀的IDE，没有像VS一样的智能感知和编辑时错误提醒功能。所以，在使用WebMatrix创建了Razor引擎的网站后，可以在VS2010中打开进行编辑。本文示例所使用的就是这种方式。

　　2.Razor的文件类型

　　Razor支持两种文件类型，分别是.cshtml 和.vbhtml，其中.cshtml 的服务器代码使用了c#的语法，.vbhtml 的服务器代码使用了vb.net的语法。

　　由此也可以看出，Razor其实是一种服务器代码和HTML代码混写的代码模板，类似于没有后置代码的.aspx文件。

　　3.Razor语法之@符号

　　@字符是Razor中的一个重要符号，它被定义为Razor服务器代码块的开始符号。如果我们希望在网页中输出一个变量，或者当前日期，我们可以使用如下代码：

@{string productName = "台灯";}
<span>@productName</span>
<span>@DateTime.Now.ToString("yyyy-MM-hh")</span>

　　当你在完成这段代码的时候，你会发现VS 2010为我们提供了代码着色和智能感知：



运行这段代码，让我们看看浏览器的显示内容：



有这个示例可以看出，@符号标记了一个HTML代码的输出，在其后的变量、方法返回值和表达式运算结果会进行输出。

　　4.Razor语法之代码块定义

　　你可以使用@{code}来定义一段代码块。

@{
int num1 =10;
int num2 =5;

int sum = num1 + num2;
@sum;
}

　　在代码块中，我们编写代码的方式和通常服务器端代码的方式是一样的。另外，如果需要输出，例如上面的在页面中输出结果，我们可以使用@sum完成输出

　　另外，@(code)可以输出一个表达式的运算结果，上面的代码我们也可以写成这样：

@{
int num1 =10;
int num2 =5;

int sum = num1 + num2;
@(num1 +num2);
}

　　

　　5.Razor语法之代码混写

　　Razor支持代码混写。在代码块中插入HTML、在HTML中插入Razor语句都是可以的。

@{
int num1 =10;
int num2 =5;

int sum = num1 + num2;
string color ="Red";
<font color="@color">@sum</font>
}

　　值得称赞的是，即使我们这样混写，也不影响VS2010的智能感知功能。

输出@符号：@@

输出Email地址：Razor模板会自动识别出Email地址，所以不需要我们进行任何的转换。而在代码块中，只需要使用 @:Tom@gmail.com 即可。@:表示后面的内容为文本。

输出HTML代码（包含标签）：直接输出，string html = "<font color='red'>文本</font>"; @html

输出HTML内容（不包含标签）：有两种方法，第一种：IHtmlString html=new HtmlString("<font color='red'>文本</font>"); @html; 第二种：string html = "<font color='red'>文本</font>"; @Html.Raw(html);

　　6.Razor语法之注释

　　这里所说的注释是指服务器端的注释，在Razor代码块中，可以使用C#的注释方式来进行注释，分别是//:（单行注释）和/**/（多行注释）。

　　另外，Razor还提供了一种新的服务器段代码注释，可以即注释C#代码，同时可以注释HTML代码，@**@，这种注释方式不受代码块的限制，在Razor代码中的任何位置都额可以。

@*
这是一个注释
<b>这个是注释</b>
*@

7.Razor布局

ASP.NET MVC3中新增的 Razor 视图引擎有很多的优势，关于使用 Razor 的优势从前几篇的文章中也能看出一些，我们的 Android 博客项目就采用了 Razor。本篇将简单的介绍下 MVC3 中 Razor 视图引擎中页面布局。

使用 Razor 视图引擎，我们会发现不同于 .ASPX 视图，它没有使用母板页。下边我们看看 Razor 布局技术，首先看看我们项目中的公共视图，如下：



可见，我们分别定义了页面的页头、页脚等，Razor 中布局是非常简单的，类似我们以前使用的include加载方法。首先，我们看看"_layout.cshtml"中的代码，它类似于"ASPX"视图引擎中的母版页，如下：



第4行中，使用了ViewBag.Title，这样我们可以在各视图页指定各页面标题的名称，同理第8行指定body 的 id。如在Home页中：



第10行、21行使用了HtmlHelper.Partial()方法，分别将页头和页脚的局部视图加载进来，也没有太多可说的。16行中RenderBody()将各视图页的主体部分全部加载了进来，这样我们在"_layout.cshtml"页中完成了我们页面的布局，达到了复用的目的。最后在"_ViewStart.cshtml"中指定 Layout为我们定义的"_layout.cshtml"页，当然，我们还可以在"_ViewStart.cshtml"中根据需要加载不同的布局。

以上这些是 Razor 中基本的布局方法，很明显，如果复用的部分并不是静态的内容，想想我们在WebForm中使用的自定义控件。那么我们怎样在 Razor 视图中实现自定义控件一样的效果呢？在第18行中我们就实现了这个目的，下边就让我们看看，首先，我们在项目中添加了 App_Code 文件夹，并添加了名为“Latest.cshtml”的文件，如下：



接下来，我们使用helper类来定义了一个名为“Lastest()”的方法(方法名没取好)，用来显示我们最近发表的文章，我这里并没有具体的实现，而是取出了所有的文章，下图为方法定义：



最后，我们在需要显示的页面中调用这个方法即可。所以我在"_Layout.cshtml"页中调用了这个方法，如第18行。

好了，本篇关于 ASP.NET MVC3 中 Razor 布局的简单介绍就到这里，希望对学习 ASP.NET MVC3 的朋友能带来一些帮助。到此我们已经了解了 ASP.NET MVC3 三层结构以及数据的查询与显示、Razor 部局等，下一篇我们会看看 ASP.NET MVC3中的添加、修改和删除操作。

--------------------------------------------------

博客园

闪存

首页

新随笔

联系

管理

订阅



随笔- 20 文章- 0 评论- 25

ScottGu:Razor视图引擎中的两个有用的语法功能：@:和<text>语法

Razor尽量减少编写一个视图模板需要敲入的字符数，实现快速流畅的编程工作流。与大部分模板的语法不同，你不必在HTML中为了明确地标记出服务模块的开始和结束而中断编程。Razor解析器足够聪明，能从你的代码中推断出来。这使其简洁，富有表现力的语法输入干净，快速，有趣。

使用标记来识别代码中的内容块——是使Razor在涉及HTML生成的情况下简洁高效的一个重要因素。

用@明确表示内容的起始

然而不是所有的内容块都是以标记元开始，在有些案例中，Razor解析器不能隐式检测出内容块。

这就需要Razor通过在代码块中使用“@：字符序列”来显式指明内容块的开始。@：序列表明该行后面的内容应该被视为内容块：



在@：内容块中使用代码碎块(Code Nugget)





另外 ，Razor允许你用一个<text>元素 来显式标识内容：



<text>标签是一个 Razor 特殊处理的元素。Razor将<text>块的内部内容视为内容块，不呈现包含那些内容的<text>标签（这意味着只呈现<text>内部内容，不呈现标签本身）。这使呈现没有被HTML元素包装的多行内容块变得方便。

如果你想要更简洁的@: 序列，<text>元素也能根据需要用来标识单行内容.

总结

Razor启用一种简洁的模式化语法，实现非常流畅的编码工作流。 Razor能灵活地通过检测<tag>元素来识别内容块的起始， 从而让Razor方法在有HTML生成的场景中很有效，也使你不用明显地标注95% 的 if/else 和foreach 场景中内容块的开始/结束.

在当你不想在一个代码容器块中使用HTML元素，却需要更精确地标明一个内容块的边界时，你可以使用Razor的@:和<text>句法。

-------------------------------------

1 常用 Html 标签

1.1 Label

[b]Html 语法 [/b]：<label for="UserName">用户名</label>

Razor语法：@Html.LabelFor(m => m.UserName)

1.2 <input type="text" />

[b]Html 语法 [/b]：

Razor语法： 

1.3 <input type="hidden" />

[b]Html 语法 [/b]：

Razor语法： 

1.4 <input type="password" />标签

[b]Html 语法 [/b]：

Razor语法： 

1.5 <input type="radio" />标签

[b]Html 语法 [/b]：

Razor语法： 

1.6 <input type="checkbox" />标签

[b]Html 语法 [/b]：

Razor语法： 

2 链接地址

@Url.Content()

@Url.Action

2.1 引用CSS样式文件

[b]Html 语法 [/b]：

Razor语法： 

2.2 引用Javascript文件

[b]Html 语法 [/b]：

Razor语法： 

2.3 Image引用图片文件

[b]Html 语法 [/b]：

Razor语法： 

2.4 超链接

[b]Html 语法 [/b]：

Razor语法： 

3 表单

3.1 正常提交表单

@using( Html .BeginForm()){


}

3.2 Ajax提交表单

@using (Ajax.BeginForm(new AjaxOptions { UpdateTargetId="txtResult" })) { <input type="submit" value="Button"/> <span id="txtResult"/> }

----------------------------------------------------------

Razor文件类型

Razor可以在vb.net和C#中使用。分别对应了两种文件类型，.vbhtml和.cshtml

Razor的标识符

@字符被定义为Razor服务器代码块的标识符，后面的表示是服务器代码了。web form中使用<%%>中写服务器代码一个道理。在vs工具里面提供了代码着色和智能感应的功能。如下面代码：

@{string userName= "邓星林";}
<span>@userName</span>
<span>@DateTime.Now.ToString("yyyy-MM-hh")</span>

Razor的作用域

在上面一个例子中都已经使用到了大括号{}，不错，大括号里面的就是表示作用域的范围，用形如@{code}来写一段代码块。

@{
string userName= "邓星林";
@userName
}

在作用域(代码块)中输出也是用@符号的。

用Razor和html代码混合编写

在Razor中写html代码和html代码中写Razor语句都是可以的，并且还有智能提示。

a.在作用域内如果是以html标签开始则视为文本输出

b.如果要输出@，则使用@@

c.如果要输出非html标签和非Razor语句的代码，则用@:，他的作用是相当于在处于html下面编写一样了，如在@：后面可以加上@就是表示Razor语句的变量

如：

@{

var str = "abc";
////下面会输出：this is a mail：dxl0321@qq.com, this is var: abc,this is mail@str,this is @；
@: this is a mail：dxl0321@qq.com, this is var: @str,this is  mail@str,this is @@；
//下面输出abc
@str

}

Razor作用块注释

razor作用块里面本身就是服务器代码了，因此可使用服务器代码的注释，注释有//和/**/分别是单行注释和多行注释。

另外razor注释还可以使用自身特有的@* 注释的内容 *@，支持单行和多行的。

@{
@*
多行注释
多行注释
*@
var i = 10;  @* asdfasf *@
}

Razor类型转换

As系列扩展方法和Is系列扩展方法

AsInt(), IsInt()

　 　AsBool(),IsBool()

　　AsFloat(),IsFloat()

　 　AsDecimal(),IsDecimal()

　 　AsDateTime(),IsDateTime()

　 　ToString()

@{
var i = “10”;
}
<p> i = @i.AsInt() </p> <!-- 输出 i = 10 -->

razor其它

@Href("~/")//表示网站的根目录

@Html.Raw(Module.Content) 输出HTML，如：@Html.Raw('<font color='red'>红字</font>')，就会显示出红色的”红字“，不用的话会直接显示这段html字符串（<font color='red'>红色文字</font>）

在实际中，比如一个网站，整过框架是一样的，而有的地方是很多相同的版块。因此我们需要复用。

布局（Layout）

layout方式布局就是相当于一个模板一样的，我们在它地址地方去添加代码。相当于定义好了框架，作为一个母版页的，在它下面的页面需要修改不同代码的地方使用@RenderBody()方法

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8"/>
<title>我的网站 - @Page.Title</title>
</head>
<body>
@RenderBody()
</body>
</html>

@{
Layout = "/LayoutPage.cshtml";
Page.Title = "测试页面哦";
}

<p>This is a layout test</p>

页面（Page）

page是当需要在一个页面中，输出另外一个razor文件的内容时候用到，比如头部或者尾部这些公共的内容时候需要用到。输出就使用 @RenderPage()方法

如：A页面中也要把B页面的内容输出

A页面：

<p>
@RenderPage("/b.cshtml")
</p>

b页面的代码如下：

<font color="red">这是一个子页面</font>

Section区域

Section是定义在Layou的中使用的。在Layout的页面中用。在要Layout的父页面中使用@RenderSection("Section名称 ")

定义：

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8"/>
<title>我的网站 - @Page.Title</title>
</head>
<body>
@RenderSection("SubMenu")
@RenderBody()
</body>
</html>

在它的子页面中使用

@section SubMenu{
Hello This is a section implement in About View.
}

如果在子页面中没有去实现了SubMenu了，则会抛出异常。我们可以它的重载@RenderSection("SubMenu", false)

@if (IsSectionDefined("SubMenu"))
{
@RenderSection("SubMenu", false)
}
else
{
<p>SubMenu Section is not defined!</p>
}

Helper

helper就是可以定义可重复使用的帮助器方法，不仅可以在同一个页面不同地方使用，还可以在不同的页面使用。

如在cshtml中那么写：

@helper sum(int a,int b)
{
var result=a+b; 　　@result

}
<div >
<p>@@helper的语法</p>    <p>2+3=@sum(2,3)</p>      <p>5+9=@sum(5,9)</p> </div>

我们通常会把一类Helper放在一个单独的cshtml文件中，而文件名就相当于一个类名。

我把sum放在HelpMath.cshtml文件中，则我们在那上面cshtml中的使用方法是:

<p>2+3=@HelpMath.sum(2,3)</p>
<p>5+9=@HelpMath.sum(5,9)</p>

另外，系统还为我们提供了一些列的Helper，用来简化Html的书写。这些Helper放在@Html中，我们可以方便的使用：

<p>
@Html.TextBox("txtName")
</p>