asp.net的用户控件
本文介绍如何在asp.net中创建用户控件,控件属性的动态修改以及控件的事件出发机制。
简介
asp.net的服务端控件使得web开发工作变得更为简单,功能更为强大。我们介绍过如何在asp.net页面中使用服务端控件。但是,如果服务端没有所要求的控件时该怎么办呢?
当然,asp.net不会给你变出一个莫须有的控件。事实上,可以动手作自己的控件来取代.net提供的控件。这种控件就是用户控件,也正是本文讨论的话题。
编写第一个用户控件
有人认为,知道如何使用服务端控件可不一定说明编写用户控件是件容易的事。
事实上,编写一个基本用户控件(有时也称之为pagelets)并让asp.net页面象使用服务端控件那样使用这些控件的确是件简单的事。这里有一个简单示例:
basic.ascx
<p>
this is a user control… really!
</p>
这就是一个用户控件!看到这里,我想你会说我该不是喝醉了,头脑不清楚吧。但这段代码的确就是易于被使用的一个用户控件。尽管这个控件没有作什么事,却是关于什么是用户控件的一个很好说明。事情并不象想像得那么复杂。注意后缀.ascx,它告诉网页这是一个用户控件。它没有什么特别含义,只是不让iis去直接执行这段代码。
现在我们来创建一个用户控件,看下面的例子:
basic.aspx
<%@ page language="vb" %>
<%@ register tagprefix="asp101samps" tagname="sometext"
src="basic.ascx" %>
<html>
<head>
<title>asp.net user control sample – basic</title>
</head>
<body bgcolor="#ffffff">
<asp101samps:sometext runat="server" />
</body>
</html>
这段代码输出标准html页面,显示用户控件里的文字而不是标记。
那么它是怎么实现的呢?关键就在注册(register)说明。要注册控件,先要定义三个属性:
tagprefix
定义控件位置的命名空间。有了命名空间制约,就可以在同一个网页里使用不同功能的同名控件。
tagname
指向所使用控件的名字。在同一个命名空间里的控件名是唯一的。控件名一般都表明控件的功能。
src
指向控件的资源文件。资源文件使用虚路径("control.ascx" 或 "/path/control.ascx"),不能使用物理路径("c:pathcontrol.ascx.")。
控件注册之后,就可以象其它服务端控件一样被使用。通过定义目标前缀(tagprefix)和目标名(tagname),就可以象使用服务端内建控件一样地进行使用。同时也确定了使用服务端运行(runat="server")方式。下面是网页调用用户控件的基本方式:
<tagprefix:tagname runat="server" />
给用户控件增加属性并赋值
下面我给控件加上两个属性,一个是color,另一个是text。
properties.ascx
<script language="vb" runat="server">
public color as string = "black"
public text as string = "this is a user control… really!"
</script>
<p>
<font color="<%= color %>">
<%= text %>
</font>
</p>
这样就可以使用和改变控件的色彩和文字了。可以在初始化时赋值,还可以动态地修改这二个属性。
在同一个网页里可以重复调用这个控件并使用不同的属性值:
properties.aspx
<%@ page language="vb" %>
<%@ register tagprefix="asp101samps" tagname="sometext"
src="properties.ascx" %>
<script language="vb" runat="server">
sub page_load(sender as object, e as eventargs)
userctrl1.color = "green"
userctrl1.text = "this controls properties were " _
& "set programmatically!"
end sub
</script>
<html>
<head>
<title>asp.net user control sample – properties</title>
</head>
<body bgcolor="#ffffff">
<asp101samps:sometext runat="server" />
<asp101samps:sometext color="red" runat="server" />
<asp101samps:sometext text="this is quite cool!" runat="server" />
<asp101samps:sometext color="blue" text="aint it?" runat="server" />
<asp101samps:sometext id="userctrl1" runat="server" />
</body>
</html>
还想再好些,用户控件是否能够有事件句柄呢?
用户控件几乎可以作任何事。下面的代码示范控件如何触发page_load事件。有了事件句柄,就不用多写其它的维护代码来控制控件的运行。控件可以自己触发事件。
在下面的代码中,封装了一个asp的textbox控件。我将我的控件名属性与textbox的内容挂钩。
events.ascx
<script language="vb" runat="server">
sub page_load(src as object, e as eventargs)
dim strinitialtext as string = "please enter a name!"
if page.ispostback then
if txtname.text = strinitialtext
txtname.text = ""
end if
else
txtname.text = strinitialtext
end if
end sub
public property name as string
get
return txtname.text
end get
set
txtname.text = value
end set
end property
</script>
name: <asp:textbox id="txtname" runat="server" />
<asp:requiredfieldvalidator controltovalidate="txtname"
id="valtxtname" display="dynamic" runat=server>
please enter a name!
</asp:requiredfieldvalidator>
events.aspx
<%@ page language="vb" clienttarget="downlevel" %>
<%@ register tagprefix="asp101samps" tagname="sometext"
src="properties.ascx" %>
<%@ register tagprefix="asp101samps" tagname="textbox"
src="events.ascx" %>
<script language="vb" runat="server">
sub page_load(sender as object, e as eventargs)
txtlabel.text = ""
the textbox control handles its own stuff
in its own page_load event handler.
end sub
sub btnsubmit_click(sender as object, e as eventargs)
sets the label to the textboxs text
txtlabel.text = txtname.name
i dont need to worry about validation since
my user control does it for me.
end sub
</script>
<html>
<head>
<title>asp.net user control sample – validation & events</title>
</head>
<body bgcolor="#ffffff">
<form runat="server">
<asp101samps:textbox id="txtname" runat="server" />
<br />
<asp:button id="btnsubmit" onclick="btnsubmit_click"
text="submit" runat="server" />
</form>
<asp101samps:sometext id="txtlabel" runat="server" />
</body>
</html>
这就是关于用户控件和应用的说明。无论你认为它是否简单,它肯定比使用传统asp要容易。