首页 > 代码库 > mvc HtmlHelper

mvc HtmlHelper

许多时候我们会遇到如下场景

在写一个编辑数据的页面时,我们通常会写如下代码

   1: <input type="text" value=http://www.mamicode.com/‘<%=ViewData["title"] %>‘ name="title" />

由前篇我们所讲的Helper演化,我们思考,对于这种代码我们是不是也可以用一个Helper来自动绑定数据呢

这当然是可以的,ASP.NET MVC提供了一个HtmlHelper用于生成有数据绑定的Html标签。

 

1.ActionLink

其中最常用的就是Html.ActionLink

1.1基本的使用方式

   1: <%=Html.ActionLink("这是一个连接", "Index", "Home")%>

在UrlRouting规则为默认规则的情况下,它生成的HTML代码为

   1: <a href="http://www.mamicode.com/">这是一个连接</a>

ActionLink中的三个参数分别为

  1. 显示的文字
  2. Action
  3. Controller

其中Controller可以省略,省略时指向同一Controller下的Action。

1.2ActionLink中QueryString与Html属性设置

   1: 带有QueryString的写法
   2: <%=Html.ActionLink("这是一个连接", "Index", "Home", new { page=1 },null)%>
   3: <%=Html.ActionLink("这是一个连接", "Index", new { page=1 })%>
   4: 有其它Html属性的写法
   5: <%=Html.ActionLink("这是一个连接", "Index", "Home", new { id="link1" })%>
   6: <%=Html.ActionLink("这是一个连接", "Index",null, new { id="link1" })%>
   7: QueryString与Html属性同时存在
   8: <%=Html.ActionLink("这是一个连接", "Index", "Home", new { page = 1 }, new { id = "link1" })%>
   9: <%=Html.ActionLink("这是一个连接", "Index" , new { page = 1 }, new { id = "link1" })%>

其生成结果为:

   1: 带有QueryString的写法
   2: <a href="http://www.mamicode.com/?page=1">这是一个连接</a>
   3: <a href="http://www.mamicode.com/?page=1">这是一个连接</a>
   4: 有其它Html属性的写法
   5: <a href="http://www.mamicode.com/?Length=4" id="link1">这是一个连接</a>
   6: <a href="http://www.mamicode.com/" id="link1">这是一个连接</a>
   7: QueryString与Html属性同时存在
   8: <a href="http://www.mamicode.com/?page=1" id="link1">这是一个连接</a>
   9: <a href="http://www.mamicode.com/?page=1" id="link1">这是一个连接</a>

这样就可以使用ActionLink生成近乎所有的地址连接了。

注意,如果连接中不涉及到action及controller就没有必要使用ActionLink,而是直接写HTML代码就可以了,例如

   1: <a href="http://www.mamicode.com/#1">一章</a>
   2: <a href="javascript:void(0)" onclick="delete();">删除</a>

2.RouteLink

2.1与ActionLink

RouteLink与ActionLink相差无几,只是它的地址是由Route生成拿上面的例子

   1: <%=Html.ActionLink("这是一个连接", "Index", "Home")%>

来说,如果用RouteLink来写就是

   1: <%=Html.RouteLink("这是一个连接", new { controller="Home",action="Index"})%>

 

而带上QueryString以及Html属性的ActionLink

   1: <%=Html.ActionLink("这是一个连接", "Index" , new { page = 1 }, new { id = "link1" })%>

就可以这样来写

   1: <%=Html.RouteLink("这是一个连接", new { action = "index", page = 1 }, new { id="link1"})%>

 

其实就是用一个新建立的RouteValueDictionary的对象(new{}所实例化的对象将会等价转换为RouteValueDictionary)来替原来的Action,Controller字符串的单独指定。

2.2RouteLink使用Route规则

除了这些协同的用法,RouteLink还支持使用Route规则名来创建连接

例如我们在Global.asax文件中添加一个Route规则

   1: routes.MapRoute(
   2:     "about",//这是规则名
   3:     "about",//url
   4:     new {controller = "Home", action = "about"}
   5:     );

那么我们就可以使用这个Route规则

   1: <%=Html.RouteLink("关于", "about", new { })%>
   2: <%=Html.RouteLink("关于", "about", new { page = 1 })%>
   3: <%=Html.RouteLink("关于", "about", new { page = 1 }, new { id = "link1" })%>

来生成如下的HTML:

   1: <a href="http://www.mamicode.com/about">关于</a>
   2: <a href="http://www.mamicode.com/about?page=1">关于</a>
   3: <a href="http://www.mamicode.com/about?page=1" id="link1">关于</a>

 

3.表单

很多情况下是要生成表单元素的,正如文章开始所述,修改一个内容的情况下,我们可能要将数据与表单绑定。

3.1生成Form

我们当然可以使用纯的Html代码或UrlHelper来生成一个Form。

   1: <form action="/home/index" method="post">
   2: </form>
   1: <form action="<%=Url.Action("Index","Home")%>" method="post">
   2: </form>

但是因为是在HTML的属性中,所以还是难以维护,幸好ASP.NET MVC为我们提供了一个Helper,我们可以通过以下两种方式生成一个Form:

   1: <%using(Html.BeginForm("index","home",FormMethod.Post)){%>
   2: 表单内容
   3: <%} %>
   4: <%Html.BeginForm("index", "home", FormMethod.Post);//注意这里没有=输出%>
   5: 表单内容
   6: <%Html.EndForm(); %>

BeginForm方法类似于ActionLink的调用方式,所以ASP.NET MVC还提供了BeginRouteForm这种方法。

当然这里我们也可以使用new{}来为form的action增加querystring或HTML属性,方法与前面介绍的大同小异,参见方法列表即可。

 

3.2表单元素

ASP.NET MVC提供了多种表单元素的Helper。

其中包括:TextBox(类似input type=text,下面类似)、TextArea、DropDownList(select)、CheckBoxHidden、ListBox、Password、RadionButton。

注意:因为<input type=”submit” />一般情况下是不会绑定数据的所以ASP.NET MVC并未提供此Helper(曾经提供过在preview2之前)。

如果我们想提供一个input type=text 它的name为t1则以下代码:

   1: <%=Html.TextBox("t1") %>

3.3表单元素绑定

如果我们想要让上文中的t1初始时就有一个值,比如 “重典”那么我们可以按以下方式

   1: <%=Html.TextBox("t1","重典") %>

如果数据是从数据库中读取,即得到数据是从Action中获取的,那么我们可以在Action中使用ViewData传递

Action:

   1: ViewData["name"]="重典";

View:

   1: <%=Html.TextBox("t1",ViewData["name"]) %>

 

以上方法看似简单,其实ASP.NET MVC为我们提供了更为简便的绑定方式---只要保证ViewData的Key与Helper所生成元素的name保持一致就可以自动绑定:

Action:

   1: ViewData["t1"]="重典";

View:

   1: <%=Html.TextBox("t1") %>

 

 

这样就可以自动绑定了

3.4列表数据显示与绑定

像TextBox这种值单一的数据比较容易,但是存在的数据比较多的DropDownList或ListBox应该怎么绑定数据及初始化值呢,我们来看看下面的例子:

Action:

   1: ViewData["sel1"] = new SelectList(
   2:     new[] {1, 2, 3} /*列表内容可以是数组*/
   3:     , 3 /*默认值,可以是从数据库读出的*/
   4:     );

View:

   1: <%=Html.DropDownList("sel1")%>

这样就可以将列表内容、默认值、以及表单元素三者绑定在一起了。

而我们的列表内容并不是任何情况下都是数组的,大多情况下还是Key-Value对居多。

我们可以使用以下方式:

   1: List<SelectListItem> list = new List<SelectListItem>
   2:                               {
   3:                                   new SelectListItem {Text = "重典", Value = "http://www.mamicode.com/1"},
   4:                                   new SelectListItem {Text = "邹健", Value = "http://www.mamicode.com/2"},
   5:                               };
   6: ViewData["sel1"] = new SelectList(
   7:     list /*列表内容可以是数组*/
   8:     , "2" /*默认值,可以是从数据库读出的*/
   9:     );

mvc HtmlHelper