English Version:
在这个系列中,我将介绍一些Atlas Sys.UI.Data中较高级的控件,包括:
- Sys.UI.Data.ListView:
- Sys.UI.Data.ItemView:
- Sys.UI.Data.DataNavigator:
- Sys.UI.Data.SortBehavior:
- Sys.UI.Data.XSLTView:
这篇是其中的第三篇:
把所有的记录统统放在一个页面上绝对不是一个好主意,特别是当您有成百上千条记录时。您的用户需要不停的拖动滚动条,甚至使用Control+F来找到所期待的内容,这将带来相当差的用户体验。这时,将数据以分页的方式显示给用户将友好的多。 一些ASP.NET服务器端控件拥有内建的分页及页面导航功能,例如DataGrid和GridView。同样的,Atlas客户端控件Sys.UI.Data.DataNavigator也提供了类似的功能,这将大大提高我们的开发效率。
DataNavigator控件将与DataView(请参考: )控件一起工作。我们知道DataView控件没有提供页面导航相关方法,所以我们只能直接设置它的pageIndex属性来实现导航。虽然没有什么难度,但很多情况下这并不是一个好办法,因为像我这样好多粗心的开发者往往会忘记检查pageIndex的边界值,造成不必要的麻烦。这也是Atlas要提供DataNavigator控件的原因之一,DataNavigator控件将作为一个DataView控件的代理(proxy),提供易用的页面导航接口。
DataNavigator对象只有一个属性:
- dataView:对某个DataView对象的引用,这个DataNavigator将把页面导航的操作应用到其上。您应该总是指定这个属性。
另外,要使用DataNavigator控件,您还需要提供一些拥有一些指定commandName属性的Atlas Button,以触发相应的页面导航操作。这些Button的parent属性应该设定为此DataNavigator控件,以保证DataNavigator能够捕获到这些Button发出的命令。
您可以指定您的Button的commandName属性为如下五个string,每个都有不同的含义:
- page:将当前页面索引转为命令参数(command argument)中指定的值。通过这个命令我们可以快速的改变页面的索引。
- nextpage:切换到下一页(如果存在下一页)。
- previouspage:切换到上一页(如果存在上一页)。
- firstpage:切换到第一页。
- lastpage:切换到最后一页。
OK,MSDN般枯燥的介绍到此为止吧,让我们通过一个实例来熟悉DataNavigator的使用方法。
首先我们需要暴露一个Web Service,以便Atlas页面使用。该Web Service将返回100条记录。下面就是这个Web Service的代码,非常易于理解,这里不赘。
Web Service using System;using System.Collections;using System.Collections.Generic;using System.ComponentModel;using System.IO;using System.Web;using System.Web.Caching;using System.Web.Services;using System.Web.Services.Protocols;using Microsoft.Web.Services;//// For simplicity this example demonstraes storing and manipulating // the data objects in memory. A database can also be used.// [WebService(Namespace = "http://tempuri.org/")][WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]public class MyDataService : DataService{ static List<Entry> _data; static object _dataLock = new object(); private static List<Entry> Data { get { if (_data == null) { lock (_dataLock) { if (_data == null) { _data = new List<Entry>(); for (int i = 0; i < 100; i++) { _data.Add(new Entry(i, "Dflying " + i.ToString(), string.Format("Dflying{0}@dflying.net", i.ToString()))); } } } } return _data; } } [DataObjectMethod(DataObjectMethodType.Select)] public Entry[] SelectRows() { return MyDataService.Data.ToArray(); }}public class Entry{ private string _name; private string _email; private int _id; [DataObjectField(true, true)] public int Id { get { return _id; } set { _id = value; } } [DataObjectField(false)] [DefaultValue("New row")] public string Name { get { return _name; } set { _name = value; } } [DataObjectField(false)] [DefaultValue("")] public string Email { get { return _email; } set { _email = value; } } public Entry() { _id = -1; } public Entry(int id, string name, string description) { _id = id; _name = name; _email = description; }} 然后,在ASPX页面中我们需要考虑并定义如下四部分的内容:
- 一个ScriptManager控件,用来包含页面必须的Atlas Framework相关脚本文件。通常情况下,这也是每个Atlas页面必须包含的。
- 一个占位(place holder)的div(id为dataContents,见代码)。Atlas将会把渲染后的分页的ListView放置于此。
- 一个作为容器的div(DataNavigator控件),以及其中包含的一组按钮(命令按钮),用来实现页面导航功能。
- 一个隐藏的div,用来放置ListView的模版。
下面是以上四部分内容的代码,关于ListView控件的模版,请参考我的这篇文章:
<!-- ScriptManager --> < atlas:ScriptManager runat ="server" ID ="scriptManager" /> <!-- Element for paged ListView (container) --> < div id ="dataContents" > </ div > <!-- PageNavigator --> < div id ="pageNavigator" > < input type ="button" id ="btnFirstPage" value ="<<" /> < input type ="button" id ="btnPrevPage" value ="<" /> < span id ="lblPageNumber" ></ span > / < span id ="lblPageCount" ></ span > < input type ="button" id ="btnNextPage" value =">" /> < input type ="button" id ="btnLastPage" value =">>" /> </ div > <!-- Templates --> < div style ="visibility: hidden; display: none" > < table id ="myList_layoutTemplate" border ="1" cellpadding ="3" style ="width:20em;" > < thead > < tr > < td >< span > No. </ span ></ td > < td >< span > Name </ span ></ td > < td >< span > Email </ span ></ td > </ tr > </ thead > <!-- Repeat Template --> < tbody id ="myList_itemTemplateParent" > <!-- Repeat Item Template --> < tr id ="myList_itemTemplate" > < td >< span id ="lblIndex" /></ td > < td >< span id ="lblName" /></ td > < td >< span id ="lblEmail" /></ td > </ tr > </ tbody > </ table > <!-- Empty Template --> < div id ="myList_emptyTemplate" > No Data </ div > </ div > 最后该书写Atlas的XML脚本定义了,有如下五个部分:
第一部分:Atlas客户端控件DataSource,用来从我们上面定义的Web Service中取得数据。
< dataSource id ="dataSource" autoLoad ="true" serviceURL ="MyDataService.asmx" /> 第二部分:一个DataView控件(请参考: ),用来将第一部分中取得的那100条数据分页。
< dataView id ="view" pageSize ="12" > < bindings > < binding dataContext ="dataSource" dataPath ="data" property ="data" /> </ bindings > </ dataView > 第三部分:一个ListView控件(请参考: ) , 用于显示分页好的数据。
< listView id ="dataContents" itemTemplateParentElementId ="myList_itemTemplateParent" > < bindings > < binding dataContext ="view" dataPath ="filteredData" property ="data" /> </ bindings > < layoutTemplate > < template layoutElement ="myList_layoutTemplate" /> </ layoutTemplate > < itemTemplate > < template layoutElement ="myList_itemTemplate" > < label id ="lblIndex" > < bindings > < binding dataPath ="$index" transform ="Add" property ="text" /> </ bindings > </ label > < label id ="lblName" > < bindings > < binding dataPath ="Name" property ="text" /> </ bindings > </ label > < label id ="lblEmail" > < bindings > < binding dataPath ="Email" property ="text" /> </ bindings > </ label > </ template > </ itemTemplate > < emptyTemplate > < template layoutElement ="myList_emptyTemplate" /> </ emptyTemplate > </ listView > 第四部分: DataNavigator控件以及命令按钮。注意到这里我们有四个按钮,每一个都有不同的commandName属性,也分别对应着DataNavigator对DataView的一种操作。同时这些按钮的parent属性都设置成了这个DataNavigator对象。
< dataNavigator id ="pageNavigator" dataView ="view" /> < button id ="btnFirstPage" parent ="pageNavigator" command ="FirstPage" /> < button id ="btnPrevPage" parent ="pageNavigator" command ="PreviousPage" > < bindings > < binding property ="enabled" dataPath ="hasPreviousPage" /> </ bindings > </ button > < button id ="btnNextPage" parent ="pageNavigator" command ="NextPage" > < bindings > < binding property ="enabled" dataPath ="hasNextPage" /> </ bindings > </ button > < button id ="btnLastPage" parent ="pageNavigator" command ="LastPage" /> 第五部分:两个Label,分别显示页面总数以及当前页的序号。
< label id ="lblPageNumber" > < bindings > < binding dataContext ="view" property ="text" dataPath ="pageIndex" transform ="Add" /> </ bindings > </ label > < label id ="lblPageCount" > < bindings > < binding dataContext ="view" property ="text" dataPath ="pageCount" /> </ bindings > </ label > OK,在浏览器中测试一下:
这个DEMO的源文件可以在此下载: