本文介紹如何在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:\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>
還想再好些,用戶控件是否能夠有事件句柄呢?
用戶控件幾乎可以作任何事下面的代碼示范控件如何觸發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要容易。