《ASP.NET MVC4 WEB编程》学习笔记------HtmlHelper

本文转载自powerzhang，若是给您带来不便请联系博主。

在实际的程序中，除了在View中展现数据外，还须要在View与后台的数据进行交互，在View中我就须要用的表单相关的元素；

　　在MVC3框架中，咱们能够用到Html的相关辅助方法进行对表单的输出；

　　视图中Html的类型是System.Web.Mvc.HtmlHelper<T>

一、  Html.BeginForm()

　　主要是生成表单的form值，若是表单时强类型视图，则在提交表单的时候，会自动将表单元素name名称与强类型视图中的类型实体的属性值相同的进行填充；

　　一样在表单中，若是咱们是强类型视图，则能够直接使用@Model.UserName将值输到指定位置；

 

二、  Html.ValidationSummary()

　　通常咱们在controller中选定的action下添增强类型的create视图，都会在表单下生成Html.ValidationSummary(true);这样的东西，传true和false有什么区别了？

　　ValidationSummary辅助方法能够用来显示ModelState字典中全部验证错误的无序列表。使用bool类型参数(值为true的状况)来告知辅助方法排除属性级别错误；

　　具体示例解释以下

public ActionResult SelStudent() {
            ModelState.AddModelError("", "this is all wrong");
            ModelState.AddModelError("UserName", "is Required");
            Student s = new Student();
            s.UserName = "regicide";
            return View(s);
        }

View Code

　　若是在页面使用Html.ValidationSummary(true); 则is required会显示在对应的UserName文本框的下面；若是使用false则isRequired会显示到this is all wrong下面

　　

　　注：若是要显示出对应的样式，引入/Content/Site.css便可

 

三、  Html.TextBox()、Html.TextArea()

　　此方法主要为生成<input type=’text’ />和<textarea>< textarea />

@Html.TextBox("title","",new {@style="background-color:red",ReadOnly="ReadOnly"})

　　就会生成以下的html标签；若是你使用@Html.Editor方法则不会提供传递html元素的相关重载；

<input ReadOnly="ReadOnly" id="title" name="title" style="background-color:red" type="text" value="" />

　　注：若是在强类型视图中按照以下定义

public ActionResult SelStudent() {
            Student s = new Student();
            ViewBag.UserName = "free";
            s.UserName = "regicide";
            return View(s);
        }

　　而后经过@Html.TextBox("UserName")输出，则<input type=’text’ />元素中默认值是free而不是regicide，由于在页面的取值中，若是不强行指定取Model的UserName则会默认取ViewBag的动态值UserName

　　若是咱们给一个文本框加本身的属性好比new{data_my1=’free’}此时被编译后是data-my1=’free’,注意下划线和短横线的区别；

 

四、  Html.Label()

　　在咱们的使用中，不多使用label的标签，label标签视乎并不经常使用；其实lable的妙用在于

<label for="Age">Age</label>
<input class="text-box single-line" data-val="true" data-val-number="字段 Age 必须是一个数字。" id="Age" name="Age" type="text" value="" />

　　当咱们点击label标签(age)的时候，光标会自动定位到id位age的文本框；因此Html.label()主要生成<label for="Age">Age</label>的label

 

五、  Html.DropDownList()

　　下拉框的用法，主要是用于在后台查询出的IEnumerable进行数据绑定；

　　示例为：　　

public ActionResult SelStudent() {
            List<SexSelect> sss = new List<SexSelect>();
            SexSelect ss = new SexSelect();
            ss.Id = 0;
            ss.Text = "男";
            sss.Add(ss);
            ss = new SexSelect();
            ss.Id = 1;
            ss.Text = "女";
            sss.Add(ss);
            var t = sss.AsEnumerable();
            ViewBag.Sex = new SelectList(t, "Id", "Text");
            return View(s);
        }

View Code

 

@Html.DropDownList("Sex")就会自动绑定后台指定的t显示到下来框；

 

六、  Html.ValidationMessage()

　　当ModelState字典中出现错误时，可使用此方法来显示相应的错误；此用法在第二点中(Html.ValidationSummary())略有提到,后面讲模型验证还会继续的说明此用法

 

七、  Html.Editor()

　　此方法在生成html元素最为特殊，由于上面的根据名称能够知道大体的html元素控件；而editor则不同了；

　　Editor方法能够经过数据注解来改变生成Html，好比我在实体上面指定“DataType[DataType.MultitineText]”,则Editor则会自动生成为<textarea></textarea>标签；

　　而且Eidtor方法还支持模板的重载；

　　在Controller对应的文件下面添加子文件夹，命名为“EditorTemplates”(强命名)，而后添加一个名为“DateTime.cshtml”(强命名)，并写以下代码：

@{
    Layout = null;
}
@Html.TextBox("",ViewData.TemplateInfo.FormattedModelValue,new {@class="text-box single-line",data_datepicker="true",data_test="regicide"})

　　则在强类型实体中定义为DateTime类型的字段经过Editor生成就会变成以下：

<input class="text-box single-line" data-datepicker="true" data-test="regicide" id="Birthday" name="Birthday" type="text" value="" />

