如何创建ASP.NET用户控件

开发 后端
本文介绍如何在ASP.NET中创建用户控件,控件属性的动态修改以及控件的事件出发机制。文章从编写第一个ASP.NET用户控件开始讲起。

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

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

编写第一个ASP.NET用户控件

有人认为,知道如何使用服务端控件可不一定说明编写用户控件是件容易的事。事实上,编写一个基本用户控件(有时也称之为pagelets)并让ASP.NET页面象使用服务端控件那样使用这些控件的确是件简单的事。这里有一个简单示例:

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

这就是一个用户控件!看到这里,我想你会说我该不是喝醉了,头脑不清楚吧。

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

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

ASP.NET用户控件

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

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

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

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

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

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

  1. < TagPrefix:TagName runat="server" /> 

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

  1. properties.ascx   
  2. < script language="VB" runat="server"> 
  3. Public Color As String = "black" 
  4. Public Text As String = "This is a user control... really!" 
  5. < /script> 
  6.  
  7. < p> 
  8. < font color="< %= Color %>"> 
  9. < %= Text %> 
  10. < /font> 
  11. < /p> 

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

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

  1. properties.aspx   
  2.  
  3. < %@ Page Language="VB" %>   
  4.  
  5. < %@ Register TagPrefix="asp101samps" TagName="SomeText" Src="properties.ascx" %>   
  6.  
  7. < script language="VB" runat="server">   
  8.  
  9. Sub Page_Load(Sender As Object, E As EventArgs)   
  10.  
  11. UserCtrl1.Color = "green"   
  12.  
  13. UserCtrl1.Text = "This control's properties were " _ & "set programmatically!"   
  14.  
  15. End Sub   
  16.  
  17. < /script>   
  18.  
  19. < html>   
  20.  
  21. < head> < title>ASP.NET User Control Sample - Properties< /title> < /head>   
  22.  
  23. < body bgcolor="#FFFFFF">   
  24.  
  25. < asp101samps:SomeText runat="server" />   
  26.  
  27. < asp101samps:SomeText Color="red" runat="server" />   
  28.  
  29. < asp101samps:SomeText Text="This is quite cool!" runat="server" />   
  30.  
  31. < asp101samps:SomeText Color="blue" Text="Ain't It?" runat="server" />   
  32.  
  33. < asp101samps:SomeText id="UserCtrl1" runat="server" />   
  34.  
  35. < /body>   
  36.  
  37. < /html>  

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

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

  1. events.ascx   
  2.  
  3. < script language="VB" runat="server">   
  4.  
  5. Sub Page_Load(Src As Object, E As EventArgs)   
  6.  
  7. Dim strInitialText As String = "Please Enter a Name!"   
  8.  
  9. If Page.IsPostBack   
  10.  
  11. Then   
  12.  
  13.    If txtName.Text = strInitialText txtName.Text = ""   
  14.  
  15.    End If  
  16.  
  17. Else txtName.Text = strInitialText 
  18.  
  19. End If   
  20.  
  21. End Sub   
  22.  
  23. Public Property Name As String Get Return txtName.Text End Get Set txtName.Text = Value End Set End Property   
  24.  
  25. < /script> 
  26.  
  27. Name:   
  28.  
  29. < asp:textbox id="txtName" runat="server" />   
  30.  
  31. < asp:RequiredFieldValidator ControlToValidate="txtName" id="valtxtName" Display="Dynamic" runat=server> Please Enter a Name!   
  32.  
  33. < /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"> 
  34.  
  35. Sub Page_Load(Sender As Object, E As EventArgs) txtLabel.Text = "" ' The textbox control handles it's own stuff ' in it's own Page_Load event handler.   
  36.  
  37. End Sub   
  38.  
  39. Sub btnSubmit_Click(Sender As Object, E As EventArgs) ' Sets the label to the textbox's text txtLabel.Text = txtName.Name ' I don't need to worry about validation since ' my user control does it for me.  
  40.  
  41. End Sub   
  42.  
  43. < /script>   
  44.  
  45. < html>   
  46.  
  47. < head> < title>ASP.NET User Control Sample - Validation & Events< /title> < /head>   
  48.  
  49. < body bgcolor="#FFFFFF">   
  50.  
  51. < form runat="server"> 
  52.  
  53. < asp101samps:TextBox id="txtName" runat="server" /> < br />   
  54.  
  55. < asp:button id="btnSubmit" onClick="btnSubmit_Click" text="Submit" runat="server" />   
  56.  
  57. < /form>   
  58.  
  59. < asp101samps:SomeText id="txtLabel" runat="server" />   
  60.  
  61. < /body>   
  62.  
  63. < /html>  

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

【编辑推荐】

  1. 介绍ASP.NET页面生命周期
  2. ASP.NET服务器自定义控件安全准则
  3. ASP.NET编程规范之编码规范浅析
  4. 关于ASP.NET Session的一点认识
  5. ASP.NET编程工具ASP.NET Web Matrix详细介绍
责任编辑:周立方 来源: 网络转载
相关推荐

2009-08-27 16:59:20

ASP.NET用户控件

2009-07-24 16:15:00

扩展ASP.NET G

2009-07-27 17:25:53

ASP.NET验证控件

2009-08-17 09:24:25

ASP.NET控件

2009-08-03 15:08:00

SqlDataSour

2009-07-27 16:19:59

ASP.NET报表控件

2009-07-27 13:52:36

Panel控件ASP.NET

2009-07-24 10:36:08

ASP.NET控件

2009-08-04 10:43:59

ASP.NET控件开发

2009-08-19 13:44:00

ASP.NET Lis

2009-08-05 15:57:03

ASP.NET控件ID

2009-07-29 13:50:26

UpdatePanelASP.NET

2009-08-07 14:40:36

RegularExprASP.NET验证控件

2009-07-21 17:18:26

UpdateProgrASP.NET AJA

2009-07-24 15:35:00

ASP.NET Gri

2009-08-10 14:08:15

ASP.NET服务器控ASP.NET组件设计

2009-07-29 13:57:53

创建SlideShowASP.NET

2009-08-07 17:49:44

控件设计器

2009-08-04 11:29:14

HTML代码ASP.NET控件

2009-08-07 15:24:16

ASP.NET模板控件
点赞
收藏

51CTO技术栈公众号