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>类型的参数,其中"?"可以替换成任何你需要的类型。
本例完整代码如下:
@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());
}
}
<!DOCTYPE html>
<html>
<head>
<title>Repeat Helper Demo</title>
</head>
<body>
<p>Repeat Helper</p>
<ul>
@Repeat(10, @<li>List Item #@item</li>);
</ul>
</body>
</html>
<%= Repeat(10, item => new HelperResult(writer => writer.Write("Foo"))); %>
查看原文,点击此处。
注:如果发现有翻译不恰当或者疏漏的地方请反馈给我,我会及时更正,谢谢!