ASP.NET MVC3学习心得-----表单和HTML辅助方法

5.1表单的使用

5.1.1  action和method的特性

表单是包含输入元素的容器，包含按钮、复选框、文本框等元素，表单的这些输入元素使得用户能够向页面中输入信息，并把输入信息提交给服务器。Action特性告知浏览器将URL提交到哪里，method特性来说明用何种方式告知浏览器，默认为get方法

5.1.2Get和Post方法

1、如果不想让浏览器把输入值放入查询字符串中，而是想放入HTTP请求的主体中，可以为method赋值post，post可以用来提交信用卡信息、向购物车添加专辑或者修改密码等，post请求通常会改变服务器上的状态，重复提交等。POST请求用于写操作

2、Get请求所有的参数都在URL中，代表的是幂等操作和只读操作，不会改变服务器的状态，可以向客户端重复的发送GET请求而不会产生负面影响，GET请求用于读操作

示例：通过计算Action特性值来搜索音乐，使用HTML辅助方法代劳如下：

@using（Html.BeginForm("Search","StoreManager",FormMethod.Get)){

<input type="text" name="q"/>

<input type="submit" value="Search"/>

}

5.2HTML辅助方法

HTML辅助方法可以通过视图的Html属性调用的方法。当然也可以通过Url的属性调用URL辅助方法，通过Ajax属性调用AJAX辅助方法，所有的这些方法目的就是为了让视图编码变得容易。

如上边提到的Html.BeginForm()方法，在后台该辅助方法与路由引擎协调以生成合适的URL。该辅助方法在调用期间生成一个起始标签，并返回了一个IDisposable对象，当执行到using语句的结束花括号时，隐式的调用Dispose方法，因此该辅助方法会生成一个结束标签。

5.2.1 自动编码

例：TextArea辅助方法，用来输出HTML元素textarea

@Html.TextArea("text","hello<br/>world!");

5.2.2 辅助方法的使用

BeginForm的另一个重载版本

@using （Html.BeginForm("Search","StoreManager",FormMethod.Get,new{ target="_blank"}))

{

<input type="text" name="q"/>

<input type="submit" value="Search"/>

}

该重载代码向BeginForm方法的htmlAttributes参数传递了一个匿名类对象，在ASP.NET MVC 框架中每一个HTML辅助方法在它某个重载方法中都有一个htmlAttributes参数，不同的版本中htmlAttributes的参数类型是IDictionary<string ,object>辅助方法采用字典条目并利用这些条目创建辅助方法生成元素特性

通过使用htmlAttributes参数设置许多必要的特性，如设置一个元素的class属性，因为class为C#关键字这时需要在class前加@，即@class。

此外将属性设为带有连字符的名称（如：data-val）,但是带有连字符的C#属性名是无效的，所有辅助方法在渲染HTML时会将属性名中的下划线转换为连字符。

示例如下：

@using (Html.BeginForm("Search", "StoreManager", FormMethod.Get, new

{

target = "blank",

@class = "green",

data_validatable = true

}))

{

<input type="text" name="q" />

<input type="submit" value="Search" />

}

5.2.3 HTML辅助方法的工作原理

每个Razor视图都继承了各自基类的Html的属性，Html属性的类型是System.web.mvc.HtmlHelper<T>这里的T是一个泛型参数，代表传递给视图的模型类型，该属性提供了一些可以在视图中调用的方法，如：EnableClientValidation(选择性的关闭（打开）客户端验证)

5.2.4设置专辑编辑表单

@using (Html.BeginForm()) {

@Html.ValidationSummary(true)

<fieldset>

<legend>Album</legend>

<p><input type="submit" value="Save"/></p>

</fieldset>

}

该视图中使用了两个方法，

1、Html.BeginForm:该方法上边已有介绍

