如何編寫ASP.NET的用戶控件

2024-07-10 13:04:44

字體：大中小

來源：轉載

供稿：網(wǎng)友

本文介紹如何在asp.net中創(chuàng)建用戶控件，控件屬性的動態(tài)修改以及控件的事件出發(fā)機制。
==================================================================
簡介
asp.net的服務端控件使得工作變得更為簡單，功能更為強大。我們介紹過如何在asp.net頁面中使用服務端控件。但是，如果服務端沒有所要求的控件時該怎么辦呢？

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

編寫第一個用戶控件
有人認為，知道如何使用服務端控件可不一定說明編寫用戶控件是件容易的事。

事實上，編寫一個基本用戶控件(有時也稱之為pagelets)并讓asp.net頁面象使用服務端控件那樣使用這些控件的確是件簡單的事。這里有一個簡單示例：

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

這就是一個用戶控件！看到這里，我想你會說我該不是喝醉了，頭腦不清楚吧。但這段代碼的確就是易于被使用的一個用戶控件。盡管這個控件沒有作什么事，卻是關于什么是用戶控件的一個很好說明。事情并不象想像得那么復雜。注意后綴.ascx，它告訴網(wǎng)頁這是一個用戶控件。它沒有什么特別含義，只是不讓iis去直接執(zhí)行這段代碼。

現(xiàn)在我們來創(chuàng)建一個用戶控件，看下面的例子：

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頁面，顯示用戶控件里的文字而不是標記。
那么它是怎么實現(xiàn)的呢？關鍵就在注冊(register)說明。要注冊控件，先要定義三個屬性：

tagprefix
定義控件位置的命名空間。有了命名空間制約，就可以在同一個網(wǎng)頁里使用不同功能的同名控件。

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

src
指向控件的資源文件。資源文件使用虛路徑("control.ascx" 或 "/path/control.ascx")，不能使用物理路徑("c:/path/control.ascx.")。

控件注冊之后，就可以象其它服務端控件一樣被使用。通過定義目標前綴(tagprefix)和目標名(tagname)，就可以象使用服務端內建控件一樣地進行使用。同時也確定了使用服務端運行(runat="server")方式。下面是網(wǎng)頁調用用戶控件的基本方式：
<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>

這樣就可以使用和改變控件的色彩和文字了。可以在初始化時賦值，還可以動態(tài)地修改這二個屬性。

在同一個網(wǎng)頁里可以重復調用這個控件并使用不同的屬性值：
properties.aspx
<%@ page language="vb" %>
<%@ register tagprefix="asp101samps" tagname="sometext"
src="properties.ascx" %>

<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>

還想再好些，用戶控件是否能夠有事件句柄呢？
用戶控件幾乎可以作任何事。下面的代碼示范控件如何觸發(fā)page_load事件。有了事件句柄，就不用多寫其它的維護代碼來控制控件的運行。控件可以自己觸發(fā)事件。

在下面的代碼中，封裝了一個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" %>

' 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">

<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>

這就是關于用戶控件和應用的說明。無論你認為它是否簡單，它肯定比使用傳統(tǒng)asp要容易。

下面可以下載本文代碼。

http://www.chinaok.net/down/200204221838030.zip

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

編寫第一個用戶控件
有人認為，知道如何使用服務端控件可不一定說明編寫用戶控件是件容易的事。

事實上，編寫一個基本用戶控件(有時也稱之為pagelets)并讓asp.net頁面象使用服務端控件那樣使用這些控件的確是件簡單的事。這里有一個簡單示例：

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

現(xiàn)在我們來創(chuàng)建一個用戶控件，看下面的例子：

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>

tagprefix
定義控件位置的命名空間。有了命名空間制約，就可以在同一個網(wǎng)頁里使用不同功能的同名控件。

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

src
指向控件的資源文件。資源文件使用虛路徑("control.ascx" 或 "/path/control.ascx")，不能使用物理路徑("c:/path/control.ascx.")。

給用戶控件增加屬性并賦值
下面我給控件加上兩個屬性，一個是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>

這樣就可以使用和改變控件的色彩和文字了。可以在初始化時賦值，還可以動態(tài)地修改這二個屬性。

<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的textbox控件。我將我的控件名屬性與textbox的內容掛鉤。

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>

' 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">

<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>

這就是關于用戶控件和應用的說明。無論你認為它是否簡單，它肯定比使用傳統(tǒng)asp要容易。

下面可以下載本文代碼。