asp.net mvc 3.0 知识点整理 ----- (4).HtmlHelper(Html 辅助方法)介绍

2022-10-06 18:04:06

　　在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()：
　　支持异步的表单提交，可以直接用ＭＶＣ自带的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 &lt; br /&gt;  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 辅助方法)介绍,布布扣,bubuko.com

asp.net mvc 3.0 知识点整理 ----- (4).HtmlHelper(Html 辅助方法)介绍

上一篇：android Handler的使用(二)


下一篇：【C#|.NET】实例看lock(?)