MVC5 + EF6 + Bootstrap3 (8) HtmlHelper用法大全(上)

上一节：MVC5 + EF6 + Bootstrap3 (7) Bootstrap的栅格系统

源码下载：点我下载

HtmlHelper简介

在ASP.NET MVC5的View页面中，HtmlHelper被用来输出HTML代码。更官方点的描述，System.Web.Mvc.HtmlHelper对象，该对象用于呈现HTML元素。如下图所示。

HtmlHelper中的每一个函数都对应生成一种标签，后面会逐一详细介绍给大家。

很多人会问为什么要用HtmlHelper而不直接写html？

我觉得有下面几个原因：

直接写HTML的话如果语句有语法错误，如缺少结尾标记</b>，编译器不会报错，出来的页面可能会很乱且难以查出错误在哪。如果用HtmlHelper在编译的时候就会指出错误，可以及时修改。
View中的页面一般都是动态页面，也就是说如果没有HtmlHelper，我们经常会写如<input type="text" value="@id">这样的服务器端代码和HTML代码的混合代码。这样写不仅形式混乱、执行顺序不好判断，而且出错也不容易发现，不如全部用HtmlHelper写成服务器端代码。而且用HtmlHelper做数据绑定更方便。
HtmlHelper和HTML语言的关系，我觉得跟Linq和SQL语言的关系差不多。就是说微软给你提供了一种方式让你在不熟悉HTML或SQL这种非.NET语言的时候，使用.NET框架内的与之等价的类来帮助你更好的解决问题。

准备工作

为了更好的演示HtmlHelper，我们在项目中新建一个默认Controller和默认Action。

在解决方案资源管理器中右键点击Controllers文件夹选择添加->控制器。在弹出的窗口中选择MVC 5 控制器 - 空，点确定。输入默认控制器名，DefaultControllerController。将下面代码写入DefaultControllerController.cs文件。

using System.Web.Mvc;

namespace SlarkInc.Controllers

{

    public class DefaultControllerController : Controller

    {

        //

        // GET: /DefaultController/

        public ActionResult DefaultAction()

        {

            return View();

        }

    }

}

从上面代码可以看出在名为DefaultController的Controller中我们创建了一个名为DefaultAction的的Action。

然后我们来创建对应的View。在Views文件夹下的DefaultController文件夹里删除已有的View添加一个名为DefaultAction的View。打开这个DefaultAction.cshtml文件，删除掉所有代码。这样我们的准备工作就完成了。下面开始添加HtmlHelper代码。

链接

ActionLink

ActionLink用来生成HTML中的<a>标签，在页面中生成一个超链接下面给出ActionLink的三个常用重载：

@Html.ActionLink("LinkText", "ActionName")

@Html.ActionLink("LinkText", "ActionName", "ControllerName")

@Html.ActionLink("LinkText", "ActionName", new { id = 1 })

点击在浏览器中查看。运行结果：

<a href="/DefaultController/ActionName">LinkText</a>

<a href="/ControllerName/ActionName">LinkText</a>

<a href="/DefaultController/ActionName/1">LinkText</a>

LinkText是链接显示出的文字，如果ActionLink的参数中给出Controller则链接指向对应的Controller下的Action。如果没有给出Controller则指向当前页面对应的Controller下的Action。如果ActionLink的参数中给出要传递的参数，如id，则在链接的最后写出id值。

RouteLink

RouteLink同样是用来生成HTML中的<a>标签的，但是其参数和ActionLink不同。我们这里给出能实现上面三行HTML代码的RouteLink代码：

@Html.RouteLink("LinkText", new { action = "ActionName" })

@Html.RouteLink("LinkText", new { action = "ActionName", controller = "ControllerName" })

@Html.RouteLink("LinkText", new { action = "ActionName", id = 1 })

从上面代码可以看出LinkText依然是链接显示的文字，而链接的其他信息则包含在RouteLink的第二个参数中。这个参数是个Object，它的action属性表示指向的Action而controller属性表示指向的Controller。如果没有controller属性则指向当前Controller。id属性则为要传递的参数。

Input控件

TextBox

TextBox用来生成HTML中的<input type="text">标签，常用重载有下面两种：

@Html.TextBox("NameId")

@Html.TextBox("NameId","Value")

生成标签如下：

<input id="NameId" name="NameId" type="text" value="" />

<input id="NameId" name="NameId" type="text" value="Value" />

可见TextBox的第一个参数被赋值给input标签的id和name属性，如果没有value参数则value为空，如果有则赋值给value属性。

Hidden

Hidden用来在页面中写入<input type="hidden">标签，其用法和TextBox类似。代码如下：

