[一步一步MVC]第四回:漫谈ActionLink,有时“胡搅蛮缠”
anytao.net | 《你必须知道的.NET》网站 | Anytao技术博客
发布日期:2009.04.30 作者:Anytao
© 2009 Anytao.com ,Anytao原创作品,转贴请注明作者和出处。
MVC时代来临了,但是一开始是不被很多人接受的。可能的主要原因是,大家不得不告别拖拉控件的至爽感受,回到貌似asp的历史岁月。所以,心有不甘是可以理解的,然而时代显然是进步的。我们虽然必须在View中进行很多HTML代码的工作,但是MVC为我们提供了可以堪称完美的方案(至少我是这样认为的),那就是HtmlHelper。在MVC的View层,我们有很多熟悉的面孔,例如Html.Encode、Html.AntiForgeryToken、Html.BeginForm、Html.TextBox等,而其中ActionLink算是其中的“猛将兄”。
浅议HtmlHelper
简单的说,HtmlHelper就是一个封装了ViewContext、IViewDataContainer、RouteCollection等上下文信息的一箩筐静态方法类(注,HtmlHelper本身并不是静态类),其中包含了我们上文介绍的熟悉身影Encode、AntiForgeryToken等,但不包含BeginForm、TextBox,当然也不包括ActionLink,其原因是BeginForm、TextBox、ActionLink其实是HtmlHelper的扩展方法,我们可以从智能感知提示中最直观的得到了解:
显然,ActionLink和Encode的智能提示标记是有区别的。
所以,HtmlHelper其实很简单,而通过Extension Methods对其的“功能注入”机制实现了极大的扩展空间。而且,HtmlHelper封装了ViewContext、RouteCollection等上下文信息,为实现扩展带来便利。所以,顺便提一下,这也正是老赵同志在为视图自定义辅助方法(上)中实现JQueryHelper时引入相应元素(ViewContext、RouteCollection、ViewPage),有着异曲同工之妙,所以HtmlHelper并不是唯一的选择,高兴的话,你也可以类似于AnytaoHelper之类的东东。
所以,通过HtmlHelper就可在运行时动态生成HTML代码,其实我们在WebForm时代就经常玩儿这种“阴招”,然而在HtmlHelper这里,显然已经发扬光大了。例如老赵的JQueryHelper就通过一系列的包装,省去了对validation的麻烦语法。
同时,扩展HtmlHelper其实及其简单。例如:
// Release : code01, 2009/04/30 // Author : Anytao, http://www.anytao.com public static string Label(this HtmlHelper helper, string name, string value) { return string.Format("<label for='{0}'>{1}</label><br />", name, value); }
通过下面的方式就可以调用该方法了:
<%= Html.Label("name", "Tao") %>
同样的道理,当我们摊开ActionLink的实现具体实现时,可见:
public static string ActionLink(this AjaxHelper ajaxHelper, string linkText, string actionName, string controllerName, RouteValueDictionary routeValues, AjaxOptions ajaxOptions, IDictionary<string, object> htmlAttributes) { if (String.IsNullOrEmpty(linkText)) { throw new ArgumentException(MvcResources.Common_NullOrEmpty, "linkText"); } string targetUrl = UrlHelper.GenerateUrl(null, actionName, controllerName, routeValues, ajaxHelper.RouteCollection, ajaxHelper.ViewContext.RequestContext, true /* includeImplicitMvcValues */); return GenerateLink(linkText, targetUrl, GetAjaxOptions(ajaxOptions), htmlAttributes); }
有时“胡搅蛮缠”
聊了半天HtmlHelper,该说说ActionLink了。正如前文而言,ActionLink仅仅是HtmlHelper的扩展方法而已。不过,虽然ActionLink平易近人,但是还是在不经意间发现其胡搅蛮缠的地方。我们先按下不表来看看如何使用ActionLinks,MVC Framework为我们提供了两种方式:
- ActionLink
- ActionLink<TController>
显而易见,一种是非泛型方法,通过参数方式调用,没有强类型优势;另一种是泛型方法,可以通过强类型调用,不过如果通过ActionName对Action进行重写标记时,泛型ActionLink<TController>是不可用的,我在《还是ActionFilter,实现对业务逻辑的统一Authorize处理》已进行过讨论了。
<%=Html.ActionLink("Edit", "Edit", "Book", new { id = Model.ID }, new { @class = "BookDetail"})%>
具体而言,上述参数主要包括:
- Edit,为linkText,具体而言就是显示的字符串;
- Edit,对应为ActionName;
- Book,为Controller;
- new { id = Model.ID },为生成元素的id定义;
- new { @class = “BookDetail” },则为元素添加了tag要素。
具体的执行逻辑不是我们关心的问题,而上述代码生成的Source Code,则对应为:
<a class="BookDetail" href="/Book/Edit/1">Edit</a>
而如果应用泛型ActionLink,则上述调用将变成:
<%= Html.ActionLink<BookController>(c => c.Detail(), "Edit") %>
生成同样的Source Code,不过通常情况下,我们还是推荐泛型ActionLink,至少有类型安全、代码优雅的优点。
注:既然是ActionLink,文如其名,我们不能将其滥用,也就是说涉及Action的Links时可以考虑用ActionLink,其他情况下最好还是手写自己的链接代码或者扩展自己的HtmlHelper等。
然而,在有些情况下,假设我们有如下Route:
// Release : code02, 2009/04/30 // Author : Anytao, http://www.anytao.com routes.MapRoute( "BookRoute", "Tao/Book/id", new { controller = "Book", action = "Detail", id = "" } );
当我们使用
<%= Html.ActionLink("Book", "Detail", "Book", null, null) %>
调用BookController下的Detail Action,不过令我们奇怪的是,生成Html代码并不如期望的那样,而是:
<a href="/Tao/Book/id">Book</a>
显然,ActionLink有点儿“胡搅蛮缠”了。其原因在于,新定义的BookRoute改写了ActionLink的“既有”行为,本来我们期望的是:
<a href="/Book/Detail/id">Book</a>
为了追查原因,我们将对ActionLink进行了必要的调查,首先了解ActionLink的定义:
public static string ActionLink(this HtmlHelper htmlHelper, string linkText, string actionName)
而ActionLink的具体实现中,我们看到了routeCollection的GetVirtualPath方法中涉及了对">">Dictionary<string, RouteBase>的操作,所以不言而喻,ActionLink生成的Url是受routeCollection影响的。对于其“胡搅蛮缠”,我相信这就是原因吧。
所以,虽是一个小小的意外,但是了解了就不是意外。对于我们的应用而言,有两点值得注意:
- 注意Route定义对于ActionLink可能造成的影响。
- 在这种情况下,我们可以考虑放弃ActionLink,而通过全手动方式实现:
<a href="Book/Detail/<%= Model.ID %>">Book</a>
不偿为一种回归原始的方式,不是吗?
本文调侃了题目,但是更重要的事情是我们对HtmlHelper及ActionLink有了个大致的了解,对于更好的应用是有好处的。那么,今天就说到这里。
代码下载,这里。更多关注,尽在anytao.net/blog
2009/04/30 | http://anytao.cnblogs.com/ | http://anytao.net/blog/post/2009/04/29/anytao-mvc-07-actionlinktalk.aspx
本文以“现状”提供且没有任何担保,同时也没有授予任何权利。 | This posting is provided "AS IS" with no warranties, and confers no rights.
本文版权归作者所有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
Worktile,新一代简单好用、体验极致的团队协同、项目管理工具,让你和你的团队随时随地一起工作。完全免费,现在就去了解一下吧。
https://worktile.com