ASP.NET的用户控件

本文介绍如何在ASP.NET中创建用户控件,控件属性的动态修改以及控件的事件出发机制。

简介
ASP.NET的服务端控件使得Web开发工作变得更为简单,功能更为强大。我们介绍过如何在ASP.NET页面中使用服务端控件。但是,如果服务端没有所要求的控件时该怎么办呢?

当然,ASP.NET不会给你变出一个莫须有的控件。事实上,可以动手作自己的控件来取代.NET提供的控件。这种控件就是用户控件,也正是本文讨论的话题。

编写第一个用户控件
有人认为,知道如何使用服务端控件可不一定说明编写用户控件是件容易的事。

事实上,编写一个基本用户控件(有时也称之为pagelets)并让ASP.NET页面象使用服务端控件那样使用这些控件的确是件简单的事。这里有一个简单示例:

basic.ascx

1<p>   
2This is a user control... really!   
3</p>

这就是一个用户控件!看到这里,我想你会说我该不是喝醉了,头脑不清楚吧。但这段代码的确就是易于被使用的一个用户控件。尽管这个控件没有作什么事,却是关于什么是用户控件的一个很好说明。事情并不象想像得那么复杂。注意后缀.ascx,它告诉网页这是一个用户控件。它没有什么特别含义,只是不让IIS去直接执行这段代码。

现在我们来创建一个用户控件,看下面的例子:

basic.aspx

1@ Page Language="VB" 
1@ Register TagPrefix="asp101samps" TagName="SomeText"   
2Src="basic.ascx" 
1<html>
2<head>
3<title>ASP.NET User Control Sample - Basic</title>
4</head>
5<body bgcolor="#FFFFFF">
6<asp101samps:sometext runat="server"></asp101samps:sometext>
7</body>
8</html>

这段代码输出标准HTML页面,显示用户控件里的文字而不是标记。
那么它是怎么实现的呢?关键就在注册(Register)说明。要注册控件,先要定义三个属性:

TagPrefix
定义控件位置的命名空间。有了命名空间制约,就可以在同一个网页里使用不同功能的同名控件。

TagName
指向所使用控件的名字。在同一个命名空间里的控件名是唯一的。控件名一般都表明控件的功能。

Src
指向控件的资源文件。资源文件使用虚路径("control.ascx" 或 "/path/control.ascx"),不能使用物理路径("C:\path\control.ascx.")。

控件注册之后,就可以象其它服务端控件一样被使用。通过定义目标前缀(TagPrefix)和目标名(TagName),就可以象使用服务端内建控件一样地进行使用。同时也确定了使用服务端运行(runat="server")方式。下面是网页调用用户控件的基本方式:

1<tagprefix:tagname runat="server"></tagprefix:tagname>

给用户控件增加属性并赋值
下面我给控件加上两个属性,一个是color,另一个是text。

properties.ascx

1<script language="VB" runat="server">   
2Public Color As String = "black"   
3Public Text As String = "This is a user control... really!"   
4</script>
1<p>
2<font color="```
3= Color 
4```">   

= Text

1</font>
2</p>

这样就可以使用和改变控件的色彩和文字了。可以在初始化时赋值,还可以动态地修改这二个属性。

在同一个网页里可以重复调用这个控件并使用不同的属性值:
properties.aspx

1@ Page Language="VB" 
1@ Register TagPrefix="asp101samps" TagName="SomeText"   
2Src="properties.ascx" 
1<script language="VB" runat="server">   
2Sub Page_Load(Sender As Object, E As EventArgs)   
3UserCtrl1.Color = "green"   
4UserCtrl1.Text = "This control's properties were " _   
5& "set programmatically!"   
6End Sub   
7</script>
 1<html>
 2<head>
 3<title>ASP.NET User Control Sample - Properties</title>
 4</head>
 5<body bgcolor="#FFFFFF">
 6<asp101samps:sometext runat="server"></asp101samps:sometext>
 7<asp101samps:sometext color="red" runat="server"></asp101samps:sometext>
 8<asp101samps:sometext runat="server" text="This is quite cool!"></asp101samps:sometext>
 9<asp101samps:sometext color="blue" runat="server" text="Ain't It?"></asp101samps:sometext>
10<asp101samps:sometext id="UserCtrl1" runat="server"></asp101samps:sometext>
11</body>
12</html>

还想再好些,用户控件是否能够有事件句柄呢?
用户控件几乎可以作任何事。下面的代码示范控件如何触发Page_Load事件。有了事件句柄,就不用多写其它的维护代码来控制控件的运行。控件可以自己触发事件。

在下面的代码中,封装了一个ASP的textbox控件。我将我的控件名属性与textbox的内容挂钩。

events.ascx

 1<script language="VB" runat="server">   
 2Sub Page_Load(Src As Object, E As EventArgs)   
 3Dim strInitialText As String = "Please Enter a Name!"   
 4  
 5If Page.IsPostBack Then   
 6If txtName.Text = strInitialText   
 7txtName.Text = ""   
 8End If   
 9Else   
10txtName.Text = strInitialText   
11End If   
12End Sub 
13
14Public Property Name As String   
15Get   
16Return txtName.Text   
17End Get   
18Set   
19txtName.Text = Value   
20End Set   
21End Property   
22</script>

Name:

1<asp:textbox id="txtName" runat="server"></asp:textbox>
1<asp:requiredfieldvalidator controltovalidate="txtName" display="Dynamic" id="valtxtName" runat="server">   
2Please Enter a Name!   
3</asp:requiredfieldvalidator>

events.aspx

1@ Page Language="VB" ClientTarget="downlevel" 
1@ Register TagPrefix="asp101samps" TagName="SomeText"   
2Src="properties.ascx" 
1@ Register TagPrefix="asp101samps" TagName="TextBox"   
2Src="events.ascx" 
 1<script language="VB" runat="server">   
 2Sub Page_Load(Sender As Object, E As EventArgs)   
 3txtLabel.Text = "" 
 4
 5' The textbox control handles it's own stuff   
 6' in it's own Page_Load event handler.   
 7End Sub 
 8
 9Sub btnSubmit_Click(Sender As Object, E As EventArgs)   
10' Sets the label to the textbox's text   
11txtLabel.Text = txtName.Name 
12
13' I don't need to worry about validation since   
14' my user control does it for me.   
15End Sub   
16</script>
 1<html>
 2<head>
 3<title>ASP.NET User Control Sample - Validation &amp; Events</title>
 4</head>
 5<body bgcolor="#FFFFFF">
 6<form runat="server">
 7<asp101samps:textbox id="txtName" runat="server"></asp101samps:textbox>
 8<br/>
 9<asp:button id="btnSubmit" onclick="btnSubmit_Click" runat="server" text="Submit"></asp:button>
10</form>
11<asp101samps:sometext id="txtLabel" runat="server"></asp101samps:sometext>
12</body>
13</html>

这就是关于用户控件和应用的说明。无论你认为它是否简单,它肯定比使用传统ASP要容易。

下面可以下载本文代码。

http://www.ChinaOK.net/down/200204221838030.zip

Published At
Categories with Web编程
Tagged with
comments powered by Disqus