ASP.NET立即上手教程(7)

web forms 用户控件

用户控件介绍

除了asp.net提供的内建的服务器控件外，你还可以使用已经掌握的制作web forms 页面的技术，轻松的定义自己的控件。实际上，只需要稍微改动一下，几乎任何web forms页面都可以作为服务器控件，在其他页面上重复使用。(注意用户控件的类型是system.web.ui.usercontrol, 它直接从system.web.ui.control继承而来)。 web forms 页面被作为服务器控件使用的时候，简称为用户控件。转变之后，通常使用.ascx扩展名来表明用户控件。这就保证了用户控件文件不能作为一个单独的web form页面来执行(你可以明白，在用户控件和web forms 页面之间，有一点，但是很重要的区别)。用户控件使用register（注册）指令包含在web forms 页面中：

<%@ register tagprefix="acme" tagname="message" src="pagelet1.ascx" %>

tagprefix 为用户控件确定了唯一的名称空间。(这样，具有相同名字的多个用户控件可以互相区分). tagname 的值是用户控件的唯一名称(你可以使用任何名字)。 src 属性是用户控件的虚拟路径—例如"mypagelet.ascx" 或者 "/myapp/include/mypagelet.ascx"。 注册用户控件之后，你可以在web forms页面中放置用户控件标签，就像是用平常的服务器控件一样(包含runat="server" 属性)：

<acme:message runat="server"/>

下面的例子展示了web forms页面引入用户控件的情况。本例中的用户控件仅仅是一个简单的静态文件。

扩展用户控件的属性

当web forms页面作为用户控件处理的时候，web forms页面的公共字段和方法升级为公共属性（即标签属性）和公共方法(标签的方法)。下面的例子将上一个例子中的用户控件进行延伸，增加了两个公共 string字段。注意这两个字段既可以在包含页中直接声明，也可以用程序来控制。

除了将公共字段升级为控件属性外，也可以使用属性语法。 使用属性语法胜过为了设定或者取得属性值而执行代码。下面的例子示范了一个address 用户控件，他绑定了textbox 控件的text 属性。这样做的好处在于该控件“免费”继承了textbox 控件的自动状态管理。注意在包含web forms页面中有两个address 用户控件，分别为"billing address" 和 "shipping address" 设置caption 属性。用户控件的真正强大之处就是这种重复利用。

用户控件的另一个有用之处是 login 控件，用来收集用户名和密码。

在这个例子中，服务器验证控件添加到了login用户控件中

在用户控件中封装事件

如同普通的服务器控件一样，用户控件参与整个请求执行的生命周期。这就意味着，用户控件能够操作自己的事件，从包含web forms页中封装某些页面逻辑。

下面的例子演示了一个产品列表用户控件，它在内部处理了自己的提交返回。注意用户控件自身没有绑定<form runat="server">控件。因为只有一个表单控件出现在页面上（asp.net不允许嵌套服务器表单），于是留给包含web forms 页面去定义他。

用程序创建用户控件

如同普通服务器控件可以用程序创建一样，用户控件也一样。页面的loadcontrol方法用来载入用户控件，同时将虚拟路径传递给用户控件的源文件所在。

control c1 = loadcontrol("pagelet7.ascx");
((pagelet7cs)c1).category = "business";
page.controls.add(c1);

用户控件的类型是由control 命令的classname 属性所决定。例如下面的例子，一个文件名保存为"pagelet7.ascx"的用户控件被赋值为"pagelet7cs" 强类型:

<%@ control classname="pagelet7cs" %>

因为loadcontrol 方法返回的类型是system.web.ui.control, 所以为了设置用户控件的个别属性，它必须抛出适当的强类型。最终，用户控件加入到基本页面的controlcollection 集合中。

重要提示 对于包含用户控件的web forms 页面，只有当register 命令包含了用户控件（即使没有用户控件标签被实际声明），用户控件的强类型才是可利用的。

本章小结

1、用户控件允许开发者使用创建web forms页面所使用的程序设计技术，轻松的创建自定义控件。

2、作为与普通页面的区别，使用.ascx 文件扩展名来表明用户控件。这就保证了用户控件不能像标准web forms页面那样执行。

3、使用register 命令，将用户控件包含在web forms页面中。register 命令指定了tagprefix, tagname, 和src location。

4、注册了用户控件之后，就可以像对待普通服务器控件那样，使用用户控件（包含runat="server" 属性）。

5、用户控件被包含在web forms 页面中以后，他的公共字段、属性和方法升级为控件的公共属性（标签属性）和方法。

6、用户控件参与每个客户端请求的整个生命周期，并且处理自身的事件，封装了部分包含他的web forms页面的页面逻辑。

7、用户控件不能包含任何form控件。如果需要的话，可以在包含他的web form页面中使用form控件。

8、用户控件可以用system.web.ui.page类的loadcontrol方法用用程序来创建。用户控件的类型由control 命令的classname 属性所决定。

9、对于包含用户控件的web forms 页面，只有当register 命令包含了用户控件（即使没有用户控件标签被实际声明），用户控件的强类型才是可利用的。