首页 > 资讯列表 > 编程/数据库 >> ASP/.NET

介绍如何使用SqlPager分页控件

ASP/.NET 2011-06-28 12:06:58 转载来源: AS网站目录整理

  SqlPager分页控件是一个多功能灵活的分页控件,原理是利用了PagedDataSource()数据源进行分页处理,现此控件已集成于Winson.Framework框架里(以下简称WF),同时也使用了WF框架里的数据库低层操作语句,因此同时也可以支持多种数据库 <br />   <br />    一、主要

  SqlPager分页控件是一个多功能灵活的分页控件,原理是利用了PagedDataSource()数据源进行分页处理,现此控件已集成于Winson.Framework框架里(以下简称WF),同时也使用了WF框架里的数据库低层操作语句,因此同时也可以支持多种数据库
  
    一、主要功能:
  1、支持AJAX分页,也可设置后台Post模式
  2、支持多种分页按钮样式,同时也可以自定义按钮样式
  3、支持一次性读取所有数据,或者只读取当前页面数据进行分页
  4、可对GridView、Repeater、BaseDataList、ListControl等数据源控件进行绑定处理
  5、支持直接在页面写SQL语句读取数据,或者在后台设置自定义数据源进行绑定
  6、可对分页数据指定排序字段
  7、完全开源,可灵活修改,呵呵
  
  
    二、基本使用:
  1、新在页面顶部插入以下代码:

