一、ASP.NET 擴充方法三要素
(1)、靜態類
可以從下圖看出,InputExtension首先是一個靜態類;
(2)、靜態方法
既然是靜態類,那麼其所有的方法必然都是靜態方法,例如:public static MvcHtmlString CheckBox();
(3)、this關鍵字
可以從方法名定義中看出,第一個參數都是this HtmlHelper htmlHelper,代表對HtmlHelper類的擴充;
二、通過 MVC HtmlHelper擴充 執行個體簡單說明擴充步驟
執行個體1、擴充Submit
using System;using System.Collections.Generic;using System.Linq;using System.Web;using System.Web.Mvc;namespace TestMvcHelper{ public static class HtmlExtensions { public static MvcHtmlString Submit(this HtmlHelper helper, string value) { var builder = new TagBuilder("input"); //使我們建立的標籤名字設為input builder.MergeAttribute("type", "submit"); //添加屬性 type="submit" builder.MergeAttribute("value", value); return MvcHtmlString.Create(builder.ToString(TagRenderMode.SelfClosing)); } }}
上述執行個體說明
(1)、在使用TagBuilder需要引入命名空間System.Web.Mvc。
(2)、Submit方法名是對應視圖中調用的名稱。 (如:@Html.Submit("提交") )
(3)、this HtmlHelper
helper 將Submit方法添加到HtmlHelper中,value是傳過來的提交按鈕上的文字。
(4)、var builder = new TagBuilder("input");
設定標籤名字設為input。
(5)、builder.MergeAttribute("type", "submit")
設定標籤屬性type="submit"。
(6)、builder.MergeAttribute("value", value);
設定標籤提交按鈕Value值。
(7)、TagRenderMode.SelfClosing
表示用於呈現自結束標記(例如,<input />)的模式。
(8)、TagRenderMode是個枚舉類,分別為
Normal(表示用於呈現正常文本的模式)
StartTag(表示用於呈現開始標記(例如,<tag>)的模式)
EndTag(表示用於呈現結束標記(例如,</tag>)的模式)
SelfClosing(表示用於呈現自結束標記(例如,<tag />)的模式)。
(9)、MvcHtmlString作為傳回值是為了使傳回值不被轉義,比如"<"不會被轉成"<"。
View中調用
執行個體2、擴充超連結
http://www.CodeHighlighter.com/--> 1 /// <summary>/// 帶描述的連結擴充功能方法/// </summary>/// <param name="htmlHelper">要擴充的HtmlHelper類</param>/// <param name="title">標題</param>/// <param name="url">連結地址</param>/// <param name="description">描述</param>/// <returns>HTML代碼</returns>public static MvcHtmlString LinkWithDescription(this HtmlHelper htmlHelper, string title, string url, string description){ // 產生與標題連結有關的HTML代碼 TagBuilder titleContainer = new TagBuilder("p"); // 標題連結容器p TagBuilder titleLink = new TagBuilder("a"); // 標題中的文字要有連結,所以包含在a標籤內 titleLink.MergeAttribute("href", url); // 為a添加href屬性並指定連結地址 titleLink.SetInnerText(title); // 標題文字 titleContainer.InnerHtml = titleLink.ToString(); // 將a放到p中 titleContainer.AddCssClass("LinkTitle"); // 為標題添加樣式 // 產生與連結描述有關的HTML代碼 TagBuilder descriptionContainer = new TagBuilder("p"); // 串連描述容器p descriptionContainer.InnerHtml = description; // 標題文字 descriptionContainer.AddCssClass("LinkDescription"); // 為描述添加樣式 // 將上述元素放入一個DIV中 TagBuilder div = new TagBuilder("div"); div.InnerHtml = string.Format("{0}{1}", titleContainer.ToString(), descriptionContainer.ToString()); // 返回產生的HTML代碼 return MvcHtmlString.Create(div.ToString());}
視圖中調用
@Html.LinkWithDescription("測試連結1", "#", "這是測試連結1的描述")