软件开发培训班 >> 编程开发 >> ASPNET


如何创建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   
  3. < %@ Page Language="VB" %>   
  5. < %@ Register TagPrefix="asp101samps" TagName="SomeText" Src="basic.ascx" %>   
  7. < html>   
  9. < head> < title>ASP.NET User Control Sample - Basic< /title> < /head> 
  11. < body bgcolor="#FFFFFF">   
  13. < asp101samps:SomeText runat="server" /> 
  15. < /body>   
  17. < /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 controls 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="Aint 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 its own stuff  in its 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 textboxs text txtLabel.Text = txtName.Name  I dont 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要容易  。