ASP.NET服务器控件开发（1）封装html

在我们的项目开发中，由于asp.net的服务器控件功能有限，所以我们经常会自己定义特定的服务器控件，来满足开发中特定的业务要求。可见知道如何开发asp.net服务器控件是非常有必要的。

其实简单的实现asp.net服务器控件不是很难，以前园子中也有大牛介绍过相应的内容，这里站在巨人的肩膀上也来分享下开发asp.net服务器控件的方法和自己的一些体会。写给新手，高手绕过。

学习asp.net的服务器控件开发，个人认为最好的方式就是自己去实践，当然理论知识也是很重要的，但是如果我们只是看理论的知识，可能会被里面的一些概念闹糊涂，看着看着就睡着了，如果自己动手创做出一个自己的控件，效果就不一样了。

下面就通过实例创建一个简单的服务器控件：

首先我们创建一个类库工程selfwebcontrol。在同一解决方案中我们在创建一个asp,net web应用程序（用来测试我们得控件）

namespace selfwebcontrol
{
  public class controla:control//control类中定义了所有asp.net服务器控件共享的属性和方法
  {

  }
}

我将controla类继承control类，control类是.net中所有控件的基类，其中包含了控件共有的属性和方法。

control类

公共属性：

clientid 获取由 asp.net 生成的服务器控件标识符。

controls 获取 controlcollection 对象，该对象表示 ui 层次结构中指定服务器控件的子控件。

enableviewstate 获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。

id 获取或设置分配给服务器控件的编程标识符。

namingcontainer 获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 control.id 属性值的服务器控件。

page 获取对包含服务器控件的 page 实例的引用。

parent 获取对页 ui 层次结构中服务器控件的父控件的引用。

site 获取有关服务器控件所属 web 站点的信息（原文自msdn,但是我认为不对，应该是指组件的“容器”站点，并非 web site）。

templatesourcedirectory 获取包含当前服务器控件的 page 或 usercontrol 的虚拟目录。

uniqueid 获取服务器控件的唯一的、以分层形式限定的标识符。

visible 获取或设置一个值，该值指示服务器控件是否作为 ui 呈现在页上。

公共方法：

databind 将数据源绑定到被调用的服务器控件及其所有子控件。

dispose 使服务器控件得以在从内存中释放之前执行最后的清理操作。

equals（从 object 继承） 已重载。确定两个 object 实例是否相等。

findcontrol 已重载。在当前的命名容器中搜索指定的服务器控件。

gethashcode（从 object 继承） 用作特定类型的哈希函数，适合在哈希算法和数据结构（如哈希表）中使用。

gettype（从 object 继承） 获取当前实例的 type。

hascontrols 确定服务器控件是否包含任何子控件。

rendercontrol 将服务器控件的内容输出到所提供的 htmltextwriter 对象中；如果已启用跟踪功能，则存储有关控件的跟踪信息。

resolveurl 根据传递给 templatesourcedirectory 属性的值，将相对 url 解析为绝对 url。

tostring（从 object 继承） 返回表示当前 object 的 string。

公共事件：

databinding 当服务器控件绑定到数据源时发生。

disposed 当从内存释放服务器控件时发生，这是请求 asp.net 页时服务器控件生存期的最后阶段。

init 当服务器控件初始化时发生；初始化是控件生存期的第一步。服务器控件应执行任何创建和设置实例所需的初始化步骤。在该事件内无法使用视图状态信息；它尚未填充。在该事件的生存期内不应访问其他服务器控件，不论它是此控件的子级还是父级。不一定会创建其他服务器控件，也不一定能够访问它们。

load 当服务器控件加载到 page 对象中时发生。通知服务器控件执行任何设置为在每次页请求时发生的处理步骤。开发者可以访问视图状态信息并利用该事件形成 post 数据。还可以访问页控件层次结构内的其他服务器控件。

prerender 当服务器控件将要呈现给其包含的 page 对象时发生。使用该事件在服务器控件呈现给页的输出之前执行任何更新。在该事件的生存期内可以保存服务器控件视图状态的任何更改。不保存呈现阶段内所做的同样更改。

unload 当服务器控件从内存中卸载时发生。

保护的属性：

childcontrolscreated 获取一个值，该值指示是否已创建服务器控件的子控件。

context 为当前 web 请求获取与服务器控件关联的 httpcontext 对象。

events 获取控件的事件处理程序委托列表。此属性为只读。

haschildviewstate 获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。

istrackingviewstate 获取一个值，该值指示服务器控件是否将更改保存到其视图状态。

viewstate 获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。

viewstateignorescase 获取一个值，该值指示 statebag 对象是否不区分大小写。

受保护的方法：

addparsedsubobject 通知服务器控件某个元素（xml 或 html）已经过语法分析，并将该元素添加到服务器控件的 controlcollection 对象。

clearchildviewstate 删除服务器控件的所有子控件的视图状态信息。

createchildcontrols 通知使用基于合成的实现的服务器控件创建它们包含的任何子控件，以便为回发或呈现做准备。

createcontrolcollection 创建一个新的 controlcollection 对象来保存服务器控件的子控件（包括文本控件和服务器控件）。