　　这就是Editor的根据模型进行智能生成的好处；固然若是有的部分不想使用DateTime.cshtm中的方式进行生成html,能够将DateTime.cshtml进行改名，改名后，使用@Html.Editor("Birthday","SpecialDateTime")“SpecialDateTime”为视图名称，这样也能够进行生成.

 

八、  Html.Hidden()

Hidden就是生成隐藏文本域的方法；好比：

@Html.Hidden("id","1")

就会生成一个隐藏文本域

<input id="guid" name="guid" type="hidden" value="1" />

MVC3中若是使用强类型隐藏文本域的做用就很大，好比一个更新的强类型视图，一共有5个字段，你只更新3个字段，那么就须要把另外两个字段放在隐藏文本域中，不然的话，强类型提交到后台就就只会赋值页面绑定的3个字段，另外2个会丢失

 

九、  Html.Password()

这个比较简单，用法跟hidden同样，就是会生成一个password类型的input

<input id="pass" name="pass" type="password" value="123456" />

 

十、Html.RadioButton()

RadioButton主要是生成一组来供用户选择，根据name来肯定一组按钮；

@Html.RadioButton("color", "red")<text>red</text>
@Html.RadioButton("color", "blue",true)<text>blue</text>
@Html.RadioButton("color", "green")<text>green</text>

就会生成为：

<input id="color" name="color" type="radio" value="red" /><text>red</text>
<input checked="checked" id="color" name="color" type="radio" value="blue" /><text>blue</text>
<input id="color" name="color" type="radio" value="green" /><text>green</text>

 

十一、Html.CheckBox()

这个辅助方法比较特殊一点点，CheckBox生成元素会生成2个input元素；

@Html.CheckBox("sel",true)

生成的源代码为：

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

一个checked一个hidden；

它渲染两个输入元素的主要缘由是，HTML规范中规定了浏览器只提交选中的复选框的值，在上面的例子中即便sel的checked没有被选中，也会被提交一个false到后台；

 

十二、  Html.ActionLink()、Html.RouteLink()

看到这两个，好像没怎么想到跟html中的什么东西对应；从字面上理解就是生成link的东西；

ActionLink主要是渲染一个指向另一个控制器操做的超连接。

好比：

@Html.ActionLink("超连接","SelStudent","Home")

就会生成为：

<a href="/Home/SelStudent">超连接</a>

在ActionLink中还重载了一些能够传递htmlAttributs的方法；

RouteLink和ActionLink差很少，可是RouteLink能够接收路由名称而不接收控制器名称和操做名称。

好比上面的ActionLink的例子能够转换为

@Html.RouteLink("超连接",new {action="SelStudent"})

固然，还有一个区别就是能够直接指定路由名称；

要实现上面的actionlink效果还能够写成

@Html.RouteLink("超连接","Default")

Default是Global启动的时候注册的一个默认路由；这里若是只指定路由，默认的action会变成当前view的action;

 

1三、Html.Partial()、Html.RenderPartial()--------惟一一种使用部分视图的方法

Partial用于将分部视图转换为字符串；

新建一个action 为PartialTest 而后添加到分部视图，就会添加一个彻底空白的页面(不包含一个标签)，而后在须要使用的地方

@Html.Partial("PartialTest")

只须要指定分部视图名称便可；

这样就会把PartialTest中的内容写入到@Html.Partial("PartialTest")所在的位置；有点相似于java中的include导入页面同样

RenderPartial()跟Partial差很少的用途，只是返回的值不同；Partial返回的是MvcHtmlString,而RenderPartial返回的是空，输入咱们手动的在打印一遍；

@{Html.RenderPartial("PartialTest");}

这样就跟Partial效果同样了；但RenderPartial不是返回字符串，而是直接写入响应输出流，直接写入响应流性能上比Partial要好一点；

 

1四、Html.Action()、Html.RenderAction()

Action和RenderAction差很少，一个是直接返回MvcHtmlString一个是返回空，把数据写到响应流；   

借上面一个示例说明下分部视图如何不让直接访问，必须用html的辅助方法访问；

[ChildActionOnly]
        public ActionResult PartialTest() {
            return PartialView();
        }

这样就只容许经过Html的辅助方法【Action、RenderAction、Partial、RenderPartial】来进行访问了

在14的示例中若是在ActionResult加上一个[ActionName(“MyTest”)],此时在访问PartialTest时就要用MyTest才能访问到了；

 

小结：看了这么多系统提供的Html辅助方法，咱们是否是该本身写一个自定义的Html辅助方法了？那么开始吧！

新建一个静态类，里面定义一个本身写好的方法

public static MvcHtmlString TestHtml(this HtmlHelper html) {
            MvcHtmlString mhs = new MvcHtmlString("<div style='width:100;height:100;background-color:red'></div>");
            return mhs;
        }

方法返回一个MvcHtmlString(若是是想返回html不被转义的状况下，不然能够返回string),里面顶一个div，而后直接返回；

在页面中使用时得先引入新建的这个类的命名空间；

在顶部写上“@using MVC3Pro.Controllers”

而后就能够像使用其余html辅助方法同样使用点操做了；(在点操做的时候，方法的下面有个向下的小箭头，是表明扩展方法，加this传递进去，将当前方法附加到this的上面为附加方法)

@Html.TestHtml()

--------------------------------------------
/*结果*/
<div style='width:100;height:100;background-color:red'></div>