<%@ Register Assembly="Winson.WControls" Namespace="Winson.SqlPager" TagPrefix="SqlPager" %> 

  2、在需要放置分页控件的地方,插入以下代码:

  <SqlPager:SqlPager ID="SqlPager1" runat="server" ControlToPaginate="GridView1" Width="700"
   ItemsPerPage="4" BorderStyle=Dotted BackColor="#ffffff" PagerStyle=CustomAndNumeric
   FirstButton="第一页" PrveButton="上一页" NextButton="下一页" LastButton="最后一页"
   PagingMode="Cached" ></SqlPager:SqlPager> 

 
   基本参数说明:


  ID:即本分页控件的自身ID
  ControlToPaginate:分页控件需绑定的数据源控件的ID,本例中数据源控件为GridView
  BorderStyle:分页控件边框样式,本例中为虚线
  PagerStyle:即分页按钮的样式,此为一个枚举参数,同时也是设置是否使用AJAX的参数,以下将会有详细说明
  PagingMode:是否使用Cached,如果使用NonCached则只读取对当前页面数据,如为Cached,则一次性读取所有数据然后进行分页,建议数据量少时使用NonCached,但如果想与Tab控件配合使用,则必须要使用Cached模式 
  
 以下为分页按钮的自定义样式,只有当PagerStyle设置为自定义样式时才生效
  FirstButton:第一页的按钮样式
  PrveButton:上一页的按钮样式
  NextButton:下一页的按钮样式
  LastButton:最后一页的按钮样式
  
  
  3、以上代码配置好后,即可在后台为分页控件设置数据源,当然在前台也可以直接用参数设置
  
  设置数据源有2种方式,一种是直接在前台使用SelectCommand参数进行设置,如将以下语句直接加到控件标签里
  
  <SqlPager:SqlPager SelectCommand = "select * from Employees" ></SqlPager:SqlPager>
  另一种方式是可以使用自定义的数据源,如DataSet,但在使用自定义数据源之前,需将参数UseCustomDataSource设置为true,如下代码:
  
  SqlPager1.UseCustomDataSource = true;
   SqlPager1.CustomDataSource = DBOP.ExecuteDataset("select * from Employees ", "ds");
   SqlPager1.DataBind();
  以上方式只能在后台执行。需要注意的是,不管哪种方式,最后都必须在后台调用DataBind()方法。
  
    三、高级应用
  
    1、使用AJAX分页:
     本控件支持AJAX分页,但还必须写一些客户端的代码,相关的客户端代码我已在DEMO里有啦,具体可以打开PagerDemo.aspx文件查看,在需要分页的页面上添加以下JS代码:

  function setPageTo(pageIndex)
   {
   var context=document.getElementById("listDIV");
   context.innerHTML="数据加载中";
   var arg=pageIndex;
   <%= ClientScript.GetCallbackEventReference(this, "arg", "onCallServerComplete", "context")%>;
   }
  
   function onCallServerComplete(result,context)
   {
   context.innerHTML=result;
   } 


     然后在后台添加相应的AJAX方法,建议使用我DEMO里的方式,将这些代码添加到一个基类页面里,然后各页面继承来用,请看我的BasePage.cs文件,即以下代码:
  
  Ajax分页处理#region Ajax分页处理

   //引发回调事件处理
   public void RaiseCallbackEvent(string eventArgument)
   {
   serverReturn = eventArgument;
   }
  
   //回传回调结果
   public string GetCallbackResult()
   {
   return PageChange(serverReturn);
   }
   /**//**//**//// <summary>
   /// 执行分页操作
   /// </summary>
   /// <param name="newIndex">新页面的索引</param>
   /// <returns>需显示的页面数据</returns>
   private string PageChange(string newIndex)
   {
   int newPageIndex = int.Parse(newIndex);
   SqlPagerBase.GoToPage(newPageIndex);
   return GetRenderCode();
   }
  
   /**//**//**//// <summary>
   /// 将读取的数据呈现在客户端
   /// </summary>
   /// <returns></returns>
   private string GetRenderCode()
   {
   StringWriter writer1 = new StringWriter(System.Globalization.CultureInfo.InvariantCulture);
   HtmlTextWriter writer2 = new HtmlTextWriter(writer1);
  
   if (GridViewBase != null)
   {
   GridViewBase.Visible = true;
   GridViewBase.RenderControl(writer2);
   }
   else if (RepeaterBase != null)
   {
   RepeaterBase.Visible = true;
   RepeaterBase.RenderControl(writer2);
   }
   else if (DataListBase != null)
   {
   DataListBase.Visible = true;
   DataListBase.RenderControl(writer2);
   }
   else if (ListBase != null)
   {
   ListBase.Visible = true;
   ListBase.RenderControl(writer2);
   }
   SqlPagerBase.RenderControl(writer2);
   writer2.Flush();
   writer2.Close();
   return writer1.ToString();
   }
   #endregion 

  注意,如果你要将以上代码放到独立页面,必须要先继承System.Web.UI.ICallbackEventHandler接口!
  
  编写完以上代码后,再需将SqlPager里的PagerStyle属性设置为以Ajax开头的类型,以下是PagerStyle属性各参数的说明:


   **/**///// <summary>
   /// 页面样式设置
   /// </summary>
   public enum PagerStyle
   {
   /**//**//**//// <summary>
   /// 按钮样式为上下页箭头
   /// </summary>
   NextPrev,
   /**//**//**//// <summary>
   /// 按钮样式来下拉框页码
   /// </summary>
   NumericPages,
   /**//**//**//// <summary>
   /// 按钮和下拉框页码一起显示
   /// </summary>
   NextAndNumeric,
   /**//**//**//// <summary>
   /// 自定义样式,可自定文本
   /// </summary>
   CustomStyle,
   /**//**//**//// <summary>
   /// 自定义样式,可自定文本,同时显示下拉页码
   /// </summary>
   CustomAndNumeric,
   /**//**//**//// <summary>
   /// 无刷新箭头式按钮
   /// </summary>
   AjaxNext,
   /**//**//**//// <summary>
   /// 无刷新箭头式按钮加下拉页码
   /// </summary>
   AjaxNextAndNum,
   /**//**//**//// <summary>
   /// 无刷新下拉框按钮
   /// </summary>
   AjaxNumeric,
   /**//**//**//// <summary>
   /// 自定义无刷新分页
   /// </summary>
   AjaxCustomPages,
   /**//**//**//// <summary>
   /// 自定义无刷新和下拉框页码
   /// </summary>
   AjaxCustomAndNumeric
   } 

       2、配合TabControls使用:
     TabControls控件是从Discuz!DNT论坛里抽取出来的,感觉效果挺好,呵,就是类似一个Tab的效果,可以相互切换各自内容,而且此控件里可放任何其他控件或者代码,只是如果放其他的数据源控件,会有些问题,子控件的一些事件会触发不了,具体我也不知道什么原因:(
  
    同样,当时将此分页控件加到Tab里时,也出现了不少问题,不过现在已修复好这些问题了,但如需与Tab配合使用,现也只能使用AJAX模式!
  
     如需在Tab下使用SqlPager控件,只需设置以下2个参数后即可以了
  
  UseTabPager="true"
  PagingMode="NonCached"
  至于其他更多参数设置,请自行查看WF类库文档,均有说明了
  
  WF框架下载:
  http://bbs.szblogs.com/showtopic-137.html

标签: 介绍 如何 使用 SqlPager 分页 控件


声明:本文内容来源自网络,文字、图片等素材版权属于原作者,平台转载素材出于传递更多信息,文章内容仅供参考与学习,切勿作为商业目的使用。如果侵害了您的合法权益,请您及时与我们联系,我们会在第一时间进行处理!我们尊重版权,也致力于保护版权,站搜网感谢您的分享!

站长搜索

http://www.adminso.com

Copyright @ 2007~2024 All Rights Reserved.

Powered By 站长搜索

打开手机扫描上面的二维码打开手机版


使用手机软件扫描微信二维码

关注我们可获取更多热点资讯

站长搜索目录系统技术支持