ASP.NET MVC5（三）：表单和HTML辅助方法

表单的使用

Action和Method特性

　　Action特性用以告知浏览器信息发往何处，因此，Action特性后面需要包含一个Url地址。这里的Url地址可以是相对的，也可以是绝对的。如下Form标签向Bing的search页面发送一个搜索词（输入元素的名称为q）。

    <form action="http://www.bing.com/search">
        <input name="q" type="text" />
        <input type="submit" value="search" />
    </form>

　　Method特性可以告知浏览器使用HTTP POST还是使用HTTP GET，默认情况下表单发送的是HTTP GET请求。下面，我们分别介绍GET方法和POST方法。

GET方法 - 从指定的资源请求数据

• GET请求可被缓存
• GET请求保留在浏览器历史记录中
• GET请求可被收藏为书签
• GET请求不应在处理敏感数据时使用
• GET请求有长度限制
• GET请求只应当用于取回数据

POST方法 - 向指定的资源提交要被处理的数据

• POST请求不会被缓存
• POST请求不会保留在浏览器历史记录中
• POST不能被收藏为书签
• POST请求对数据长度没有要求

以下是对HTTP GET和HTTP POST的比较：

表单的使用

下面，我们使用表单来构建一个查询产品的示例：
向上一篇《ASP.NET MVC5（二）：控制器、视图与模型》模型一节中的示例添加5种产品

修改ProductsController，添加Search和Result方法：

    public ActionResult Search()
    {
        return View();
    }

    public ActionResult Result(string productName)
    {
        var products = db.Products.Where(a => a.ProductName == productName);
        return View(products);
    }

并添加相应的视图，代码如下

Search.cshtml（空模板）：
注意：这里我们使用了Form表单

@{
    ViewBag.Title = "Search";
}

<h2>Search</h2>

@using (Html.BeginForm("Result", "Products", FormMethod.Get))
{
    <input type="text" name="productName" class="form-control" />
    <br />
    <input type="submit" value="search" class="btn btn-default" />
}

Result.cshtml（List模板）：

@model IEnumerable<MyFirstMvcProject.Models.Product>

@{
    ViewBag.Title = "Result";
}

<h2>Result</h2>

<p>
    @Html.ActionLink("Create New", "Create")
</p>
<table class="table">
    <tr>
        <th>
            @Html.DisplayNameFor(model => model.ProductName)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.Description)
        </th>
        <th>
            @Html.DisplayNameFor(model => model.Price)
        </th>
        <th></th>
    </tr>

@foreach (var item in Model) {
    <tr>
        <td>
            @Html.DisplayFor(modelItem => item.ProductName)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.Description)
        </td>
        <td>
            @Html.DisplayFor(modelItem => item.Price)
        </td>
        <td>
            @Html.ActionLink("Edit", "Edit", new { id=item.Id }) |
            @Html.ActionLink("Details", "Details", new { id=item.Id }) |
            @Html.ActionLink("Delete", "Delete", new { id=item.Id })
        </td>
    </tr>
}
</table>

启动项目，将URL定位到/Products/Search，效果如下：

在文本框中输入MateBookX，点击search按钮，得到查询结果。

通过以上示例，我们已经成功的使用表单实现了一个产品查询的功能。

HTML辅助方法

辅助方法简介

　　每一个Razor视图都继承了它们基类的Html属性，Html属性的类型是System.Web.Mvc.HtmlHelper<T>，这里的T是一个泛型类型的参数，代表传递给视图的模型类型。这个属性提供了一些实例方法，然而，如BeginForm等大多数辅助方法都是通过扩展方法实现的,ASP.NET MVC所有的HtmlHelper扩展方法都在命名空间System.Web.Mvc.Html中。

在智能感知窗口中，左边有个向下箭头就说明这个方法是一个扩展方法。

下面，我们将介绍一些常用的辅助方法：

• Html.TextBox
  TextBox辅助方法渲染一个type特性为text的input标签。
  调用方法：@Html.TextBox("Title","This is Value")
  生成HTML标记：<input id="Title" name="Title" type="text" value="This is Value" />
