HtmlHelper用法大全(下)
目錄:
- 說明
- Form表單
- 使用TagBuilder創(chuàng)建自定義標簽
- 強類型HtmlHelper
- LabelFor數(shù)據(jù)標簽
- DisplayFor 和 EditorFor顯示和編輯Model數(shù)據(jù)
- 思考題
說明
本節(jié)接續(xù)上一節(jié)MVC5 + EF6 + Bootstrap3 (8) HtmlHelper用法大全(上),繼續(xù)討論HtmlHelper的用法。
下面所有HtmlHelper代碼均寫在Views文件夾下DefaultController文件夾里的DefaultAction.cshtml文件中。這個View文件對應(yīng)一個名為DefaultController的控制器。
Form表單
在HtmlHelper中生成表單Form會用到兩個函數(shù):BeginForm和EndForm。有兩種方法可以生成<form>...</form>表單,使用方法如下所示:
@using (Html.BeginForm("actionName", "controllerName", FormMethod.Get)) {@Html.TextBox("NameId")<input type="submit" value="SubmitButton" /> }@{Html.BeginForm("actionName", "controllerName", FormMethod.Post);}@Html.TextBox("NameId")<input type="submit" value="SubmitButton" /> @{Html.EndForm();}我們在Form中寫入了一個TextBox和一個提交按鈕。TextBox的HtmlHelper用法上一節(jié)已經(jīng)講過,而比較奇特的是提交按鈕沒有對應(yīng)的HtmlHelper函數(shù)來生成,需要用HTML語言直接寫。后面我們會解決這個問題。
仔細看上面兩種生成Form方法的區(qū)別:第一種方法將Html.BeginForm()函數(shù)放入@using (){}結(jié)構(gòu)中這種方法可以直接生成form的開始標記和結(jié)束標記;第二種方法先寫Html.BeginForm()函數(shù)生成開始標記,再在最后寫Html.EndForm()函數(shù)生成結(jié)尾標記。這兩種方法生成的結(jié)果是一樣的。結(jié)果如下:
<form action="/controllerName/actionName" method="get"><input id="NameId" name="NameId" type="text" value="" />
<input type="submit" value="SubmitButton" /> </form>
<form action="/controllerName/actionName" method="post"> <input id="NameId" name="NameId" type="text" value="" /><input type="submit" value="SubmitButton" /> </form>
從運行結(jié)果可以看出BeginForm()的第一個參數(shù)指定Action的名字,第二個參數(shù)指定Controller的名字,第三個參數(shù)指定提交的時候是用Post方法還是Get方法。上面代碼中第一個Form用的是Get方法,第二個Form用的是Post方法。
使用TagBuilder創(chuàng)建自定義標簽
前面說到?jīng)]有提交按鈕對應(yīng)的HtmlHelper函數(shù),那么我們就自己動手創(chuàng)建一個。
上帝關(guān)上了一扇門,就一定會為我們打開一扇窗。這個窗戶就是TagBuilder。顧名思義,TagBuilder就是標簽建造器,我們就用它來建造屬于我們自己標簽生成函數(shù)。
首先在項目中創(chuàng)建一個Classes文件夾,用來存放我們將要創(chuàng)建的類。在這個文件夾中創(chuàng)建一個名為HtmlExtensions.cs的類,這個類名不是強制性的,寫什么都可以。在這個類中寫入如下代碼:
using System.Web.Mvc; public static class HtmlExtensions {/// <summary>/// 自定義一個@html.Submit()/// </summary>/// <param name="helper"></param>/// <param name="value">value屬性</param>/// <returns></returns>public static MvcHtmlString Submit(this HtmlHelper helper, string value){var builder = new TagBuilder("input");builder.MergeAttribute("type", "submit");builder.MergeAttribute("value", value); return MvcHtmlString.Create(builder.ToString(TagRenderMode.SelfClosing));}
}
我們來解讀一下上面的代碼:
- 首先,要用TagBuilder就要引入System.Web.Mvc類庫。
- 接著我們看這個函數(shù)的參數(shù),this HtmlHelper helper保證這個方法會被添加到HtmlHelper中,string value對應(yīng)將來的提交按鈕顯示的文字,也就是value屬性。
- var builder = new TagBuilder("input");使我們創(chuàng)建的標簽名字設(shè)為input。
- MergeAttribute函數(shù)給創(chuàng)建出的元素添加屬性,如MergeAttribute("type", "submit") 就是加入 type="submit" 屬性。
- TagRenderMode.SelfClosing使生成的標簽自我關(guān)閉,也就是說有<input />這種形式。
- 最后用MvcHtmlString作為返回值是為了使返回值不被轉(zhuǎn)義,比如"<"不會被轉(zhuǎn)成"<"。這是我們不想看到的。
然后我們在View中寫入下面代碼調(diào)用剛才寫好的函數(shù):
@Html.Submit("SubmitButton")生成結(jié)果如下:
<input type="submit" value="SubmitButton" />可以看到我們在函數(shù)中所設(shè)置的標簽名、屬性、自包含都做到了。這樣我們就成功生成了自創(chuàng)的submit按鈕。
強類型HtmlHelper
HtmlHelper有強類型和弱類型之分。前面所介紹的這些函數(shù)統(tǒng)統(tǒng)都是弱類型的。那么強類型和弱類型有什么區(qū)別?簡單點說就是強類型會用到MVC中的Model,而弱類型不用。
Htmlhelper中幾乎每一個弱類型函數(shù)都會對應(yīng)一個強類型函數(shù),它們的對應(yīng)關(guān)系是強類型函數(shù)名比弱類型函數(shù)名多了一個For。比如TextBox()是一個弱類型函數(shù),那么其對應(yīng)的強類型函數(shù)就是TextBoxFor()。
后面的部分我們需要借助Model來展示代碼,因此在解決方案中的Models文件夾中創(chuàng)建一個簡單的Model,就叫Simple類。文件名為Simple.cs代碼如下:
namespace SlarkInc.Models {public class Simple{public string Name{ get; set; }} }既然是一個簡單的Model,那我們就只給它一個屬性:Name。
創(chuàng)建好這個Model之后我們就可以在Controller中給這個Model初始化并賦值,并把它傳遞給View來為我們的強類型HtmlHelper做準備。編輯DefaultControllerController.cs文件,寫入如下代碼:
using System.Web.Mvc; using SlarkInc.Models;namespace SlarkInc.Controllers {public class DefaultControllerController : Controller{// GET: /DefaultController/public ActionResult DefaultAction(){Simple s = new Simple();s.Name= "Slark";return View(s);}} }圖中黃色部分初始化Model,給Model賦值并將Model傳遞給View。
下面我們就在View中用強類型HtmlHelper將Model中的數(shù)據(jù)顯示出來。從上面的代碼可以看出DefaultController調(diào)用的是名為DefaultAction的View。因此我們在Views文件夾下找到DefaultController文件夾,編輯其中的DefaultAction.cshtml文件。在文件第一行加入如下代碼:
@model SlarkInc.Models.Simple這行代碼表示這個View用的是Simple這個Model。
然后在文件中插入如下代碼:
@Html.TextBoxFor(m =>m.Name)這就是我們的強類型HtmlHelper函數(shù)的一個例子TextBoxFor。這個函數(shù)只有一個參數(shù)m =>m.Name。這里的m可以換成其他名字,它都指代我們這里的Model。TextBoxFor的這個參數(shù)的意思就是取Model的Name屬性。由于我們在Controller中初始化了這個值,那么這個值應(yīng)該是"Slark"。運行結(jié)果如下。
<input id="Name" name="Name" type="text" value="Slark" />由上面結(jié)果可以看出,屬性的名字Name被賦值給了這個元素的id和name,屬性值Slark賦值給了value屬性。這樣我們就完成了一個簡單的強類型HtmlHelper。
LabelFor數(shù)據(jù)標簽
強類型的一大好處是我們可以通過改動Model而改變這個Model在所有View中的顯示。如下圖的一個輸入框:
怎么樣可以通過改動Model來改動輸入框前面的文字呢?這里我們就要用到DataAnnotations,有人叫它元數(shù)據(jù),或者叫數(shù)據(jù)批注。簡單來說它就是對數(shù)據(jù)的描述。之后用HtmlHelper的LabelFor就可以讀到這個信息并顯示出來。我們把之前的Simple類寫成如下樣子:
using System.ComponentModel.DataAnnotations; namespace SlarkInc.Models { public class Simple{[Display(Name = "Name")]public string Name { get; set; }[Display(Name = "E-mail")]
public string Email { get; set; }} }
代碼中黃色的部分就是我們?yōu)榱耸褂迷獢?shù)據(jù)而增加的代碼。第一行的部分是引入了要使用元數(shù)據(jù)所需要的類庫。[Display(Name = "E-mail")]這一行表示當要顯示這個變量的名字的時候我們顯示"E-mail"這個字符串。HtmlHelper函數(shù)LabelFor()正是從這里獲取到需要顯示的字符串。
在DefaultController中我們要給Email變量賦值,代碼如下:
using System.Web.Mvc; using SlarkInc.Models;namespace SlarkInc.Controllers {public class DefaultControllerController : Controller{// GET: /DefaultController/public ActionResult DefaultAction(){Simple s = new Simple();s.Name = "Slark";s.Email = "xxx@163.com";return View(s);}} }在對應(yīng)的View中寫下如下代碼:
@Html.LabelFor(m => m.Email) : @Html.TextBoxFor(m => m.Email)黃色標記的LabelFor函數(shù)獲得的參數(shù)是Simple類的Email屬性,LabelFor函數(shù)就會去尋找Model中對應(yīng)Email的屬性的Display元數(shù)據(jù),進而生成結(jié)果如下:
<label for="Email">E-mail</label> : <input id="Email" name="Email" type="text" value="xxx@163.com" />看生成的結(jié)果LabelFor函數(shù)會生成<Label>標簽,并且其屬性for的值對應(yīng)變量名"Email",而標簽的內(nèi)部文字InnerText就是Display元數(shù)據(jù)的Name屬性對應(yīng)的值"E-mail"。
DisplayFor 和 EditorFor顯示和編輯Model數(shù)據(jù)
元數(shù)據(jù)在ASP.NET MVC的一個最主要的應(yīng)用就是可以通過Model來控制數(shù)據(jù)顯示和修改時所生成的HTML元素的類型。在HtmlHelper中DisplayFor是用來顯示數(shù)據(jù)的,而EditorFor是用來編輯數(shù)據(jù)的。它們都會根據(jù)元數(shù)據(jù)對數(shù)據(jù)的描述生成不同類型的HTML元素。
將Simple改成如下代碼:
using System.ComponentModel.DataAnnotations; namespace SlarkInc.Models { public class Simple{[Display(Name = "Name")] public string Name { get; set; }[Display(Name = "E-mail")][DataType(DataType.EmailAddress)]public string Email { get; set; }} }
代碼中黃色部分是對Email數(shù)據(jù)類型的描述。它的數(shù)據(jù)類型是郵件地址EmailAddress。在View中寫下如下代碼:
@Html.DisplayFor(m => m.Email) @Html.EditorFor(m => m.Email)DisplayFor和EditorFor都將Model的Email屬性作為自己的參數(shù)。運行結(jié)果如下:
對應(yīng)的代碼如下:
<a href="mailto:xxx@163.com">xxx@163.com</a> <input class="text-box single-line" id="Email" name="Email" type="email" value="xxx@163.com" />?從結(jié)果中可以看到由于數(shù)據(jù)類型是EmailAddress,其在顯示數(shù)據(jù)時就生成了一個發(fā)送郵件的超鏈接。在編輯數(shù)據(jù)時就生成了一個email專用的輸入框<input type="email">。
思考題
學(xué)而不思則罔,思而不學(xué)則殆。這里出幾個思考題供大家檢驗學(xué)習效果。
1.HtmlHelper生成Form有幾種方法?分別怎么寫?
2.如何自定義一個能生成<img>元素的HtmlHelper函數(shù)。
3.LableFor、DisplayFor、EditorFor函數(shù)用法有什么異同?
總結(jié)
以上是生活随笔為你收集整理的HtmlHelper用法大全(下)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 什么是GSM,CDMA和3G?
- 下一篇: js移动数组元素