科技行者

行者学院 转型私董会 科技行者专题报道 网红大战科技行者

知识库

知识库 安全导航

至顶网软件频道PageNavigator控件实现客户端分页

PageNavigator控件实现客户端分页

  • 扫一扫
    分享文章到微信

  • 扫一扫
    关注官方公众号
    至顶头条

在这个系列中,我将介绍一些Atlas Sys.UI.Data中较高级的控件,包括:

作者:中国IT实验室 来源:中国IT实验室 2007年9月5日

关键字: 客户端 PageNavigator

  • 评论
  • 分享微博
  • 分享邮件
 在这个系列中,我将介绍一些Atlas Sys.UI.Data中较高级的控件,包括:
  
  Sys.UI.Data.ListView:使用ASP.NET Atlas ListView控件显示列表数据
  Sys.UI.Data.ItemView:使用ASP.NET Atlas ItemView控件显示集合中的单个数据
  Sys.UI.Data.DataNavigator:使用 ASP.NET Atlas PageNavigator控件实现客户端分页导航
  Sys.UI.Data.SortBehavior:待续
  
  Sys.UI.Data.XSLTView:待续
  这篇是其中的第三篇:使用 ASP.NET Atlas PageNavigator控件实现客户端分页导航
  把所有的记录统统放在一个页面上绝对不是一个好主意,特别是当您有成百上千条记录时。您的用户需要不停的拖动滚动条,甚至使用Control+F来找到所期待的内容,这将带来相当差的用户体验。这时,将数据以分页的方式显示给用户将友好的多。一些ASP.NET服务器端控件拥有内建的分页及页面导航功能,例如DataGrid和GridView。同样的,Atlas客户端控件Sys.UI.Data.DataNavigator也提供了类似的功能,这将大大提高我们的开发效率。
  
  DataNavigator控件将与DataView(请参考:Atlas命名空间Sys.Data下控件介绍——DataView和DataFilter )控件一起工作。我们知道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 _data;
   static object _dataLock = new object();
  
   private static List Data
   {
   get
   {
   if (_data == null)
   {
   lock (_dataLock)
   {
   if (_data == null)
   {
   _data = new List();
   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控件的模版,请参考我的这篇文章:使用ASP.NET Atlas ListView控件显示列表数据
  
  
  
  
  
  
  

  

  
  
  
  
  
  

  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
No.NameEmail

  
  

   No Data
  

  

  最后该书写Atlas的XML脚本定义了,有如下五个部分:
第一部分:Atlas客户端控件DataSource,用来从我们上面定义的Web Service中取得数据。
  
  
  第二部分:一个DataView控件(请参考:Atlas命名空间Sys.Data下控件介绍——DataView和DataFilter ),用来将第一部分中取得的那100条数据分页。
  
  
  
  
  

  

  第三部分:一个ListView控件(请参考: 使用ASP.NET Atlas ListView控件显示列表数据 ),用于显示分页好的数据。