razor自定义函数 @helper 和@functions小结

from:http://www.cnblogs.com/jiagoushi/p/3904995.html

asp.net Razor 视图具有.cshtml后缀，可以轻松的实现c#代码和html标签的切换，大大提升了我们的开发效率。但是Razor语法还是有一些棉花糖值得我们了解一下，可以更加强劲的提升我们的开发效率，减少开发bug的出现。

Razor 采用的是@ 尾巴符号，正是这个符号成就了Mvc开发效率的提升。下面了解一下和@相关的两个可以重用的helper、functions。

作为现代化的程序员，我们尽可能的遵守一个原则.不要重复你自己。所以能够重构的代码我们都会合并，但是这是对于后台代码C#来说的，对于在View层 也可以进行一些简单的业务逻辑，当然View层可以进行复杂的业务逻辑判断，但是前辈说复杂的业务逻辑是Model或Controller的工作，View层的任务就是展示，业务逻辑应当是越少越好。

在View层进行的一些重构有哪些呢？其中一个就是@helper  自定义片段。

比如说我们要输出一个数字，如果为0的话就输出不存在，如果为其他数字就输出存在，当然这个在强大的Razor语法下很容易的就可以搞定。

1 @(ViewBag.IsEnabled == "0" ? "不存在" : "存在")

但是如果当前页面有很多这样的相同逻辑的判断会怎么样呢？聪明的程序员肯定知道不能重复你自己的原则，所以我们就要进行重构，但是在View层怎么进行重构呢？使用@helper可以解决这个问题。

 1 @helper Show(int count)
 2 {
 3     if (count == 0)
 4     {
 5         @:存在
 6     }
 7     else
 8     {
 9         @:不存在
10     }
11 }
12
13 @(ViewBag.IsEnabled == 0 ? "不存在" : "存在")
14 @Show(0)    @*调用helper*@

这样我们在当前页面多个位置进行调用来输出，如果要修改可以修改一部分，而不至于全部都要修改。

还有就要说了，我要在其他页面也使用这个helper怎么办呢？当然办法还是有的，在app_code文件夹下添加一个视图文件(假定为UIHelper.cshtml)，将helper代码复制，然后在需要调用的View页面通过@UIHelper.Show(0)  来调用。因为app_code文件夹下的文件最终会被编译成类。

总结：我们总结一下要实现根据不同情况进行输出有多少种实现方式，当然我能想到的不会完全。

1. 通过helper进行全局的设置，让所有需要判断的页面都调用这个helper方法。
2. 在后台代码判断，然后输出到前台View。
3. 通过Html.Action()或Html.Partial()来获取，当然如果简单的还是采用helper，复杂的可以采用这种方式。
4. 通过自定义函数Functions来实现。

自定义函数@functions  ,自定义函数式采用c#的语法来实现的代码复用，只不过这个函数可以将html标签输出到页面。

 1 //自定义函数@functions
 2 @functions{
 3     public IHtmlString Get(int count)
 4     {
 5         string result = "";
 6         if (count == 0)
 7         {
 8             result = "不存在";
 9         }
10         else
11         {
12             result = "存在";
13         }
14         return new HtmlString(result);
15     }
16 }
17
18
19 @Get(0)   //调用的自定义函数

请注意，@functions 对应的是Razor的代码段，需要添加{},并且functions内部是正规的c#方法。

如果要在多个页面同时使用这个functions，可以将这个方法移植到app_code中，假定文件名为UIHelper.cshtml。并且里面的方法必须定义为静态的。这个很好理解，UIHelper相当于类名，而其中的functions就相当于方法，如果要通过类名.方法名来进行调用，则必须将方法定义成静态的。

UIHelper.cshtml文件代码

 1 @helper ShowUnit(int count)
 2 {
 3     if (count == 0)
 4     {
 5         @:免费
 6         }
 7     else
 8     {
 9         @count
10     }
11 }
12
13 @functions {
14     public static IHtmlString Check(int count)
15     {
16         string result = "";
17         if (count == 0)
18         {
19             result = "fsdfsdfsdfd";
20         }
21         else
22         {
23             result = count.ToString();
24         }
25         return new HtmlString(result);
26     }
27 }
28 //自定义函数@functions
29 @functions{
30     public static IHtmlString Get(int count)
31     {
32         string result = "";
33         if (count == 0)
34         {
35             result = "不存在";
36         }
37         else
38         {
39             result = "存在";
40         }
41         return new HtmlString(result);
42     }
43 }

总结：helper针对的是直接输出html内容并且具有简单的逻辑的情况，并且helper没有任何返回值，而functions自定义函数则要强大很多，如果functions需要返回html内容，那么返回值是IHtmlString类型，如果不需要返回值，则可以设置为void，但是如果没有返回值也就失去了定义function的意义，所以一般返回值均为IHtmlString。对于View层的重构，我们可以采用helper和自定义函数functions的方式来实现。