2、Html.ValidationSummary:用来显示ModelState字典中所有验证错误的无序列表，使用布尔值类型参数（true）来告知辅助方法排除属性级别的错误，只显示ModelState中与模型本身有关的错误，而不显示与具体模型属性相关的错误。

3、示例：

ModelState.AddModelError("", "This is all wrong!");

ModelState.AddModelError("Title", "what a  terrible name!");

在控制器某个操作中添加以上代码用来渲染编辑视图，

第一个错误是模型级别的，因为代码中没有提供关联错误与特定属性的键，

第二个错误是与属性相关联的错误，因此在视图验证摘要区不会显示这个错误

5.2.5 添加输入元素

1、Html.TextBox(和Html.TextArea)

调用形式如下：

@Html.TextBox("Title",Model.Title);

@Html.TextArea("text","Hello");

重载版本：@Html.TextArea("text","hello world",10,80,null);

渲染为<textarea cols="80", id="text" name="text" rows="10">hello world</textarea>

2、HTML.Label

该方法返回一个<lable/>元素，并用string类型的参数决定渲染的文本和特性值

Html.Label("GenreId")如下：<label for="GenreId">Genre</label>

我们可以发现label渲染的文本不是“GenreId",而是"Genre"，在可能的情况下，辅助方法使用任何可用的模型元数据来生成显示内容

3、Html.DropDownList(和Html.ListBox)

这两个辅助方法都返回一个<select/>元素，DropdownList单选，ListBox多选（需设置属性）

Select元素的作用：

l 展示可选项的列表

l 展示字段的当前值

下来列表需要一个包含所有可选项的SelectListItem对象集合，其中每个SelectListItem对象又包含Text、Value、Selected属性，也可根据需要自己创建自己的SelectListItem对象集合，也可以使用框架中的SelectList或MultiSelectList辅助方法来构建。

如： ViewBag.GenreId = new SelectList(db.Genres, "GenreId", "Name", album.GenreId);

ViewBag.ArtistId = new SelectList(db.Artists, "ArtistId", "Name", album.ArtistId);

SelectList构造函数参数指定了原始集合（数据库中的Genres表），作为后台值使用的属性名称(GenreId)，作为显示文本使用的属性名称（Name）以及当前选择项的值

4、Html.ValidationMessage

当ModelState字典中某一个特定字段出现错误时，可以使用ValidationMessage方法来显示相应的错误提示消息

例：首先在模型状态中为Title属性添加一个错误

ModelState.AddModelError("Title", "what a  terrible name!");

在视图页可以这样显示错误提示消息：@Html.ValidationMessage("Title");

5.2.6 辅助方法、模型和视图数据

1、通过辅助方法赋予与Viewbag中的值相同的名称显示文本框的价格

如：在控制器中：ViewBag.Price=10.0;

在视图中：@Html.TextBox("Price");

如：在控制器中：ViewBag.Album=new Album{ Price=11};

在视图中： @Html.TextBox("Album.Price");

2、辅助方法依靠强类型的视图数据也能很好的工作

如：在控制器中：var album=new Album{ Price=12.0};

在视图(强类型)中：@Html.TextBox("Price");

3、向表单辅助方法提供显示的值

在控制器中：var album=storeDB.Albums.Single(a=>a.AlbumId==id);

ViewBag.Genres=new SelectList(storeDB.Genres.OrderBy(g=>g.Name),"GenerId","Name",album.GenreId);

在视图(强类型)中： @Html.TextBox("Title",Model.Title);

5.2.7 强类型辅助方法

该方法需要为其传递一个lambda表达式来指定要渲染的模型属性，且表达式的模型必须和为视图指定的模型类型一致。

例：@Html.LabelFor(m=>m.GenreId);

@Html.DropDownListFor(m=>m.GenreId,ViewBag.Genres as SelectList)

@Html.ValidationMessageFor(m=>m.Title)

这些强类型的辅助方法名都以For作为其后缀，使用lambda表达式可是轻松实现代码的重构