@Html.Hidden("NameId")

@Html.Hidden("NameId", "Value")

结果如下：

<input id="NameId" name="NameId" type="hidden" value="" />

<input id="NameId" name="NameId" type="hidden" value="Value" />

Password

Password用来写入<input type="password">标签，其用法和TextBox类似。代码如下：

@Html.Password("NameId")

@Html.Password("NameId", "Value")

结果如下：

<input id="NameId" name="NameId" type="password" value="" />

<input id="NameId" name="NameId" type="password" value="Value" />

CheckBox

CheckBox这个函数比较特殊，先看代码和运行结果：

@Html.CheckBox("NameId", true)

@Html.CheckBox("NameId", false)

<input checked="checked" id="NameId" name="NameId" type="checkbox" value="true" /><input name="NameId" type="hidden" value="false" />

<input id="NameId" name="NameId" type="checkbox" value="true" /><input name="NameId" type="hidden" value="false" />

本来，正常情况下它应该只生成一个<input type="checkbox">的标签，如果CheckBox第二个参数是true则有checked="checked"属性，表示这个框打勾。但是为什么这个标签有value="true"而且后面还有个尾巴<input name="NameId" type="hidden" value="false" />呢？

因为在我们ASP.NET MVC中这样子写的效果就是：如果这个CheckBox打勾了，那么提交之后就会传给目标页面一个NameId="true"的值，如果没打勾就会传一个NameId="false"的值。这个值就是由<input name="NameId" type="hidden" value="false" />传递的。若是没有<input name="NameId" type="hidden" value="false" />这一段，则提交之后如果打勾了，仍然会传给目标页面一个NameId="true"的值，而不打勾则不会传NameId的值过去。

RadioButton

RadioButton会生成一个<input type="radio">标签，代码如下：

@Html.RadioButton("NameId","Value", true)

@Html.RadioButton("NameId", "Value", false)

生成代码如下：

<input checked="checked" id="NameId" name="NameId" type="radio" value="Value" />

<input id="NameId" name="NameId" type="radio" value="Value" />

可以看出RadioButton和CheckBox一样都有checked参数，而RadioButton多了一个Value参数可以设置。

列表框

DropDownList

DropDownList函数可以创建<select>标签表示的下拉菜单。在创建下拉菜单之前我们需要创建用<option>标签表示的菜单选项列表，创建方法如下：

@{

        SelectListItem item;

        List<SelectListItem> list = new List<SelectListItem>();

        for(int i=1;i<5;i++)

        {

            item = new SelectListItem();

            item.Text = "Text" + i;

            item.Value = "Value" + i;

            item.Selected = (i==2);

            list.Add(item);

        }

}

SelectListItem类会生成一个菜单项，其Text属性表示其显示的文字，Value属性表示其对应的值，Selected属性表示其是否被选中。上面代码生成了若干个<option>标签并且当i为2时，标签被选中。

通过下面代码可以生成包含上面选项列表的下拉菜单：

@Html.DropDownList("Id", list)

生成的结果如下：

<select id="NameId" name="NameId">

    <option value="Value1">Text1</option>

    <option selected="selected" value="Value2">Text2</option>

    <option value="Value3">Text3</option>

    <option value="Value4">Text4</option>

</select>

可见DropDownList函数的第一个参数是其id和name，第二个参数就是其四个选项组成的List。每一个选项都有各自的Text、Value，并且第二个选项被选中。

ListBox

ListBox可以生成一个多选列表框，对应HTML里的<select multiple="multiple">标签，ListBox的结构和DropdownList的结构基本一样，只是多了multiple="multiple"属性。我们这里依然使用上面创建的选项列表来创建我们的ListBox，代码如下：

@Html.ListBox("NameId", list)

生成的结果如下：

<select id="NameId" multiple="multiple" name="NameId">

    <option value="Value1">Text1</option>

    <option selected="selected" value="Value2">Text2</option>

    <option value="Value3">Text3</option>

    <option value="Value4">Text4</option>

</select>

添加属性

例如想给一个标签添加class和style可以用下面办法：

@Html.TextBox("NameId", "Value", new { @class = "classText",@style="width:200px" })

得到结果如下：

<input class="classText" id="NameId" name="NameId" style="width:200px" type="text" value="Value" />

上面黄色标记部分即为添加的属性。其实你可以以同样的方式添加任意的属性名和属性值，都会生效。

结尾

这个主题未完待续，由于小弟实在精力有限，且写作时字斟句酌、精心选例、深入分析、亲自实践，希望大家谅解。

喜欢的话就点个赞吧，或者哪里有疑问留言讨论讨论。