如何编写ASP.NET的用户控件

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

时间: 2024-07-30 20:57:11

如何编写ASP.NET的用户控件的相关文章

ASP.NET的用户控件

asp.net|控件 ASP.NET的用户控件 本文介绍如何在ASP.NET中创建用户控件,控件属性的动态修改以及控件的事件出发机制. 简介ASP.NET的服务端控件使得Web开发工作变得更为简单,功能更为强大.我们介绍过如何在ASP.NET页面中使用服务端控件.但是,如果服务端没有所要求的控件时该怎么办呢? 当然,ASP.NET不会给你变出一个莫须有的控件.事实上,可以动手作自己的控件来取代.NET提供的控件.这种控件就是用户控件,也正是本文讨论的话题. 编写第一个用户控件有人认为,知道如何使

asp.net的用户控件心得

asp.net|控件|心得 ASP.NET的用户控件 简介 ASP.NET的服务端控件使得Web开发工作变得更为简单,功能更为强大.我们介绍过如何在ASP.NET页面中使用服务端控件.但是,如果服务端没有所要求的控件时该怎么办呢? 当然,ASP.NET不会给你变出一个莫须有的控件.事实上,可以动手作自己的控件来取代.NET提供的控件.这种控件就是用户控件,也正是本文讨论的话题. 编写第一个用户控件 有人认为,知道如何使用服务端控件可不一定说明编写用户控件是件容易的事. 事实上,编写一个基本用户控

asp.net自定义用户控件与ImageButton、Image之间兼容问题,急求解决.

问题描述 我做了一个首页的头部,我把头部单独做了一个页面,也想用asp那样引入到主页里面,可是那样page会起冲突,网上有解决方法,就是把头部的改成txt的,可是那样要是以后编辑的话不太方便,所以我把整个头部做成了用户自定义控件,并且把它倒进了我的主页,而今天我在编辑主页的时候,我P了一张图片,想用控件ImageButton,但是在运行的时候却显示不出来,求各位高手解决....下面是我的源码..<%@PageLanguage="C#"AutoEventWireup="t

ASP.net的用户控件问题

问题描述 先看代码<%@RegisterTagPrefix="cc1"Namespace="Sanniko.Web.UI.WebControls"Assembly="WebControls"%>这是一个下好了的用户控件现在变成了一个WebControls.dll文件调用下.代码<cc1:DayHourMinuteTextBoxID="DayHourMinuteTB_arrivetime01"runat=&qu

ASP.NET用户控件的利弊和使用实例

创建用户控件要比创建自定义控件方便很多,因为可以重用现有的控件.用户控件使创建具有复杂用户界面元素的控件极为方便.在HoverTreeTop项目中,新增图片的浏览功能,效果请看:http://hovertree.com/top/htimg/ 而图片的添加就使用了用户控件.用户控件为:UCPictureAdd.ascx ,在PictureAdd.aspx页面中使用. 在PictureAdd.aspx页面中使用用户控件的代码: <%@ Page Title="" Language=&

如何给用户控件定义属性(C#:ASP.NET)

asp.net|控件 前言 ASP.NET的用户控件功能很强大,在web窗体里面调用相信大家都会,如果要给用户控件定义属性,那该怎么做呢?只要你看完这篇文章保你会给自己的控件上弄上几个属性.本篇文章不太适合初学.NET的朋友,涉及到一些面向对象的知识,如果您不了解这些知识,请参阅相关书籍 在这里下载电子图书(http://www.cs-aspx.net/down.aspx) 程序namespace DotNet{ using System; using System.Data; using Sy

ASP.NET动态添加用户控件的方法_实用技巧

本文实例讲述了ASP.NET动态添加用户控件的方法.分享给大家供大家参考.具体实现方法如下: 为了让用户控件能ASP.NET页面实现动态添加,首先写一个接口IGetUCable,这个接口有一个函数,返回对象类型是UserControl. using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.UI; /// <summary> /// Summar

ASPX中的用户控件与ASP中的INCLUDE方法对比

include|控件     在ASP的年代里,为了避免经常性重复的劳动,对一些功能相似的区域或者代码,经常作成一个文件,然后通过连接(直接连接或者虚拟连接)的方法引入到ASP网页文件之中,对于一个很大的引用了很多ASP文件就相当于一个文件被分成了很多块,彼此文件之间的数据是可以自由共享的(除了函数之中的数据).    ASPX的用户控件就与INCLUDE有很大的不同了,它的最大特点就是在于他是以包装好的对象的形式呈现,通过我们的编程,可以将一个公用的事例抽象出来,将一些功能和方法总结出来,作成

在ASP.NET中使用用户控件

asp.net|控件 [摘要]ASP.NET中提供的用户控件,可以解决ASP中无法解决的代码重用问题,更方便了调试工作中的错误检查.本文通过用户控件实现方法讲解和一个用户控件例程的实现,进一步验证了利用用户控件解决代码重用的可行性和有效性. [关键字]代码重用.用户控件.@Register指令 ASP.NET提供了比传统ASP更好的代码分离方案.在传统的ASP中,要将用Server. Execute执行的ASP文件或事务对象组件的代码分离开,一般只能将代码分离成几个文件,然后使用"include