5.2.8 辅助方法和模型元数据

例：使用Label辅助方法来为流派选择列表显示一个label元素

@Html.Label("GenreId");

且该辅助方法生成如下标记：

<label for="GenreId">Genre </label>

当辅助方法询问运行时是否有GenreId的可得模型元数据时，运行时从装饰Album模型的Displayname 特性中获取的信息

[DisplayName("Genre")]

Public int GenreId{get;set;}

5.2.9 模板辅助方法

ASP.NET MVC 中的模板辅助方法利用元数据和模板构建HTML，其中元数据包括关于模型值（名称和类型）的信息和（通过数据注解添加的）模型元数据。

模板辅助方法有Html.Display和Html.Editor(分别对应强类型的方法Html.DisplayFor 和Html.EditorFor)

例：使用Html.TextBoxFor 辅助方法为某个专辑的Title属性生成以下特征

@Html.EditorFor(m=>m.Title);

两种方法生成同样的HTML标记，但是Html.EditorFor()方法使用更加广泛，在使用模板辅助方法时，运行时就可以生成合适的“编辑器”,在Title属性上添加如下注解

[DataType(DataType.MultilineText]

Public string Title{get;set;}

添加之后使用EditorFor方法渲染为：

<textarea class="text-box multi-line">Let me go</textarea>

5.2.10 辅助方法和ModelState

用来显示表单值的辅助方法也需要和ModelState交互。ModelState是模型绑定的副产品，粗有模型绑定期间检测到的所有错误，以及用户提交用来更新 模型的原始值

5.3 其他输入辅助方法

5.3.1 Html.Hidden

该方法用来渲染隐藏输入的元素

如：@Html.Hidden("Olive","Love");

渲染以后：<input id="Olive" name="Olive" type="hidden" value="Love"/>

5.3.2Html.Password

该方法用来渲染密码字段

如：@Html.Password("UserPassword")

强类型方法为：Html.PasswordFor(m=>m.UserPassword);

5.3.3 Html.RadioButton

如：@Html.RadioButton("color","red")

@Html.RadioButton("color","blue",true")

其对应的强类型方法：

@Html.RadioButtonFor(m=>m.GenreId,"1") Rock

在提交的时候后边会跟要提交的值

5.3.4 Html.CheckBox

CheckBox是唯一一个渲染两个输入元素的辅助方法

如：@Html.CheckBox("IsDiscouted");

渲染如下：<input id="IsDiscounted" type="checkbox" value="true"/>

<input id="IsDiscounted" type="hidden" value="false"/>

5.4 渲染辅助方法

渲染辅助方法可以在应用程序中生成指向其他资源的连接，也可构建被称作部分视图的可重用UI片段

5.4.1 Html.ActionLink和Html.RouteLink

Html.ActionLink辅助方法渲染指向另一个控制器操作的超链接，在后台使用路由API生成URL如：@Html.ActionLink（"Link Text","AnotherAction")

则生成：<a href="/Home/AnotherAciton">Link Text</a>

当需要一个指向不同控制器的操作的连接时，如下：

@Html.ActionLink("Link Text","Index","ShoppinCart");

第一个参数为显示字段，第二位控制器中的操作名，第三个参数为控制器名去掉controller

在实际的应用中可能需要传递一个ID值或者其他参数值，这个时候可以传递RouteValueDictionary对象也可给routeValues参数传递一个对象（通常匿名类），在运行时查看对象的属性并用它来构建路由值，（属性名为参数名，属性值为参数）例：

为构建一个指向姓名为Olive的链接：

@Html.ActionLink("Show Love","Index","ShoppingCart",new { name="Olive"},null);

该方法的最后一个参数是htmlAttributes,即：通过该参数设置HTML元素的值，上面设置为null即没有设置任何特性，但是为调用ActionLink方法必须给其赋值

Html.RouteLink和Html.ActionLink方法遵循了相同的模式，但是，该方法只接受路由名称而不接受控制器名称和操作名称

如：@Html.RouteLink("Link Text",new {action="AnotherAction"})

5.4.2 URL辅助方法

URL辅助方法与HTML的ActionLink和RouteLink辅助方法相似，但是它是以字符串的形式返回这些URL的而非标记，有三个辅助方法：Action、Content、RouteUrl

如下：

Action方法和ActionLink方法相似

<span> @Url.Action("Browse","Store",new { genre="Jazz"},null}</span>

渲染成为：<span> /Store/Borwse?genre=Jazz</span>

RouteUrl方法和Action方法类似但是它只接收路由名称而不接受控制器和操作

Content方法可以将应用程序中的相对路径转换为绝对路径，如下：

<script src="@Url.Content("~/Scripts/sdf.js")"</script>

在传递为Content方法的字符串前使用波浪线作为第一个字符，无论应用程序部署在什么位置，该辅助方法都可以指向正确的资源，如果不加波浪线，挪动应用程序的位置则生成的URL无效

5.4.3 Html.Partial和Html.RenderPartial

Pattial方法将分部视图渲染成字符串，该方法共有四个重载版本，如下：

Public void Partial (string partialViewName);

Public void Partial (string partialViewName,object model);

Public void Partial (string partialViewName,ViewDataDictionary viewData);

Public void Partial (string partialViewName,object model,ViewDataDictionary viewData);

这里没有毕业为视图指定路径和文件扩展名，直接如下：

@Html.Partial("AlbumDisplay");

RenderPartial与Partial方法类似，但是RenderPartial不是返回字符串而是直接写入相应流中，故需要这样使用@{Html.RenderPartial("AlbumDisplay");}

Partial方法相对灵活，RenderPartial方法相对于大量使用更有优势

5.4.4 Html.Action 和Html.RenderAction

Action是执行淡定的控制器操作并显示结果，且提供了更多的灵活性和重要性，因为控制器操作可以建立不同的模型，可以利用单独的控制器上下文

RenderAction直接喜人响应流，示例如：

Public class MyController{

Public ActionResult Index(){ return View();}

[ChildActionOnly]

Public ActionResult Menu(){ var menu=GetMenuFrom SomeWhere();

Return PartialView(menu);

}

Menu 操作构建一个菜单模型，并返回带有菜单的分部视图

在Index.cshtml页可以这样调用

<body>@Html.Action("Menu")<h1>Welcom</h1></body>

这里需要注意的是Menu操作使用了ChildActionOnlyAttribute特性标记，该特性设置防止了运行时直接通过URL来调用Menu操作，只能通过Action或RenderAction操作。在MVC3中，ControllerContext有一个IsChildAction属性，如果通过Action或RenderAction操作则为true，通过URL操作则为false，同时一些操作过滤器不同于子操作如：AuthorizeAttribute和OutputCacheAttribute

1、给RenderAction传递值

因为该操作方法调用的是操作方法，所以指定目标操作的一些额外操作是可以的，

如下：向菜单中添加一些项

①　定义新类：MenuOption

Public class MenuOption{

Public int Height{get；set；}

Public int Width{get；set；}

}

②　修改Menu操作，使其可以作为参数接受MenuOption对象

[ChildActionOnly]

Public ActionResult Menu(MenuOption options)

{

Return PartialView(options);

}

③　在视图中可以通过Action调用传进菜单选项

@Html.Action("Menu",new { options=new MenuOptions{ width=400,Height=500}});

2、与ActionName特性结合使用

RenderAction方法优先使用ActionName特性值作为要调用操作的名称。如下注释：

[ChildActionOnly]

[ActionName("CoolMenu")]

Public ActionResult Menu(MenuOptions options)

{

Return PartialView(options);

}

当调用RenderAction方法时，需要确保操作名是CoolMenu而不是Menu。