利用ASP.NET實現分頁管理器(進階篇)

在DataGrid的web版控制項中提供了自動分頁的功能，但是我從來沒用過它，因為它實現的分頁只是一種假

相。我們為什麼需要分頁？那是因為合格記錄可能很多，如果一次讀取所有的記錄，不僅延長擷取

資料的時間，而且也極度浪費記憶體。而分頁的存在的主要目的正是為瞭解決這兩個問題（當然，也不排除

為了UI美觀的需要而使用分頁的）。而web版的DataGrid是怎樣實現分頁的了？它並沒有打算解決上述兩

個問題，而還是一次讀取所有的資料，然後以分頁的樣子表現出來。這是對效率和記憶體的極大損害！
　　於是我自己實現了分頁管理器IPaginationManager ，IPaginationManager 每次從資料庫中讀取指定

的任意一頁，並且可以緩衝指定數量的page。這個分頁管理器的主要特點是：
　　（1）支援隨機跳轉。這是通過嵌套Select語句實現的。
　　（2）支援緩衝。通過EnterpriseServerBase.DataStructure.FixCacher進行支援。
　　先來看看IPaginationManager介面的定義：

public interface IPaginationManager
{
　void Initialize(DataPaginationParas paras) ;
　void Initialize(IDBAccesser accesser ,int page_Size ,string whereStr ,string[] fields) ;//

如果選擇所有列，　fields可傳null

　DataTable GetPage(int index) ; //取出第index頁
　DataTable CurrentPage() ;
　DataTable PrePage() ;
　DataTable NextPage() ;

　int PageCount{get ;}
　int CacherSize{get; set; }
}
　　這個介面定義中，最主要的是GetPage()方法，實現了這個方法，其它的三個擷取頁面的方法

CurrentPage、PrePage、NextPage也就非常容易了。另外，CacherSize屬性可以讓我們指定快取頁面面的數

量。如果不需要緩衝，則設定其值<=0，如果需要無限緩衝，則值為Int.MaxValue。
　　IPaginationManager介面中的第二個Initialize方法，你不要關心，它是給XCodeFactory產生的資料

層使用了，我們來看看第一個Initialize方法的參數類型DataPaginationParas的定義：

