在View视图中,Html的类型是System.Web.Mvc.HtmlHelper<T>, 所有的辅助方法都需要和ModelState交互。那么,ModelState是什么呢?它是模型绑定的附属品,并且存有模型绑定期间检测到的所有验证错误。以及用户提交用到来更新模型的原始值。
本篇博文,我们主要来介绍下一些常用的html辅助方法的主要作用和使用方法。
1. Html.BeginForm()和Ajax.BeginForm()。
Html.BeginForm():
同于传统的表单提交,主要是生成表单的form值,如果表单时强类型视图,则在提交表单的时候,会自动将表单元素name名称与强类型视图中的类型实体的属性值相同的进行填充;同样在表单中,如果我们是强类型视图,则可以直接使用@Model.UserName将值输到指定位置。
一般和using{} 一起使用,否则要在form结尾添加Html.EndForm()。
method的方法分为: post 和 get: 提交后,变量可以在URL地址栏中获取。Get提交的时候,不会改变服务器的状态,客户端重复向服务器发送Get请求对服务器不会产生负面影响。
post: 提交表单中的所有元素,Post请求会改变服务器的状态,因此客户端重复向服务器发送Post请求会对服务器产生影响。
使用方法:
@using( Html.BeginForm( "方法名", "Controller名", FormMethod.提交的方法, new { target="_blank", @class = "表单的class名,方便定义样式", @id="表单的id名,方便获取表单元素"} )){ }
等同于:
<form action="Controller名/方法名" method ="提交的方法" class ="表单的class名" id="表单的id名" target="_blank"></form>
Ajax.BeginForm():
支持异步的表单提交,可以直接用MVC自带的Ajax.BeginForm就可以很容易的完成一个异步的表单提交动作。
@using(Ajax.BeginForm( new AjaxOptions { UpdateTartetId ="UserLogOnContainer", HttpMethod ="Post", OnSuccess="" } )) //提交到当前页面,提交方式是Post,异步更新模块Id为UserLogOnContainer的内容块
也可以提交到指定的controller的action上。
@using(Ajax.BeginForm("action","controller",null new AjaxOptions { UpdateTartetId ="UserLogOnContainer", HttpMethod ="Post", OnSuccess="" } )) //提交到当前指定的controller的action下,提交方式是Post,异步更新模块Id为UserLogOnContainer的内容块
2. Html.ValidationSummary()
主要用来
(1). 显示后台 ModelState.IsValid 验证失败后的提示错误信息。
(2). 或者是后台验证通过,但是某些逻辑验证没有通过。
比如:用户登录的时候,用户名或者密码错误。则可以手工添加错误信息
View页面:
@Html.ValidationSummary(true, "Login was unsuccessful. Please correct the errors and try again.")
Controller可以写:
ModelState.AddModelError("", "The user name or password provided is incorrect.");
3.Html.ValidationMessage()
功能和Html.ValidationSummary()类似,当ModelState字典中认证失败时,用来显示错误提示信息。
使用方法:
Controller中写:
ModelState.AddModelError("Title","What a terrible name!");
View中使用
@Html.ValidationMessage("Title")
4.Html.TextBox()、Html.TextArea()
主要是用来渲染 Html的textbox和textarea。
使用方法:
@Html.TextBox("title","textbox infomation") @Html.TextArea("textAreaTitle","textarea <br/> infomation")
等同于:
<input type="text" id="title" name="title"> textbox information </input> < textarea id="textAreaTitle" name="textAreaTitle"> textarea < br /> information </textarea >
输出的内容是经过html编码的。
5.Html.Label()
Label辅助方法将返回一个<label/>元素
使用:Controller:
[DisplayName("Genre")] //显示的内容 public int GenreId{get;set;}
View:
@Html.Label("GenreId")
等同于:
<label for="GenreId">Genre</label>
6.Html.DropDownList()、Html.ListBox()
两个辅助方法都返回select元素,DropDownList只允许多单选,而ListBox则允许多选
(通过渲染的标记中的multiple特性的值设置为multiple), 后台绑定数据源一般使用SelectListItem类型。
new SelectListItem { Text = ”显示内容“, Value = "对应的值", Selected = bool值(是否选中) }
7.Html.Editor()
用法:自定义Editor编辑器。
具体使用方法,可以参考这篇文章: http://hi.baidu.com/scorpio_jone/item/3080aefc8133c713a7298843
8.Html.Hidden()
用于渲染隐藏的输入元素,一般用于在页面显示隐藏域。
用法:
@Html.Hidden("wizardStep", "1")
=>
@Html.HiddenFor(w => w.wizardStep)
(PS:Hidden和HiddenFor具体什么差别,后面我们会提到。)
对应Html的:
<input id="wizardStep" name="wizardStep" type="hidden" value="1" />
9.Html.Password()
用于渲染密码字段。他除了不保留提交的值和使用密码掩码之外,其他基本和TextBox的辅助方法一样。
用法:
@Html.Password("UserPassword")
=>
@Html. PasswordFor(w => w.UserPassword)
对应Html的:
<input id="UserPassword" name="UserPassword" type="password" value="" />
10.Html.RadioButton()
用于渲染单选按钮,一般都是组合使用。如下:选择性别(男/女)
用法:
@Html.RadioButton("Gender","Male") @Html.RadioButton("Gender","Female", true)
=>
@Html.RadioButtonFor(m => m.Gender, "Male") @Html.RadioButtonFor(m => m.Gender, "Female")
11.Html.CheckBox()
用于渲染复选框按钮(checked 、 unchecked)。它是唯一 一个渲染两个输入元素的辅助方法。
用法:
@Html.CheckBox("isChecked")
对应于:
<input name="isChecked" id="isChecked" type="checkbox" value="true" /> <input name="isChecked" type="hidden" value="false"/>
(这样的原因是:当没选中的时候,确保有值提交。)
12.Html.ActionLink()、Html.RouteLink()
Html.ActionLink():
(1).用于渲染一个指定另外一个控制器操作的超链接,跟前面的BeginForm辅助方法一样。
用法:
@Html.ActionLink("Link Text 显示的链接名称", "AnotherAction 要提交的控制器方法名称")
对应于:
<a href="/Home/AnotherAction">Link Text</a>
(2).不同一个控制器则用:
@Html.ActionLink("Link Text", "AnotherAction", "AnotherController")
对应于:
<a href="/AnotherController/AnotherAction">Link Text</a>
(3).如果要传递个参数到action中,则可以用:
@Html.ActionLink("Link Text", "AnotherAction", "AnotherController", new{ ID = 123 } )
对应于:
<a href="/AnotherController/AnotherAction?ID=123">Link Text</a>
Html.RouteLink():
和Html.ActionLink() 遵循相同的模式。但是Html.RouteLink() 可以接收路由名称,而不是接收控制器名或者方法名。
如:
@Html.RouteLink("Link Text", new {action ="AnotherAction"} )
13.Html.Partial()、Html.RenderPartial()
(1). Html.Partial用于将分部渲染成字符串。
(2). Html.RenderPartial是直接将用户控件嵌入到界面上。
如:
@{ Html.RenderPartial("LogOnUserControl"); }
或
@{ Html.RenderPartial("~/Areas/Comm/Views/Shared/LogOnUserControl.ascx"); }
两者类似:
@Html.Partial("AlbumDisplay") (写法较方便) => @{ Html.RenderPartial("AlbumDisplay"); } (性能较好)
14.Html.Action()、Html.RenderAction()
Html.RenderAction:通过Controller中的Action来调用用户控件
Controller:
public ActionResult UserControl() { return PartialView(); }
View:
@Html.RenderAction("UserControl","Controller")
15.Url.Action()
Url辅助方法和Html的ActionLink和RouteLink类似。但他不是用Html标记的形式返回构建的Url,而是返回字符串形式的Url。
<span> @Url.Action("Browse", "Store", new{ genre = "Jazz" }, null ) </span>
对应Html的
<span> Store/Browse?genre=Jazz </span>
16.Url.Content()
<script src="@Url.Content("~/Scripts/Jquery-1.10.1.min.js")" type="text/javescript"></script>
除了上面介绍的这些Html辅助方法,还有上面提到的一些Html的For方法。那么For方法和其他的有什么异同之处呢?
For的方法可以结合Model实体,通过lambda表达式的方法来渲染。写法:@Html.LabelFor(m => m.GenreId)等。
参考文献:http://www.tuicool.com/articles/MRJNre
asp.net mvc 3.0 知识点整理 ----- (4).HtmlHelper(Html 辅助方法)介绍