简介
Microsoft ASP.NET 为开发人员提供了一种适用于 Web 开发的、功能最为强大的新工具：服务器控件。服务器控件使开发人员能够在短时间内开发出响应速度快而且功能强大的 Web 应用程序，所需的时间与在典型的 ASP 中创建类似应用程序的时间差不多。
ASP.NET 服务器控件之所以能够提供生产效率，关键原因之一在于它为 Microsoft Visual Studio .NET 开发环境中的服务器控件提供了丰富的设计时支持。开发人员可以将服务器控件从 Visual Studio .NET 工具箱拖放到页面上，通过 Properties（属性）窗口访问它们的属性，然后在 Visual Studio HTML 编辑器以及 ASP.NET 页面的内含代码的类中利用 Microsoft IntelliSense? 语句完成功能。这些设计时功能为 Web 开发带来了快速应用程序开发 (RAD) 工具，而这些工具已被 Microsoft Visual Basic? 开发人员使用了多年。
ASP.NET 还使开发人员能够通过创建自定义服务器控件以封装大量可重复使用的用户界面特定的代码（例如登录或注册表单），来进一步提高生产效率。尽管开发人员已经开始意识到开发自定义控件的重要性，但许多人可能还没有意识到还能在控件中利用 Visual Studio 设计时支持的强大功能，使这些控件能够像 ASP.NET 中的内置控件那样易于使用。本文将介绍 Microsoft .NET Framework 和 Visual Studio .NET 提供的设计时支持的类型，并向开发人员介绍如何构建利用这种支持的控件。
阅读目录：
设计时支持的类型
Blog 控件示例
添加设计时支持
设计视图和元数据特性
添加工具箱支持
添加设计器
HTML视图支持：自定义架构和 Visual Studio 注释
小结
附录：
列表1：Blog.vb代码
列表 2：BlogClient.aspx代码
列表 3：BlogClient.aspx.vb代码
列表 4：Blog_DT.vb
列表 5：Blog.xsd
本文章的留言内容：
设计时支持的类型
针对 Visual Studio .NET 中的服务器控件，有五种不同的设计时支持。它们是：
1、内含代码的类中的 IntelliSense
2、设计视图中的属性浏览器支持
3、工具箱支持
4、HTML 视图中的属性浏览器支持
5、HTML 编辑器中的 IntelliSense
这些设计时支持类型是由几个不同的机制提供的。内含代码的类中的 IntelliSense 由 IDE 启用，IDE 为您的控件读取元数据以确定控件所提供的属性和方法及其类型和参数。要启用内含代码的类中的 IntelliSense，只需对您的控件进行编写和编译，然后将其程序集放到使用该控件的应用程序的 bin 子目录中。
Visual Studio .NET 编辑器设计视图中的属性浏览器支持通过以下两个途径提供：将该类型与某个属性相关联和/或将元数据特性与该属性相关联。将元数据特性（下文简称为特性）添加到您的代码中，用于标识属性的类别、提供属性说明以及在需要时指定首选编辑器。有些类型的属性（如 System.Drawing.Color）会自动映射到 Visual Studio .NET 中的相应编辑器中。
Visual Studio .NET 的 HTML 视图中的 IntelliSense 和属性浏览器支持通过使用一种 XSD 架构进行提供，该架构用于描述与控件相关联的类型，它使用称为 Visual Studio 注释的文本修饰指定控件的首选编辑器和其他首选项。
最后，您可以通过结合特性和带有特定属性的自定义位图来支持从 Visual Studio .NET 工具箱拖放控件。
Blog 控件示例
用于说明 Visual Studio .NET 中的设计时功能的控件称作“Blog 控件”，如本文末尾的列表 1 所示。该控件提供利用 XML 作为存储介质的简单 Web 日志功能。Web 日志通常称为 Blog，它实际上是一个 Web 页面，供人们在上面张贴有关日常生活、世态百象、时事政治或人们所关心的其他问题的定期观察报告或评论。Blog 条目是通过 Web 浏览器添加的。
Blog 控件非常简单明了，它利用控件组合向浏览器提供输出。在组合控件中，CreateChildControls 方法（由 ASP.NET 运行时自动调用）会被重写，利用此方法，我们可以创建构成自定义控件 UI 的控件，并将它们添加到控件的“控件”集合中。此外，该控件还包含用于显示和添加 Blog 以及当 XML Blog 存储文件不存在时创建一个这样的文件的逻辑。该控件的几个公共属性需要开发人员在设计时进行设置，其中包括在添加新 Blog 时该控件将重定向到的页面的 URL、与新 Blog 关联的电子邮件地址、控件模式（显示或添加）以及各 Blog 条目之间的分隔线的颜色。图 1 所示为正在运行的 Blog 控件。Add Blog（添加 Blog）超链接由 ASP.NET 超链接控件提供，独立于 Blog 控件。BlogClient.aspx 的代码如列表 2 所示。BlogClient.aspx 的 codebehind 类如列表 3 所示，它提供单击 Add Blog（添加 Blog）链接时更改 Blog 模式的逻辑。
图 1：运行时的 Blog 控件
图2所示为设计时基本 Blog 控件的外观。请注意，虽然列出了属性，但并未分类。
图 2：设计时的 Blog 控件
添加设计时支持
虽然在 Web 窗体页上使用 Blog 控件非常简单，但并不是很直观。例如，如果没有相关文档，使用 Blog 控件的人就无法知道 Mode 属性的有效值只能是 Display 或 Add。如果未将 Add 模式的相关信息明确地告诉使用该控件的开发人员，他们就很难自己发现并使用这种模式。
对于使用 Visual Studio .NET（或支持 IntelliSense 的其他 IDE）的开发人员而言，可以通过为控件添加设计时支持来解决这一问题。这可以通过综合利用本文前面所介绍的方法来实现。在为自定义服务器控件提供设计时支持所面临的挑战中，部分原因来自于在自定义控件中全面支持设计时功能所需的方法的多样性。最简单的、不需要任何附加编码的是内含代码的类中的 IntelliSense 语句完成方法，如图 3 所示，此方法适用于 BlogClient.aspx.vb。
图 3：内含代码的类中的 IntelliSense
遗憾的是，语句完成功能的自动支持并没有扩展到编辑 Web 窗体页时的设计视图或 HTML 视图，而且 Visual Studio 也没有提供不需要额外的控件工作就能在属性浏览器中查看和编辑属性的内置支持。更复杂的是，要在 Web 窗体编辑器的属性浏览器和设计视图中支持 IntelliSense，需要采用一种方法，要在该编辑器的 HTML 视图中支持 IntelliSense，则需要采用另一种方法。
要在设计视图中支持属性浏览，所需的方法是通过特性告诉 Visual Studio .NET 如何处理属性。要在 HTML 视图中支持语句完成和属性浏览，需要生成一个自定义 XSD 架构以描述控件中的类型。我们将在下文讨论这两种方法。
设计视图和元数据特性
Visual Studio .NET 为使用拖放技术的动态控件设计和修改提供了丰富的支持，同时还提供了属性浏览器之类的工具以及相关的设计器（例如颜色选择器）。对这些工具的支持是通过一系列特性提供的，您可以将这些特性添加到您的控件中。这些特性用于告诉 Visual Studio IDE 是否在属性浏览器中显示控件的属性、属性所属的类型以及应使用哪个设计器设置属性的值。
对于将要提供设计时支持的控件版本，我们将制作一份控件文件 Blog.vb 的副本，并将其命名为 Blog_DT.vb，然后在副本文件上进行修改。这样可以生成该控件的设计时版本，并保留原始控件以便进行比较。
要支持在属性浏览器中编辑 AddRedirect 属性，应在属性进程之前添加以下特性，如以下代码片段所示：
＜Browsable(True), _Category("行为"), _Description("成功提交新的 Blog 条目后， " & _"应重定向到的 " & _"页面的 URL。"), _Editor("System.Web.UI.Design.UrlEditor", _GetType(UITypeEditor))＞ _Public Property AddRedirect() As String'属性进程代码End Property
这些特性声明允许在属性浏览器中显示属性、为属性设置所需的类别（当属性按类别排序时）、提供属性说明并告诉 Visual Studio .NET 使用 UrlEditor 类编辑属性的值，如图 4 所示。
图 4：设计视图中的属性支持
此处所述的特性语法适用于 Visual Basic .NET。在 Visual Basic .NET 中，特性通过以下语法进行声明：
＜AttributeName(AttributeParams)＞
在 C# 中，特性采用如下形式：
[AttributeName(AttributeParams)]
Visual Basic .NET 要求特性声明与其修改的成员位于同一行中，因此通常最好在特性后面跟一个 Visual Basic 行接续字符以提高可读性：
＜AttributeName(AttributeParams)＞ _
Public Membername()
在 C# 和 Visual Basic 中，您可以在一对 [ ] 或 ＜＞ 括号中声明多个特性，特性之间用逗号分隔。而在 Visual Basic .NET 中，如果它们出现在不同的行中，则必须使用 Visual Basic 行接续符衔接特性，使其位于同一个语句中。
添加工具箱支持
除了设置属性级别的特性外，还可设置某些类和程序集级别的特性。例如，您可以使用程序集级别的特性 TagPrefix 来指定标记前缀，供程序集中包含的任何控件使用。之后，当您从 Visual Studio 工具箱中向某个 Web 窗体页上添加该控件的实例时，Visual Studio .NET 将自动插入这个标记前缀。以下代码片段显示了 TagPrefix 特性的语法。该特性应放置在定义该控件的类模块内，但应在类和命名空间声明之外（请注意，在 Visual Basic .NET 项目中，命名空间是在项目级别定义的，因此您不用担心如何将程序集特性放置到命名空间声明之外）。在以下特性中，TagPrefix 特性的第一个参数是控件的命名空间，第二个参数是您希望为标记前缀使用的文本。
＜Assembly: TagPrefix("BlogControl", "BlogControl")＞
要将控件集成到 Visual Studio .NET 环境中，应将 ToolBoxData 特性（该特性用于告诉 Visual Studio .NET 从工具箱中为控件插入的首选标记名）添加到实现该控件的类中：
＜ToolboxData("＜{0}:Blog_DT runat=server＞＜/{0}:Blog_DT＞")＞ _Public Class Blog_DTInherits PanelImplements INamingContainer'控件实现End Class
将控件从工具箱中插入到页面上时，由 TagPrefix 特性指定的标记前缀将插入 {0} 占位符，而其他文本将按原样插入。
您还可以为控件提供自己的自定义图标，以显示在工具箱中。为此，需要创建一个 16 x 16 像素大小的位图（左下方的像素采用透明色），其名称与包含该控件的类相同（即 classname.bmp）。使用 Add Existing Item（添加现有项）命令将该位图添加到项目中，然后使用属性浏览器将其 Build Action（创建操作）设置为 Embedded Resource（内置资源），如图 5 所示。
图 5：设置 Build Action（创建操作）
编译完成后，该控件将支持从工具箱中将控件添加到某个页面中时为 Blog 控件自动插入 @Register 指令、标记前缀和标记名，并在工具箱中显示自定义图标，如图 6 所示。要将控件添加到 Visual Studio .NET 工具箱中，应完成以下简单步骤：
1、在设计视图中，选择 Visual Studio .NET 工具箱的 Web forms（Web 窗体）选项卡。
在该选项卡上的任意位置单击鼠标右键，然后选择 Add/Remove Items（添加项目/删除项目）（Visual Studio .NET 2002 中为 Customize Toolbox [自定义工具箱]）。
2、选择 .NET Framework Components（.NET Framework 组件）选项卡，然后单击 Browse（浏览）。
浏览到编译后的控件程序集所在的位置，选中它并单击 Open（打开）。
3、单击 OK（确定）。
图 6：工具箱中的自定义控件
将控件添加到工具箱中后，可以通过双击该控件或将其从工具箱中拖放到 Web 窗体页上，将其添加到 Web 窗体页中。无论何种情况，Visual Studio .NET 都会自动插入正确的 @Register 指令（包括基于程序集级别的特性设置 TagPrefix），还将使用 ToolBoxData 属性中指定的标记名为该控件生成一组标记。
添加设计器
正如前文所述，Blog 控件在 Web 窗体编辑器的设计视图中没有任何可视界面。这使得选择页面上的控件很困难，更难以理解控件在运行时的外观。为了解决这个问题，我们可以添加设计器支持，使设计时的 HTML 在外观上接近于运行时的 Blog 控件。请注意，您还可以生成可以完整再现控件运行时输出的设计器，但此操作相当复杂，而且超出了本文的讨论范围。
所有服务器控件设计器都是从类 System.Web.UI.Design.ControlDesigner 派生而来，该类提供了大量方法，您可以重写这些方法为您的控件提供设计时渲染。以下代码简单重写了 GetDesignTimeHtml 方法，返回设计时显示的简单 HTML。请注意，该示例显示了 Blog 控件的整个设计器类，您可以简单地将其添加到现有的 Blog_DT.vb 类文件中。
Public Class BlogDesignerInherits ControlDesignerPublic Overrides Function GetDesignTimeHtml() As StringReturn "＜h1＞Blog＜/h1＞＜hr/＞＜hr/＞"End FunctionEnd Class
要将该设计器绑定到 Blog_DT 类中，我们使用了 Designer 特性，如以下片段所示。请注意，此段代码还添加了一个描述控件功能的 Description 特性。
＜Description("简单 Blog 控件。支持显示 " & _"Web 日志/来自 XML 文件的新条目。"), _Designer("BlogControl.BlogDesigner"), _ToolboxData("＜{0}:Blog_DT runat=server＞＜/{0}:Blog_DT＞")＞ _Public Class Blog_DTInherits PanelImplements INamingContainer
如您所见，BlogDesigner 类非常简单，但它为控件在 Web 窗体页上的设计时外观添加了大量内容，如图 7 所示。
图 7：添加设计时渲染
列表 4 显示了 Blog 控件的代码，它已经使用特性进行了更新，以启用设计视图和属性浏览器中的控件设计时支持。请注意，该示例添加了多条 using 指令，以导入支持我们使用的特性和设计器类所需要的命名空间。这个新列表还添加了一个用于 Mode 属性值的枚举。
HTML视图支持：自定义架构和 Visual Studio 注释
尽管前文所述的特性帮助我们为 Blog 控件提供了设计时支持，但这里遗漏了一个重要的问题：在 Web 窗体编辑器的 HTML 视图中添加标记和特性的 IntelliSense 支持。对于那些认为在 HTML 环境中工作比在“所见即所得”风格的环境中工作更舒适的开发人员来说，这是一个极大的疏忽。
因为 Web 窗体编辑器的 HTML 视图使用 XSD 架构决定在 Web 窗体页上提供哪些元素和特性，所以为了纠正这一问题，我们需要提供一个描述 Blog 控件及其所支持的特性的 XSD 架构。也可以在该架构中添加注释，告诉 Visual Studio .NET 各种元素的有关信息以及我们所希望的元素行为。
列表 5 包含 Blog 控件特定的 XSD 架构的部分内容。实际的架构文件（可从本文的示例代码中获得）还包含面板控件（Blog_DT 控件就是由它派生的）的类型定义以及其他必需的特性和类型定义。这些定义是从为内置 ASP.NET 服务器控件创建的 asp.xsd 架构文件中复制的。
请注意，任何时候都不应直接修改 asp.xsd 架构文件，而只应将必需的类型和特性定义复制到您的自定义架构文件中。尽管这看起来是多余的，但如果直接编辑 asp.xsd，以后安装 .NET Framework 或服务包时该文件将被覆盖，您的自定义输入项将因此而丢失。
在列表 5 中，请注意根架构元素上的 targetNamespace 和 xmlns 特性，这两个特性用于为控件的架构定义 XML 命名空间。targetNamespace 和 xmlns 特性的值还将用于 Web 窗体页中的特性，以“绑定”该架构。＜xsd:element＞ 标记定义根 Blog_DT 元素。＜xsd:complexType＞ 标记定义 Blog_DT 元素的特性，包括 ＜xsd:attributeGroup＞ 标记引用的 Web 控件特性。最后，＜xsd:simpleType＞ 标记定义 BlogMode 类型的枚举，该类型被用作 Blog_DT 元素的一个特性。
请注意，列表 5 使用 vs:builder 注释来告诉 Visual Studio .NET 对 AddRedirect 特性使用 URL 生成器，而对 SeparatorColor 特性使用颜色生成器。vs:builder 注释是可用于修改架构的注释之一。表 1 列出了最常用的注释。
表 1：常用的 Visual Studio .NET 注释
