Asp.net 3.5控件和组件开发技术系列—服务器控件属性（二）

Asp.net 3.5控件和组件开发技术系列—服务器控件属性（二）2011-07-09 csdn博客 ChengKing4.4.3.2 使用ControlBuilder解析复杂内容

通过 System.Web.UI.ControlBuilder 类定制页面解析逻辑，可以定制任意类型的标记，而不像重写AddParseSubObject 方法那样限定子标记必须是子控件，且必须有前缀和runat 属性，下面直接通过一个例子来说明一下此类的用法。

首先建立两个文件 ScriptItem.cs 和ScriptItemCollection.cs ，分别定义ScriptItem 类和 ScriptItemCollection 类。其中，ScriptItem 类主要存储用户自定义的客户端脚本命令（JavaScript 块），ScriptItemCollection 可以定义一个集合容器，每个项都是一个ScriptItem 项。与前面讲的集合实现非常类似。这两个类的完整代码如下：

1 ．ScriptItem 类

/// <summary>
/// 获得本书更多内容,请看:
/// http://blog.csdn.net/ChengKing/archive/2008/08/18/2792440.aspx
/// </summary>

private string _Text;
[DefaultValue（""）]
[Editor（"System.ComponentModel.Design.MultilineStringEditor,System.Design", typeof （UITypeEditor））]
[PersistenceMode（PersistenceMode.EncodedInnerDefaultProperty）]
[NotifyParentProperty（true）]
/// <summary>
/// JavaScript脚本块
/// </summary>
public string Text
{
   get
   {
     return _Text;
   }
   set
   {
     _Text = value;
   }
}

该类中的Text 就是用于存储用户定义的脚本块；Editor 元数据特性指定在属性窗口中Text 属性的编辑器是一个下拉块输入编辑器，关于属性编辑器下一节会详细讲解，这里仅知道它的功能即可。

需要注意的是，在上一节使用AddParsedSubObject 实现页面解析子控件时，要嵌套的三个集合的子标记：ListItem ，ListItem2 ，ListItem3 都继承了Control 基类，目的是把这些子标记作为子控件（也就具有了前缀和runat 属性），而这里的ScriptItem 没有继承任何基类，这样就避免了继承一些基类中的冗余属性和方法。

2 ．ScriptItemCollecton 类

/// <summary>
/// 获得本书更多内容,请看:
/// http://blog.csdn.net/ChengKing/archive/2008/08/18/2792440.aspx
/// </summary>

[ToolboxItem（false）]
public class ScriptItemCollection : List<ScriptItem>
{
   public ScriptItemCollection（） : base（） { }
   public ScriptItemCollection（int capacity） : base（capacity） { }
   public ScriptItemCollection（IEnumerable<ScriptItem> collection）:base  （collection） { }
}

定义这两个类之后，实现我们自己的ControlBuilder 类，可以直接继承该类并实现自己的方法，已经预先实现好了的构造器类代码如下所示：

/// <summary>
/// 获得本书更多内容,请看:
/// http://blog.csdn.net/ChengKing/archive/2008/08/18/2792440.aspx
/// </summary>

public class ScriptItemBuilder : ControlBuilder
{
   public override Type GetChildControlType（string tagName, IDictionary  attributes）
   {
     if （string.Compare（tagName.ToLower（）, "scriptitem", false, CultureInfo.  InvariantCulture） == 0）
     {
       return typeof（ScriptItem）;
     }
     return null;
   }
   public override bool AllowWhitespaceLiterals（）
   {
     return false;
   }
}