public class DataPaginationParas
{
　public int PageSize = 10 ;
　public string[] Fields = {"*"}; //要搜尋出的列，"*"表示所有列

　public string ConnectString ;
　public string TableName ;
　public string WhereStr ; //搜尋條件的where字句

　public DataPaginationParas(string connStr ,string tableName ,string whereStr)
　{
　　this.ConnectString = connStr ;
　　this.TableName = tableName ;
　　this.WhereStr = whereStr ;
　}

　#region GetFiedString
　public string GetFiedString()
　{
　　if(this.Fields == null)
　　{
　　　this.Fields = newstring[] {"*"} ;
　　}

　　string fieldStrs = "" ;

　　for(int i=0 ;i　　{
　　　fieldStrs += " " + this.Fields[i] ;
　　　if(i != (this.Fields.Length -1))
　　　{
　　　　fieldStrs += " , " ;
　　　}
　　　else
　　　{
　　　　fieldStrs += " " ;
　　　}
　　}

　　return fieldStrs ;
　}
　#endregion

}

　　DataPaginationParas.GetFiedString用於把要搜尋的列形成字串以便嵌入到SQL語句中。

DataPaginationParas中的其它欄位的意思都很明顯。

　　現在來看看分頁管理器的實現了：

public class PaginationManager :IPaginationManager
{
　private DataPaginationParas theParas ;
　private IADOBase adoBase ;
　private DataTable curPage = null ;
　private int itemCount = 0 ;
　private int pageCount = -1 ;
　private int curPageIndex = -1 ;

　private FixCacher fixCacher = null ;
　private string fieldStrs = "" ;

　///
　/// cacheSize 小於等於0 －－ 表示不緩衝 ，Int.MaxValue －－ 緩衝所有
　///
　public PaginationManager(int cacheSize)
　{
　　if(cacheSize == int.MaxValue)
　　{
　　　this.fixCacher = new FixCacher() ;
　　}
　　else if(cacheSize >0)
　　{
　　　this.fixCacher = new FixCacher(cacheSize) ;
　　}
　　else
　　{
　　　this.fixCacher = null ;
　　}
　}

　public PaginationManager()
　{}

　#region IDataPaginationManager 成員
　public int CacherSize
　{
　　get
　　{
　　　if(this.fixCacher == null)
　　　{
　　　　return 0 ;
　　　}
　　　return this.fixCacher.Size ;
　　}
　　set
　　{
　　　if(this.fixCacher == null)
　　　{
　　　　this.fixCacher = new FixCacher(value) ;
　　　}
　　　else
　　　{
　　　　this.fixCacher.Size = value ;
　　　}
　　}
　}
　public int PageCount
　{
　　get
　　{
　　　if(this.pageCount == -1)
　　　{
　　　　string selCountStr = string.Format("Select count(*) from {0} {1}"

,this.theParas.TableName ,this.theParas.WhereStr) ;
　　　　DataSet ds= this.adoBase.DoQuery(selCountStr) ;
　　　　this.itemCount = int.Parse(ds.Tables[0].Rows[0][0].ToString()) ;
　　　　this.pageCount = this.itemCount/this.theParas.PageSize ;
　　　　if((this.itemCount%this.theParas.PageSize >0))
　　　　{
　　　　　++ this.pageCount ;
　　　　}
　　　}
　　　return this.pageCount ;
　　}
　}

　///
　/// GetPage 取出指定的一頁
　///
　public DataTable GetPage(int index)
　{
　　if(index == this.curPageIndex)
　　{
　　　return this.curPage ;
　　}

　　if((index < 0) || (index >(this.PageCount-1)))
　　{
　　　return null;
　　}

　　DataTable dt = this.GetCachedObject(index) ;

　　if(dt == null)
　　{
　　　string selectStr = this.ConstrutSelectStr(index) ;
　　　DataSet ds = this.adoBase.DoQuery(selectStr) ;
　　　dt = ds.Tables[0] ;

　　　this.CacheObject(index ,dt) ;
　　}
　　this.curPage = dt ;
　　this.curPageIndex = index ;
　　return this.curPage ;
　}

　private DataTable GetCachedObject(int index)
　{
　　if(this.fixCacher == null)
　　{
　　　return null ;
　　}
　　return (DataTable)this.fixCacher[index] ;
　}

　private void CacheObject(int index ,DataTable page)
　{
　　if(this.fixCacher != null)
　　{
　　　this.fixCacher.PutIn(index ,page) ;
　　}
　}

　public DataTable CurrentPage()
　{
　　return this.curPage ;
　}

　public DataTable PrePage()
　{
　　return this.GetPage((--this.curPageIndex)) ;
　}

　public DataTable NextPage()
　{
　　return this.GetPage((++this.curPageIndex)) ;
　}

　private string ConstrutSelectStr(int pageIndex)
　{
　　if(pageIndex == 0)
　　{
　　　return string.Format("Select top {0} {1} from {2} {3} ORDER BY ID"

,this.theParas.PageSize ,this.fieldStrs ,this.theParas.TableName ,this.theParas.WhereStr) ;
　　}

　　int innerCount = this.itemCount - this.theParas.PageSize*pageIndex ;
　　string innerSelStr = string.Format("Select top {0} {1} from {2} {3} ORDER BY ID DESC "

,innerCount , this.fieldStrs ,this.theParas.TableName ,this.theParas.WhereStr) ;
　　string outerSelStr = string.Format("Select top {0} * from ({1}) DERIVEDTBL ORDER BY ID"

,this.theParas.PageSize ,innerSelStr) ;

　　return outerSelStr ;
　}

　#region Initialize
　public void Initialize(IDBAccesser accesser, int page_Size, string whereStr, string[]

fields)
　{
　　this.theParas = new DataPaginationParas(accesser.ConnectString ,accesser.DbTableName

,whereStr) ;
　　this.theParas.Fields = fields ;
　　this.theParas.PageSize = page_Size ;

　　this.fieldStrs = this.theParas.GetFiedString() ;
　　this.adoBase = new SqlADOBase(this.theParas.ConnectString) ;
　}

　public void Initialize(DataPaginationParas paras)
　{
　　this.theParas = paras ;
　　this.fieldStrs = this.theParas.GetFiedString() ;
　　this.adoBase = new SqlADOBase(this.theParas.ConnectString) ;
　}

　#endregion
　#endregion
}
　　瞭解這個類的實現，可以從GetPage(int index)方法入手，另外私人方法ConstrutSelectStr()的實

現說明了如何使用嵌套sql語句進行隨機分頁搜尋。
　　最後，關於分頁管理器，需要指出的是，搜尋對應的表必須有一個名為"ID"的主鍵－－這是唯一的要

求。另外，分頁管理器實現用到的資料訪問低階封裝IADOBase定義於EnterpriseServerBase類庫中。
　　使用分頁管理器是很簡單的，加上UI介面後，只要把返回的DataTable綁定到DataGrid就可以了。