如何創(chuàng)建ASP.NET用戶控件
ASP.NET的服務(wù)端控件使得Web開發(fā)工作變得更為簡單,功能更為強(qiáng)大。我們介紹過如何在ASP.NET頁面中使用服務(wù)端控件。但是,如果服務(wù)端沒有所要求的控件時(shí)該怎么辦呢?
當(dāng)然,ASP.NET不會(huì)給你變出一個(gè)莫須有的控件。事實(shí)上,可以動(dòng)手作自己的控件來取代.NET提供的控件。這種控件就是用戶控件,也正是本文討論的話題。
編寫第一個(gè)ASP.NET用戶控件
有人認(rèn)為,知道如何使用服務(wù)端控件可不一定說明編寫用戶控件是件容易的事。事實(shí)上,編寫一個(gè)基本用戶控件(有時(shí)也稱之為pagelets)并讓ASP.NET頁面象使用服務(wù)端控件那樣使用這些控件的確是件簡單的事。這里有一個(gè)簡單示例:
- basic.ascx
- < p>
- This is a user control... really!
- < /p>
這就是一個(gè)用戶控件!看到這里,我想你會(huì)說我該不是喝醉了,頭腦不清楚吧。
但這段代碼的確就是易于被使用的一個(gè)用戶控件。盡管這個(gè)控件沒有作什么事,卻是關(guān)于什么是用戶控件的一個(gè)很好說明。事情并不象想像得那么復(fù)雜。注意后綴.ascx,它告訴網(wǎng)頁這是一個(gè)用戶控件。它沒有什么特別含義,只是不讓IIS去直接執(zhí)行這段代碼。
現(xiàn)在我們來創(chuàng)建一個(gè)用戶控件,看下面的例子:
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>
這段代碼輸出標(biāo)準(zhǔn)HTML頁面,顯示用戶控件里的文字而不是標(biāo)記。
那么它是怎么實(shí)現(xiàn)的呢?關(guān)鍵就在注冊(cè)(Register)說明。要注冊(cè)控件,先要定義三個(gè)屬性:
TagPrefix
定義控件位置的命名空間。有了命名空間制約,就可以在同一個(gè)網(wǎng)頁里使用不同功能的同名控件。
TagName
指向所使用控件的名字。在同一個(gè)命名空間里的控件名是唯一的??丶话愣急砻骺丶墓δ堋?/P>
Src
指向控件的資源文件。資源文件使用虛路徑("control.ascx" 或 "/path/control.ascx"),不能使用物理路徑("C:\path\control.ascx.")。
控件注冊(cè)之后,就可以象其它服務(wù)端控件一樣被使用。通過定義目標(biāo)前綴(TagPrefix)和目標(biāo)名(TagName),就可以象使用服務(wù)端內(nèi)建控件一樣地進(jìn)行使用。同時(shí)也確定了使用服務(wù)端運(yùn)行(runat="server")方式。下面是網(wǎng)頁調(diào)用用戶控件的基本方式:
- < TagPrefix:TagName runat="server" />
給用戶控件增加屬性并賦值
下面我給控件加上兩個(gè)屬性,一個(gè)是color,另一個(gè)是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>
這樣就可以使用和改變控件的色彩和文字了??梢栽诔跏蓟瘯r(shí)賦值,還可以動(dòng)態(tài)地修改這二個(gè)屬性。
在同一個(gè)網(wǎng)頁里可以重復(fù)調(diào)用這個(gè)控件并使用不同的屬性值:
- 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用戶控件是否能夠有事件句柄呢?
用戶控件幾乎可以作任何事。下面的代碼示范控件如何觸發(fā)Page_Load事件。有了事件句柄,就不用多寫其它的維護(hù)代碼來控制控件的運(yùn)行。控件可以自己觸發(fā)事件。
在下面的代碼中,封裝了一個(gè)ASP的textbox控件。我將我的控件名屬性與textbox的內(nèi)容掛鉤。
- 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>
這就是關(guān)于ASP.NET用戶控件和應(yīng)用的說明。無論你認(rèn)為它是否簡單,它肯定比使用傳統(tǒng)ASP要容易。
【編輯推薦】