• Html.TextArea
  TextArea渲染一个能够显示多行文本的<textarea>元素。
  调用方法：@Html.TextArea("text","Hello ! This is Text Area !")
  生成HTML标记：<textarea cols="20" id="text" name="text" rows="2"> Hello ! This is Text Area !</textarea>
• Html.Label
  Label辅助方法返回一个<label/>元素，并使用String类型的参数来决定渲染的文本。
  调用方法：@Html.Label("Name")
  生成HTML标记：<label for="Name">Name</label>
  Name
• Html.DropDownList和Html.ListBox
  DropDownList和ListBox辅助方法都返回一个<select/>元素。DropDownList允许进行单项选择，而ListBox支持多项选择。修改ProductsController中的Search方法

  public ActionResult Search()
  {
      var products = db.Products.Single(a => a.ProductName == "Apple Pencil");
      ViewBag.Products = new SelectList(db.Products.OrderBy(g => g.Price), "Id", "ProductName", products.Id);
      return View();
  }

  并在相应的View中添加辅助方法DropDownList，效果如下：

  @Html.DropDownList("Products", String.Empty)

  

• Html.ValidationMessage
  当ModelState字典中的某一特定字段出现错误时，可以使用ValidationMessage辅助方法来显示相应的错误提示信息。修改ProductsController中的Search方法

  public ActionResult Search()
  {
      var products = db.Products.Single(a => a.ProductName == "Apple Pencil");
      ViewBag.Products = new SelectList(db.Products.OrderBy(g => g.Price), "Id", "ProductName", products.Id);
      ModelState.AddModelError("Title", "Support domestic products!");
      return View();
  }

  在相应的视图中添加下面这行代码显示错误提示信息，效果如下：

  @Html.ValidationMessage("Title")

  

强类型辅助方法

　　如果不习惯使用字符串字面值从视图数据中提取值的话，可以使用ASP.NET MVC提供的各种强类型辅助方法。使用强类型辅助方法，只需要为其传递一个lambda表达式来指定要渲染的模型属性。我们以上一节中的DropDownList为示例，修改View中的代码，首先，在视图顶部输入如下所示的代码：

@model MyFirstMvcProject.Models.Product

使用下面的代码重写DropDownList：

@Html.DropDownListFor(m => m.Id, ViewBag.Products as SelectList)

效果如下：

注意，强类型的辅助方法名称除了有For后缀外，与先前介绍的辅助方法名相同。使用强类型辅助方法的优点是能够获取智能感知以及编译时检查。

渲染辅助方法

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

• Html.ActionLink和Html.RouteLink
  ActionLink辅助方法能够渲染一个超链接，指向另一个控制器。如下是Products/Details视图中的一段示例，如果没有指定控制器，就返回当前视图对应的控制器：

  @Html.ActionLink("Back to List", "Index")

  RouteLink辅助方法只可以接受路由名称，而不能接受控制器名称和操作名称。

  @Html.RouteLink("Back to List", new { Action = "Index"})

• Url.Action、Url.RouteUrl和Url.Content
  URL辅助方法与HTML的ActionLink和RouteLink辅助方法相似，但它不以HTML标记的形式返回构建的URL，而是以字符串的形式返回这些URL。
  RouteUrl辅助方法与RouteLink一样，只接受路由名称，而不接受控制器名称和操作名称。
  Content辅助方法可以把应用程序的相对路径转换成绝对路径。
• Html.Partial和Html.RenderPartial
  Partial和RenderPartial都是渲染一个部分视图，都不使用Controller，Partial回传一个MvcHtmlString，所以可以把结果保存在变量之中，RenderPartial没有返回值，直接写入响应输出流当中。

  @Html.Partial("PartialViewName")
  @{ Html.RenderPartial("PartialViewName"); }

• Html.Action和Html.RenderAction
  Action和RenderAction类似于Partial和RenderPartial，但这两个方法都用到Controller之后再回传一个页面，可以在Controller方法上添加ChildActionOnly特性，防止页面直接被浏览。