[译]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>  

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

[译]Razor内幕之模板

接下来我们看看"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内幕之模板

总之,如果你要在自己的帮助方法中使用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"))); %>

查看原文,点击此处

注:如果发现有翻译不恰当或者疏漏的地方请反馈给我,我会及时更正,谢谢!

你可能感兴趣的:(模板)