如何編寫ASP.NET的使用者控制項

來源:互聯網
上載者:User
asp.net|控制項

本文介紹如何在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"
text="Submit" runat="server" />

</form>

<asp101samps:SomeText id="txtLabel" runat="server" />

</body>
</html>

這就是關於使用者控制項和應用的說明。無論你認為它是否簡單,它肯定比使用傳統ASP要容易。

下面可以下載本文代碼。

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

當然,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"
text="Submit" runat="server" />

</form>

<asp101samps:SomeText id="txtLabel" runat="server" />

</body>
</html>

這就是關於使用者控制項和應用的說明。無論你認為它是否簡單,它肯定比使用傳統ASP要容易。

下面可以下載本文代碼。

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



相關文章

E-Commerce Solutions

Leverage the same tools powering the Alibaba Ecosystem

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。