ensurechildcontrols 确定服务器控件是否包含子控件。如果不包含，则创建子控件。

finalize（从 object 继承） 已重写。允许 object 在“垃圾回收”回收 object 之前尝试释放资源并执行其他清理操作。

isliteralcontent 确定服务器控件是否只包含文字内容。asp.net页面中普通的html标签被asp.net编译为一个 literalcontent控件（意味着轻型控件）。

loadviewstate 从 saveviewstate 方法保存的上一个页请求还原视图状态信息。

mappathsecure 如果请求服务器控件有足够的安全权限读取映射结果，检索相对于源文件的映射物理文件路径。

memberwiseclone（从 object 继承） 创建当前 object 的浅表副本。

onbubbleevent 确定服务器控件的事件是否沿页的 ui 服务器控件层次结构向上传递。

ondatabinding 引发 databinding 事件。

oninit 引发 init 事件。

onload 引发 load 事件。

onprerender 引发 prerender 事件。

onunload 引发 unload 事件。 注意 在服务器控件生存期的此阶段，服务器控件应执行所有最后的清理操作，例如关闭文件、关闭数据库连接和丢弃对象。

raisebubbleevent 将所有事件源及其信息分配给控件的父级。

render 将服务器控件内容发送到提供的 htmltextwriter 对象，此对象编写将在客户端呈现的内容。

renderchildren 将服务器控件子级的内容输出到提供的 htmltextwriter 对象，此对象编写将在客户端呈现的内容。

saveviewstate 保存自页回发到服务器后发生的任何服务器控件视图状态更改。

trackviewstate 导致跟踪服务器控件的视图状态的更改，以便这些更改可以存储到服务器控件的 statebag 对象中。通过 control.viewstate 属性可访问此对象。

这里我们要重写render方法，通过htmltextwriter 对象将控件中的内容显示出去。

namespace selfwebcontrol
{
  public class controla:control//control类中定义了所有asp.net服务器控件共享的属性和方法
  {
    protected override void render(htmltextwriter writer)
    {
      writer.write("<table style='width:300px; height:200px; background-color:bisque'>");
      writer.write("<tr>");
      writer.write("<td>这是第一列</td>");
      writer.write("<td>这是第二列</td>");
      writer.write("<td>这是第三列</td>");
      writer.write("</tr>");
      writer.write("</table>");
    }
  }
}

生成我们得selfwebcontrol工程，再切换到asp.net应用程序的工具箱时，vs2008会自动的将我们刚刚创建的controla添加到工具箱中，避免了我们以前通过选择项添加控件的过程。

这样，我们就已最简单的形式实现了一个asp.net服务器控件。但是如果我想修改表格的宽度，高度，背景色该怎么改呢？

这就需要我们定义服务器控件的属性。大家也都知道，asp.net的服务器控件有很多属性，而我们现在的控件只有公有的几个属性。

先来看看我们做了那些改动：

public class controla:control//control类中定义了所有asp.net服务器控件共享的属性和方法
  {
    private int _twidth;
    private int _theight;
    private string _bgcolor;

    
    [browsable(true)]//在属性窗口中是否可见
    [category("appearance")]//属性的分类，如，行为，外观，大家可以在属性窗口看见这样的分类
    [defaultvalue(100)]//属性的默认值
    [description("表格宽度")]//这些是显示在属性窗口底下的
    public int twidth
    {
      get { return _twidth; }
      set { _twidth = value; }
    }

    [browsable(true)]
    [category("appearance")]
    [defaultvalue(100)]
    [description("表格高度")]
    public int theight
    {
      get { return _theight; }
      set { _theight = value; }
    }

    [browsable(true)]
    [category("appearance")]
    [defaultvalue("bisque")]
    [description("表格背景颜色")]
    public string bgcolor
    {
      get { return _bgcolor; }
      set { _bgcolor = value; }
    }

    protected override void render(htmltextwriter writer)
    {
      writer.write("<table style='width:" + twidth + "px; height:"+theight+"px; background-color:"+bgcolor+"'>");
      writer.write("<tr>");
      writer.write("<td>这是第一列</td>");
      writer.write("<td>这是第二列</td>");
      writer.write("<td>这是第三列</td>");
      writer.write("</tr>");
      writer.write("</table>");
    }
  }

代码很简单，想必大家都能看懂，值得注意的就是对每一个属性的声明。需要引用命名空间：using system.componentmodel;每一个标签的作用我已经在代码中做了说明，这样我们就为我们得控件添加了属性.

还要说明一点的就是，如果我们想在把控件拖到页面中时标签内自动的添加一些属性，需要添加下面的代码：

[toolboxdata("<{0}:controla runat='server' bgcolor='red' theight='200' twidth='300'></{0}:controla>")]

值得注意的是这里的写法，{0}的冒号中之后的那个"controla“就是类的名字，不要写错。还有runat='sever'一定要写。

是不是很简单，这样，我们只是封装了简单的html来完成asp.net控件的制作。

小结：简单的制作一个asp.net的服务器控件很简单，但是光只是通过html的输出有的时候意义不大，这里只是介绍一种方法和思路。打开学习定制自己的asp.net控件的第一扇门。在以后的文章中我会介绍针对于继承webcontrol开发asp.net控件。