【译】使用自定义ViewHelper来简化Asp.net MVC view的开发－－－－－－part2

核心提示： 接上篇…首先让我们来看如何创建一个我们先前讨论的textbox 我们已经知道需要创建的textbox有一个文本值与之对应：文本值在label标签中 可选的值放在Textbox中 可选的验证信息（validation message） 如果上面3个条件都能满足，肯定也能满足我们在part1里的那5个条件.还有一些锦上添

　 接上篇…首先让我们来看如何创建一个我们先前讨论的textbox

　　 我们已经知道需要创建的textbox有一个文本值与之对应：

文本值在label标签中
可选的值放在Textbox中
可选的验证信息（validation message）
　　　如果上面3个条件都能满足，肯定也能满足我们在part1里的那5个条件.还有一些锦上添花的是可以通过属性来指定textbox是否包裹在li标签内以及textbox是否是readonly模式.这样我们便能更好的在view page中代码复用。下面的代码包含所有HtmlText(译者按:继承AbstractHtmlViewObject对象，在part1的类图中)对象所有的属性:

PRivate readonly string mLabelText;
private readonly bool mCreateLabel;
private readonly object mValue;
private readonly string mValidationMessage;
private readonly bool mCreateValidationMessage;
private readonly bool mCreateLi;
private readonly bool mReadonly;

public HtmlText(
　　ViewRequestContext requestContext, string name, string labelText, objec
　　string validationMessage, bool @readonly, bool createLi, object attribu
　　: base(requestContext, name)
{
　　mLabelText = labelText;
　　mCreateLabel = !string.IsNullOrEmpty(mLabelText);
　　mValidationMessage = validationMessage;
　　mCreateValidationMessage = !string.IsNullOrEmpty(validationMessage);
　　mCreateLi = createLi;
　　mReadonly = @readonly;
　　Attributes = attributes;

　　object valueToAssign = value;
　　if (valueToAssign == null)
　　{
　　　　// see if the ModelState has a value for this
　　　　valueToAssign = GetModelStateValue(name, typeof(string));
　　}

　　mValue = valueToAssign;
}　　　在构造函数中，我们我们存入一系列私有变量中并初始化了会在StartView方法内使用的一个bool类型,除此之外你可以发现这里开始使用GetModelStateValue方法.目前为止我们先不过多讨论这个方法,这个方法会在后面提到。在参数传入构造器之前我们注意到:

value参数的类型是object
object类型的attributes参数被传入
　　之所以把Value参数定义为object类型是因为这样可以使用户更容易使用并且和asp.net MVC Helpers的执行方式保持一致。attributes参数可以被调用者来扩展生成的HTML。比如说，你想将textbox的maxlength属性设置为5，你只需要传入匿名类型”new {maxlength=5}“.input标签会将这个匿名类型转换为HTML属性maxlength=5.这同时也符合Asp.net MVC中HTML Helper现有扩展方法的使用方式.每一个View helper对象都应该支持这种行为以便具有更大的灵活性.在这个类中剩下的两个方法就是从父类继承来的StartView和EndView方法了.

　　 StartView和EndView的定义如下:

public override void StartView()
{
　　HttpResponseBase httpResponse = RequestContext.HttpResponse;

　　TagBuilder htmlLiTagBuilder = new TagBuilder("li");
　　if (mCreateLi)
　　{
　　　　httpResponse.Write(htmlLiTagBuilder.ToString(TagRenderMode.StartTag));
　　}

　　// write out label if provided
　　if (mCreateLabel)
　　{
　　　　TagBuilder labelTag = new TagBuilder("label");
　　　　labelTag.Attributes.Add("for", Name);
　　　　labelTag.SetInnerText(mLabelText);
　　　　httpResponse.Write(labelTag.ToString(TagRenderMode.Normal));
　　}

　　string stringValue = string.Empty;
　　if (this.mValue != null)
　　{
　　　　stringValue = Convert.ToString(this.mValue, CultureInfo.CurrentCulture);
　　}

　　if (this.mReadonly)
　　{
　　　　TagBuilder textTag = new TagBuilder("span");　　　　 
　　　　textTag.AddCSSClass("readonly-text");
　　　　textTag.SetInnerText(
　　　　　　Convert.ToString(this.mValue, CultureInfo.CurrentCulture));
　　　　httpResponse.Write(textTag.ToString(TagRenderMode.Normal));
　　}
　　else
　　{
　　　　// Use MVC helpers to create the actual text box
　　　　httpResponse.Write(RequestContext.HtmlHelper.TextBox(
　　　　　　Name, this.mValue, Attributes));
　　}

　　if (this.mCreateLi)
　　{
　　　　httpResponse.Write(htmlLiTagBuilder.ToString(TagRenderMode.EndTag));
　　}
}
public override void EndView()
{
　　// Not needed for this element
}

　　 在StartView方法中有很多值得注意的地方，让我们逐个讨论。首先是我们使用System.Web.Mvc.TagBuilder来生成HTML,而不是直接写HTML标签。TagBuilder只能在Asp.net MVC中使用并且我推荐在生成HTML中必须使用TagBuilder而不是直接写HTML标签,下面是TagBuilder的类图:



　　

下表是TagBuilder中一些方法的说明:

名称 描述
AddCssClass 加入css的class名称，如果class已经存在，则后来加入的会和原来的class一起生效
MergeAttribute 这个方法用于添加或者更新tag的属性，这个方法有一个接受replaceExisting参数的重载，默认情况下已经定义的属性不会被重载。
MergeAttributes 同上，只是可以在一个方法内添加或更新所有属性.
SetInnerText 设置标签内的文本
ToString 被重载。用于生成相应的html代码，TagRenderMode枚举类型会控制如何生成HTML标签.



在上面表格的ToString那行，TagRenderMode枚举用于控制TagBuilder生成HTML标签的方式，TagRenderModel如下所示：

TagRenderModel 结果示例
Normal <div name=”Sample01”>Some content here</div>
StartTag <div name=”Sample01”>
EndTag </div>　
SelfClosing <div name=”Sample01” />
　　



　　根据你想创建的HTML标签和你如何使用它，你会发现使用TagRenderModel可以创建出任何你想创建出的HTML.在前面提到的StartView方法内你会发现TagRenderModel被依据不同的条件设置成StartTag,Normal和EndTag等不同的的类型.如果你给InnerHTML属性赋值并用StartTag和EndTag生成它你必须要记住InnerHtml不会被自动生成，你还必须显式的使用InnerHtml属性本身。下面我们来讨论如何创建HtmlHelper扩展方法。

-------------------------------------------

待续…

原文链接：http://mvcviewhelpers.codeplex.com/

translated by CareySon