WEB开发网
开发学院WEB开发ASP 【译】使用自定义ViewHelper来简化Asp.net MVC vi... 阅读

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

 2010-01-08 10:42:47 来源:WEB开发网   
核心提示: 接上篇…首先让我们来看如何创建一个我们先前讨论的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

Tags:使用 定义 ViewHelper

编辑录入:爽爽 [复制链接] [打 印]
赞助商链接