如何創建ASP.NET用戶控件

作者：佚名 2009-08-04 13:38:36

本文介紹如何在ASP.NET中創建用戶控件，控件屬性的動態修改以及控件的事件出發機制。文章從編寫第一個ASP.NET用戶控件開始講起。

ASP.NET的服務端控件使得Web開發工作變得更為簡單，功能更為強大。我們介紹過如何在ASP.NET頁面中使用服務端控件。但是，如果服務端沒有所要求的控件時該怎么辦呢？

當然，ASP.NET不會給你變出一個莫須有的控件。事實上，可以動手作自己的控件來取代.NET提供的控件。這種控件就是用戶控件，也正是本文討論的話題。

編寫第一個ASP.NET用戶控件

有人認為，知道如何使用服務端控件可不一定說明編寫用戶控件是件容易的事。事實上，編寫一個基本用戶控件(有時也稱之為pagelets)并讓ASP.NET頁面象使用服務端控件那樣使用這些控件的確是件簡單的事。這里有一個簡單示例：

basic.ascx   
< p> 
This is a user control... really!  
< /p>

這就是一個用戶控件！看到這里，我想你會說我該不是喝醉了，頭腦不清楚吧。

但這段代碼的確就是易于被使用的一個用戶控件。盡管這個控件沒有作什么事，卻是關于什么是用戶控件的一個很好說明。事情并不象想像得那么復雜。注意后綴.ascx，它告訴網頁這是一個用戶控件。它沒有什么特別含義，只是不讓IIS去直接執行這段代碼。

現在我們來創建一個用戶控件，看下面的例子：

ASP.NET用戶控件

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:\path\control.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 control's 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="Ain't It?" runat="server" />   
 
< asp101samps:SomeText id="UserCtrl1" runat="server" />   
 
< /body>   
 
< /html>

還想再好些，ASP.NET用戶控件是否能夠有事件句柄呢？
用戶控件幾乎可以作任何事。下面的代碼示范控件如何觸發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 it's own stuff ' in it's own Page_Load event handler.   
 
End Sub   
 
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.  
 
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.NET用戶控件和應用的說明。無論你認為它是否簡單，它肯定比使用傳統ASP要容易。

【編輯推薦】

介紹ASP.NET頁面生命周期
ASP.NET服務器自定義控件安全準則
ASP.NET編程規范之編碼規范淺析
關于ASP.NET Session的一點認識
ASP.NET編程工具ASP.NET Web Matrix詳細介紹

責任編輯：周立方來源：網絡轉載

ASP.NET用戶控件