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

接上篇，我们下面通过HtmlFiledSet helper来展示何时使用EndView():

    如果你用Asp.net已经有一段时间了，那使用Html.BeginForm helper来创建HTML form标签的方式会让你觉得有点怪.当你创建一个新的Asp.net mvc项目后，在View里的ChangePassword.aspx会默认被创建，这个页面使用了Html.BeginForm helper,下面是使用这个helper的代码段:

<% using (Html.BeginForm()) { %> 
    <div> 
        <fieldset> 
            <legend>Account Information</legend> 
            <p> 
                <label for="currentPassword">Current password:</label> 
                <%= Html.Password("currentPassword") %> 
                <%= Html.ValidationMessage("currentPassword") %> 
            </p> 
            <p> 
                <label for="newPassword">New password:</label> 
                <%= Html.Password("newPassword") %> 
                <%= Html.ValidationMessage("newPassword") %> 
            </p> 
            <p>                 <label for="confirmPassword">Confirm new password:</label> 
                <%= Html.Password("confirmPassword") %> 
                <%= Html.ValidationMessage("confirmPassword") %> 
            </p> 
            <p> 
                <input type="submit" value="Change Password" /> 
            </p> 
        </fieldset> 
    </div> 
<% } %> 

上面代码中你会发现Html.BeginForm的使用和<%=Html.Password(“currentPassword”) %>的使用不尽相同，也就是Html.BeginForm在using语句中被调用,这点很有意思，让我先来看看上面代码段生成后的Html,如下：

<form  
  action="/Account/LogOn?ReturnUrl=%2fAccount%2fChangePassword"  
  method="post"> 
  <div> 
    <fieldset> 
      <legend>Account Information</legend> 
      <p> 
        <label for="username">Username:</label> 
        <input id="username" name="username" type="text" value="" />   
      </p> 
      <p> 
        <label for="password">Password:</label> 
        <input id="password" name="password" type="password" />   
      </p> 
      <p> 
        <input id="rememberMe" name="rememberMe" type="checkbox" value="true" /> 
        <input name="rememberMe" type="hidden" value="false" /> 
        <label class="inline" for="rememberMe">Remember me?</label> 
      </p> 
      <p> 
        <input type="submit" value="Log On" /> 
      </p> 
    </fieldset> 
  </div> 
</form> 

比较<%= Html.Password("currentPassword") %> 语句和Html.BeginForm所生成的HTML代码你会发现password那段仅仅仅仅将调用password扩展方法变成对应的Html，而BeginForm调用HTML扩展方法来注入form的开始标签，<form…>，和using语句结束时(“}”)注入标签<./form>.这种方式十分方便，因为我们可以一方面使用view helper创建合适的form标签，另一方面在form标签内插入任何我们想插入的html.这种方法的工作原理是当你调用Html.BeginForm方法并返回MvcForm类型的对象,这个对象在using语句中所以当对象被回收(译者按：也就是Dispose)的时候，也就是执行到结尾的”<% } %>”时，关闭标签</form>将会被写入到View中.下面是Dispose方法的实现:

public void Dispose() { 
    Dispose(true /* disposing */); 
    GC.SuppressFinalize(this); 
} 
 
protected virtual void Dispose(bool disposing) { 
    if (!_disposed) { 
        _disposed = true; 
        _httpResponse.Write("</form>"); 
    } 
} 

我们用相似的方法来实现HtmlFieldSet:

从这篇文章附带的代码中有一个”DetailsClassic.aspx”页面中，一些字段包含于fieldset元素中，具体代码如下：

<fieldset class="details-field-group" name="Details"> 
  <legend>Details</legend> 
  <ol> 
    <li> 
      <label for="FirstName">FirstName</label> 
      <span id="FirstName"> 
        <%= Html.Encode(Model.FirstName) %></span>  
    </li> 
    <li> 
      <label for="LastName">LastName</label> 
      <span id="LastName"><%= Html.Encode(Model.LastName) %></span> 
    </li> 
    <li> 
      <label for="Email">Email</label> 
      <span id="Email"><%= Html.Encode(Model.Email) %></span> 
    </li> 
    <li> 
      <label for="Phone">Phone</label> 
      <span id="Phone"><%= Html.Encode(Model.Phone) %></span> 
    </li> 
    <li> 
      <label for="Gender">Gender</label> 
      <span id="Gender"><%= Html.Encode(Model.Gender) %></span> 
    </li> 
  </ol> 
</fieldset> 

如果能用一个view helper来创建下面所有的html标签，那会惬意很多：

• fieldset的开始标记
• legend标签
• ol的开始标签
• ol的结束标签
• fieldset的结束标签

如果能用view helper来处理这些，那上面那段代码无疑会简单很多,尤其再加上使用Html.Text标签来代替上面的text域。让我们开始做到这一点，首先创建一个实现IViewObject接口的类，命名为HtmlFieldSet类并继承与AbstractHtmlViewObject，整个类的代码附下：

public class HtmlFieldset : AbstractHtmlViewObject 
{ 
    private readonly string mTitle; 
 
    public HtmlFieldset( 
        ViewRequestContext requestContext, string name,  
        string title, object attributes) 
        : base(requestContext, name) 
    { 
        mTitle = title; 
        Attributes = attributes; 
    } 
 
    private TagBuilder FieldsetTag { get; set; } 
 
    private TagBuilder OlTag { get; set; } 
 
    public override void StartView() 
    { 
        HttpResponseBase httpResponse = RequestContext.HttpResponse; 
 
        FieldsetTag = new TagBuilder("fieldset"); 
 
        // apply any Attributes passed in 
        if (Attributes != null) 
        { 
            FieldsetTag.MergeAttributes(new RouteValueDictionary(Attributes)); 
        }  
        // The Name property should override any passed into the Attributes 
        FieldsetTag.MergeAttribute("name", Name, true); 
 
        httpResponse.Write(FieldsetTag.ToString(TagRenderMode.StartTag)); 
 
        if (!string.IsNullOrEmpty(mTitle)) 
        { 
            TagBuilder legendTag = new TagBuilder("legend"); 
            legendTag.SetInnerText(mTitle); 
            httpResponse.Write(legendTag.ToString(TagRenderMode.Normal)); 
        } 
 
        OlTag = new TagBuilder("ol"); 
        httpResponse.Write(OlTag.ToString(TagRenderMode.StartTag)); 
    } 
 
    public override void EndView() 
    { 
        HttpResponseBase httpResponse = RequestContext.HttpResponse; 
 
        httpResponse.Write(OlTag.ToString(TagRenderMode.EndTag)); 
        httpResponse.Write(FieldsetTag.ToString(TagRenderMode.EndTag)); 
    } 
} 

这个类的实现和其它的view对象没什么不同，除了EndView方法，在这里我们需要EndView方法来生成必须的结束标记。当然我们也可以使用EndView来生成任何需要的HTML,在这里我们仅是用它生成结束标记。

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

待续…

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

translated by CareySon