在前一篇文章当中,我们一同探讨了如何使用ASP.NET中的代码绑定技术来使得代码重用变得简单可行。我们发现,利用代码绑定技术我们可以容易的将我们的代码和内容分离开来,利用它可以建立可重用的代码,只是这种技术本身也存在着一些局限性。在本文中,我们将会一同探讨另外一种新的ASP.NET技术:用户控件。
什么是用户控件(User Controls)?
为了能更好的理解用户控件的重要性,我们先来看看一段小小的“历史”。在以前的ASP当中,可重用的技术实现选择是相当受限制的。许多的开发者一般都是借助将公共的常用的子过程放到那些包含文件当中的做法来实现一定的所谓代码重用的。比如,如我们想要在许多的ASP页面当中现实一个下拉列表框,我会在一个包含文件当中建立一个函数,样子如下所示:
Function GetListBox(asSelectedItem)
'为HTML的选择控件建立字符串
'返回这个字符串
End Function
当然,这样的做法的确在一定程度上做到了重用,但是为了能做到更加通用性,你不得不要增加更多的参数。为了使得类似上面的你需要整理的代码得以正常工作是困难的,因为要达到提供它的通用性(可重用性),你大概不得不去修改这些已经存在的代码,以便使得他们也能在新的环境下正常工作。
IIS5中的VBScript5.0增加了建立类的功能。这就使得我们可以通过一个较多面向对象的方式来实现可重用的代码。
Class ComboBox
Property Let ControlName(vData)
.
End Property
End Class
这样做会稍微好一些,但是开发者仍旧需要被迫去编写那些函数,以便返回HTML代码。而且,他也没有能力操纵那些类的实例对象的事件。为了能做到操作事件,开发者不得不建立一些COM组件,而后者则增加了应用程序的额外的复杂度。
有了ASP.NET,我们拥有了一个新的简单的工具来编写可重用的代码—用户控件。用户控件(也叫pagelets)提供了这样一种机制,他使得我们可以建立能够非常容易的被ASP.NET页面使用或者重新利用的代码部件。一个用户控件也是一个简单的ASP.NET页面,不过它可以被另外一个ASP.NET页面包含进去。在你的ASP.NET应用程序当中使用用户控件的一个主要的优点是用户控件的支持一个完全面向对象的模式,使得你有能力去捕获事件。而且,用户控件支持你使用一种语言编写ASP.NET页面其中的一部分代码,而使用另外的一种语言编写ASP.NET页面另外一部分代码,因为每一个用户控件可以使用和主页面不同的语言来编写。
建立一个用户控件
在建立你自己的用户控件之前,你也许想知道在你的web页面中哪些可见的对象是能够重用的好的候选者。能可能的是,你将会在你的站点上的不止一个页面上需要使用融合的用户控件。一旦你开始不断的思考你的控件的结构,你就已经做好的开始的准备。在我们的例子当中,我们将要建立一个简单的搜索的控件,用来搜索SQL Server2000中的数据库Northwind。我们的搜索控件可以使得开发者快速的为一个web页面增加搜索能力。
建立用户控件的第一步是建立一个.ascx文件。这是用户控件需要的文件扩展名。在一个一个.ascx文件中不能包含head,form,或者body标签,因为包含此.ascx文件的.aspx文件已经包含了这些标签。一个.ascx文件只能包含方法,函数,以及和用户控件相关的内同。
在建立一个.ascx文件之后,我们想要为用户控件增加一些可视的代码。在一个用户控件当中可以包含所有的web控件。在我们的例子当中,搜索控件需要拥有一个标签,一个文本框以及一个按钮。我们首先加入这些web控件,因为我们的整个代码当中会涉及到这些对象。下面是具体的代码:
在用户控件中有一件很酷的事情是,你可以定义你自己的属性。在我们的例子当中,我们会定义如下属性:
。LabelText—描述显示给用户的搜索条件
。ConnectiongString---用来联接到数据库的连接字符串
。ResultSetView—包含了搜索结果的数据记录集
。TableName—要搜索的数据库table名称
。Condition—需要搜索的table的列的名称
为了建立这些属性,我们使用一些联合起来的get和set方法来同属性结合起来。在做这些工作之前,我们需要首先决定一个属性是否需要允许读,写,还是两者都需要。对于只需要读的属性,我们将会使用ReadOnly关键字来限定属性的声明,并且仅仅包含了get方法。我们的ResultSetView属性是一个只读的属性,因此它的相关代码看起来如下:
'这是一个只读的属性
Public ReadOnly Property ResultSetView as dataView
Get
'设置返回属性地值
ResultSetView = dsData.tables("BookTitles").defaultview
End Get
End Property
对于只需要写的属性,我们将会使用WriteOnly关键字来限定属性的声明,并且仅仅包含了set方法。我们的TableName属性是一个只写属性,因此它的相关代码看起来如下:
'This write only attribute identifies which table will be searched
Public WriteOnly Property TableName as string
Set
'设置表的名称
strTableName = Value
End Set
End Property
对于那些既能读也能写的属性,在定义的时候就不需要加以限定了;并且同时包含了Get和Set方法。一旦这个属性被建立,.aspx文件就可以读取或者设置这些属性,使得用户控件可以适应一个或者多个用途了。
在用户控件当中,和定义不同的属性相结合,你也需要定义任意的方法,这些方法可以被用户控件初始化。这些属性和方法定义了用户控件的功能。在我们的例子当中使用的是search方法。这个方法读取各个用户定义在.aspx文件中的控件属性,并且返回一个搜索的结果记录集。所有的操纵数据库的代码都在这个方法中了:建立SQL语句,打开数据库联接,并且从数据库中返回一个结果。
'这个程序依照属性的值来操纵一个数据库
Public Sub Search(sender As Object , e As System.EventArgs)
Dim cnConnection As SQLConnection
Dim cmdCommand As SQLDataSetCommand
Dim strSearchString As String
Dim strSQL As String
'如果用户在搜索框中输入了条件
If txtSearch.Text <> "" Then
'过滤掉字符的前后空格
strSearchString = trim$(txtSearch.Text)
End If
'建立我们的SQL语句
strSQL = "SELECT * " amp; _
"FROM " amp; strTableName amp; _
" WHERE " amp; strConditionField amp; " LIKE '" amp; _
trSearchString amp; "%'"
'如果联接属性被设置了
If strConnection <> "" Then
'建立数据库联接
cnConnection = New SQLConnection(strConnection)
'打开数据库联接
cnConnection.open()
'为搜索建立一个新的command对象
cmdCommand = New SQLDataSetCommand(strSQL, cnConnection)
'建立一个新的DataSet对象
dsData = New DataSet()
'填充dataset对象
cmdCommand.FillDataSet(dsData, "BookTitles")
End If
End Sub
一旦你在你的用户控件当中添加了属性和方法,控件的开发也就大致完成了。
现在我们对一个用户控件是如何建立的有了一个认识,让我们来看看用户控件是如何工作的。下面是我们的用户控件被包含在一个form当中的时候看起来的样子:
我们的用户控件将会放在一个国际食物网站的一个搜索页面上。为了建立这个搜索页面,我们先建立一个空的.aspx文件。我们先安排好所有的图片和布局,之后加入我们的用户控件。
为了能够在一个.aspx页面当中使用这个新的用户控件,你必须首先初始化@Register指令。当使用这个标签的时候,你必须定义标签前缀,标签名字以及指定用户控件所在的源文件。
TagPrefix定义了我们使用这个用户控件的时候想要用的名称空间。TagName定义了这个用户控件的实际名称。你可以任意的命名你的控件,这个名字将会用在页面上面标示用户控件。
当你加入一个用户控件到一个.aspx页面的时候,相应的语法同加入一个web控件类似。你首先使用标签前缀和标签名称来标示用户控件:
控件中国网提示:未完待续