[译]Razor内幕之模板

Razor中的内联模板特性并没有被广泛讨论，但是它提供了将内联模板作为方法参数的能力。现在只有asp.net页面中的Grid helper使用了内联模板，也并没有很多关于如何创建自己的模板帮助类的文档，但是本文会对其进行一定的探讨。

首先，我们来看一下当使用内联模板的时候生成了什么代码。下面通过一个 "Repeat"的模板帮助类来说明，这个帮助类的功能是按照指定的次数重复输出模板内容。使用这个帮助类的页面内容如下：

<!DOCTYPE html>

<html>

<head>

<title>Repeat Helper Demo</title>

</head>

<body>

<p>Repeat Helper</p>

<ul>

@Repeat(10, @<li>List Item</li>);

</ul>

</body>

</html>

当运行它的时候，我们会看到以下页面：

接下来我们看看"Repeat"的实现。本例中将代码写在了页面中，但是你可以将它写到App_Code中的静态类中，然后引用它。在Razor中"@functions"块能够将你写的代码注入到生成的类文件中。

@using System.Text;

@functions {

public static IHtmlString Repeat(int times, Func<int, object> template) {

StringBuilder builder = new StringBuilder();

for(int i = 0; i < times; i++) {

builder.Append(template(i));

}

return new HtmlString(builder.ToString());

}

不难发现，传入的模板被认为是Func<int, object>类型的，当我们调用它的时候，得到的是运行模板的结果。需要注意的是builder.Append(template(i)); 这行代码中，我们向模板函数传递了一个参数。让我们看看调用Repeat的时候生成的C#代码：

this.Write(Repeat(10,item => new Microsoft.WebPages.Helpers.HelperResult(__writer => {

@__writer.Write(" ");

@__writer.Write("<li>List Item</li>");

})));

看起来有些复杂，但是本质上所做的工作就是生成了一个接受单个"item"参数的lambda表达式，"item"参数的类型是由传给它的方法决定的。当lambda执行的时候，构建并返回一个HelperResult。 HelperResult是asp.net web框架定义的一个类，它封装了向TextWriter写文本的托管代码，通过这样的封装，只要对象重写了ToString方法来返回执行模板的结果，我们就能够像处理字符串一样处理它。（实际上的逻辑是先看对象是不是HelperResult，如果是那么就直接调用内部托管，如果不是那么调用对象的ToString方法）。

本例中"item"参数的使用方式和Grid helper中先向模板传递当前数据项然后使用它的方式相似。Repeat helper将迭代数作为参数传递进去，然后我们就可以在模板中通过"@item"来访问它。例如：

@Repeat(10, @<li>List Item #@item</li>);

会输出：

总之，如果你要在自己的帮助方法中使用Razor模板，那么就增加一个Func<?, object>类型的参数，其中"?"可以替换成任何你需要的类型。

本例完整代码如下：