ASP.NET 3.5 帶來的 ListView 控制項,堪稱資料綁定與版面排版的一把好手。相比 2.0 時代的 GridView,它在可控元素和開發彈性上都有明顯進步,實際用起來往往比 DataGrid、GridView 更順手。ListView 本身並不內建分頁能力,但只要搭配新增的 DataPager 控制項,分頁可說是「零代碼」就能搞定:把 ListView 拖到頁面、配置好版面與資料來源,再放一個 DataPager,將它的 PagedControlID 指向 ListView 的 ID,用 PageSize 設定每頁筆數,最後在 Fields 裡挑一個分頁樣式(偷懶的話連樣式都不用管,ASP.NET 會套用內建外觀),執行起來就是一個能翻頁的 ListView 頁面。
3.5 的一個重要設計是把資料綁定控制項與分頁控制項徹底拆開。這意味著你可以把分頁器擺在頁面任何角落、自訂各種外觀,而且一個 DataPager 透過 PagedControlID 就能控制任一個資料綁定控制項。至於 ListView 與 DataPager 的細節用法,MSDN 寫得比我詳細,有興趣的讀者不妨自行查閱。
做資料綁定頁面時,資料量一大,如果一次全塞進頁面,載入就會變慢。於是我們把內容切成多頁,讓使用者逐頁瀏覽——這個思路人人都在用,本身沒問題,真正的差別在於「怎麼分」。
最直覺的做法是一次把所有頁的資料撈進記憶體(通常是伺服器記憶體),每次只顯示其中一頁。這種方式實作容易,早期幾乎所有支援分頁的資料綁定控制項都這麼幹,很多初學者跟著做也沒察覺異樣。對資料量小的網站來說確實無妨:純文字資料就算幾十 MB,也不過成千上萬筆,而現今伺服器記憶體動輒以 G 計,應付綽綽有餘。
但當某張表動輒上億筆,甚至欄位裡存的是檔案等二進位資料時,一次全載入就完全不切實際了。這時候就該改用「真分頁」:給定起始位置(或頁索引)、每頁筆數與總筆數,每次只向資料庫取當前頁所需的資料。如此一來伺服器負擔大減,資料量再大也游刃有餘。
聽起來真分頁很完美,可一旦放進 Ajax 的世界,問題就浮現了。Ajax 講究局部刷新,使用者點分頁按鈕後頁面能迅速更新,體驗確實棒。但總有性急的使用者會猛戳分頁鈕,甚至瘋狂連點。此時若每次都即時打資料庫,來不及更新的頁面就會跳出腳本錯誤,最終讓人以為分頁壞掉、程式當機。
解法是把「真分頁」與「假分頁」結合起來:一次預取 n 頁資料放進快取,翻頁時先判斷能否直接從快取拿,拿不到或過期了再回資料庫重新載入新的 n 頁。畢竟讀快取的速度遠勝讀庫。這樣只要資料還在快取裡,翻頁就有如飛梭;一旦超出範圍,才觸發一次資料庫重整。更新快取的過程,你甚至可以在 Ajax 裡採用同步方式,藉此約束使用者在此期間的 UI 操作。
分頁牽涉的細節其實很多,一篇文章很難鉅細靡遺,這裡僅分享一種在 ASP.NET Ajax 環境下實作真分頁的可行做法。為了省事,我直接在 Visual Studio 裡用了 ajaxToolkit 提供的 Ajax 控制項,它們整體還算好用。
很多人把「資料綁定控制項不支援真分頁」的帳算到 DataPager 頭上,這其實有點冤枉。DataPager 只負責分頁操作與使用者互動,它從不管資料來源的事。那資料來源該怎麼辦?綁定控制項又如何知道總共分成幾頁、目前取的是哪一頁?
我曾試著用 PagedDataSource 來分頁,後來發現它同樣得先把全部資料讀進記憶體,本質上仍是「假分頁」,和 DataGrid、GridView 沒兩樣。自 .NET 2.0 起,微軟推出一系列資料來源控制項(SqlDataSource、XmlDataSource、LinqDataSource 等)來簡化資料來源設定,但我始終認為它們除了省幾行 code 之外價值有限,還常常破壞程式結構,我一向不鼓勵在頁面裡直接擺這些控制項(做 demo 時倒是很方便)。直到研究 Ajax 真分頁時無意間注意到工具箱裡的 ObjectDataSource,才發現它是所有 DataSource 控制項中唯一真正支援「真分頁」的一個,靠幾個簡單屬性就能辦到。
SelectMethod:指定用來取分頁資料的方法名。這是自訂的 .NET 方法,可寫在頁面的 CodeBehind 中,把方法名交給此屬性即可,ObjectDataSource 會透過委派自動執行它。
TypeName:使用該控制項之類的完整名稱(含命名空間與類名)。此屬性必填,ASP.NET 靠反射來載入對應的類別與方法。
DataObjectTypeName:資料來源物件的完整型別名稱。ObjectDataSource 最大的亮點就是完全支援物件導向的資料操作——在分層架構裡,資料存取層會把資料表抽象成 class、欄位抽象成屬性,這個屬性指的就是那個資料類別。
EnablePaging:想開啟分頁,把它設為 True。
MaximumRowsParameterName:這是一個「參數名」(注意,不是每頁筆數本身),用來指示每頁顯示的筆數。ObjectDataSource 會依委派把這個參數傳進 SelectMethod 指定的方法。參數名稱務必與該方法的參數名完全一致。
StartRowIndexParameterName:同樣是參數名,用來指示每頁起始記錄的索引,用法與上一個相同。
SelectCountMethod:方法簽名,用來告訴 ObjectDataSource 如何得知資料源的總筆數。它同樣透過委派執行,簽名須與屬性值完全吻合。
接著在頁面放一個 ListView(或任何資料綁定控制項),把它的 DataSourceID 設為 ObjectDataSource 的 ID,再加一個 DataPager,把 PagedControlID 設為 ListView 的 ID 即可。

這是我資料來源中三張表的關聯圖:主表是 Shoutout,一筆 Shoutout 對應多個 Image,兩者透過 BaseComment 表關聯。下面會給出取得 Shoutout 分頁資料的預存程序。
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="AllShoutout.aspx.cs" Inherits="ShoutoutWallTest.AllShoutout" %>
<%@ Register Assembly="AjaxControlToolkit, Version=3.0.20820.415, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e"
Namespace="AjaxControlToolkit" TagPrefix="AjaxToolkit" %>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<asp:UpdatePanel ID="UpdatePanel1" runat="server" UpdateMode="Conditional">
<ContentTemplate>
<asp:ObjectDataSource ID="ObjectDataSource1" runat="server"
SelectMethod="LoadShoutouts"
TypeName="ShoutoutWallTest.AllShoutout"
DataObjectTypeName="Model.Shoutout"
EnablePaging="True"
MaximumRowsParameterName="maxRows"
StartRowIndexParameterName="startIndex"
SelectCountMethod="CountAll"></asp:ObjectDataSource>
<asp:ListView ID="lvShoutout" DataSourceID="ObjectDataSource1" runat="server"
ItemPlaceholderID="layoutTableTemplate" DataKeyNames="ID"
OnItemDataBound="lvShoutout_ItemDataBound">
<LayoutTemplate><div id="layoutTableTemplate" runat="server"></div></LayoutTemplate>
<ItemTemplate>
<div class="shoutoutallcontent">
<div class="shoutoutalltext"><%#Eval("Description") %></div>
<asp:ListView ID="lvImages" runat="server" ItemPlaceholderID="layoutImages"
DataSource='<%#Eval("Images")%>'>
<LayoutTemplate><div id="layoutImages" runat="server"></div></LayoutTemplate>
<ItemTemplate>
<img src='Thumbnail.aspx?basecommentid=<%#Eval("BaseCommentID")%>&imagetitle=<%#Eval("Title")%>'
alt="" class="shoutoutimg" />
</ItemTemplate>
</asp:ListView>
</div>
</ItemTemplate>
</asp:ListView>
<asp:DataPager ID="DataPager1" runat="server" PagedControlID="lvShoutout" PageSize="25">
<Fields>
<asp:NextPreviousPagerField ButtonType="Image" ShowFirstPageButton="true" ShowNextPageButton="false" ShowPreviousPageButton="false" />
<asp:NumericPagerField ButtonType="Button" ButtonCount="5" />
<asp:NextPreviousPagerField ButtonType="Image" ShowLastPageButton="true" ShowNextPageButton="false" ShowPreviousPageButton="false" />
</Fields>
</asp:DataPager>
</ContentTemplate>
</asp:UpdatePanel>
</form>
我把資料綁定控制項與分頁控制項都放進 UpdatePanel,如此翻頁與綁定都能在不重整整頁的情況下完成。範例裡用了巢狀的 ListView,因為一筆 Shoutout 會對應多張 image,而資料實體類的 Shoutout 有個類似 List<Image> Images 的屬性,我便直接把它當成子 ListView 的資料來源,用來顯示每筆 Shoutout 的縮圖。縮圖怎麼呈現不是本文重點,這裡從略。
接下來只要實作前面指定的兩個方法即可。LoadShoutouts() 負責取回 Shoutout 集合(回傳 List<Shoutout>),實際上只要呼叫資料庫的分頁預存程序,該程序能同時回傳資料集與總筆數;CountAll() 則單純回傳總筆數。
using System;
using System.Collections.Generic;
using Model;
using BLL;
namespace ShoutoutWallTest
{
public partial class AllShoutout : System.Web.UI.Page
{
public static List<Shoutout> list = null;
private static int ItemCount = 0;
public List<Shoutout> LoadShoutouts(int startIndex, int maxRows)
{
int itemCount;
int pageIndex = 1;
if (startIndex > 0)
{
pageIndex = startIndex / 25 + 1;
}
list = ShoutoutBLL.GetShoutouts(13, pageIndex, maxRows, true, out itemCount);
ItemCount = itemCount;
return list;
}
public int CountAll()
{
return ItemCount;
}
// 更新或刪除後刷新資料
private void RefreshData()
{
lvShoutout.DataSourceID = ObjectDataSource1.ID;
}
}
}
我的範例每頁顯示 25 筆。ShoutoutBLL.GetShoutouts() 有五個參數:第一個是查詢條件(屬本例特例,可忽略);第二個是頁索引,從 1 起算,我在方法裡把 startIndex 換算成了 pageIndex;第三個是每頁筆數;第四個是 out 參數,回傳總筆數,主要對應資料庫預存程序;第五個控制是否帶出圖片。Model 命名空間則負責回傳 Shoutout、Image 等實體物件。RefreshData() 重新指定 ListView 的 DataSourceID,即可重新綁定並達到刷新效果。

上圖是程式執行後的局部截圖,可見分頁 UI 已正常呈現,而這整套翻頁操作我一行代碼都沒寫,全交給 DataPager 打理。由於 ListView 與 DataPager 都在 UpdatePanel 內,使用者點分頁鈕時只更新了 ListView 的資料、沒有刷新整頁,而且資料是逐頁從資料庫取得的——這正是 Ajax 情境下的「真分頁」,核心就是 ObjectDataSource。
以下是我用來取分頁資料的預存程序,採用暫存表方式實作分頁,供讀者參考:
ALTER PROCEDURE [dbo].[GetShoutOuts]
@LocationID INT,
@PageIndex INT, -- 從 1 起算
@PageSize INT,
@showimages BIT,
@ItemCount INT OUTPUT
AS
BEGIN
SET NOCOUNT ON;
DECLARE @beginRowNumber bigint, @endRowNumber bigint;
SET @beginRowNumber = (@PageIndex - 1) * @PageSize + 1;
SET @endRowNumber = @PageIndex * @PageSize;
WITH TempPagingRecord AS
(
SELECT ROW_NUMBER() OVER (ORDER BY PostedDate DESC) AS RecordNumber,
SO.ID AS ShoutOutID, BC.[Description], BC.PostedByName, BC.PostedDate,
NULL AS ImageTitle, NULL AS ImageBlob, NULL AS Type,
BC.ID AS BaseCommentID, BC.DisplayUserName, BC.IsVisible,
SO.NotifyToShoutOutUser, SO.ShoutOutToUserAlias
FROM dbo.ShoutOut AS SO
JOIN dbo.BaseComment AS BC ON BC.ID = SO.BaseCommentID
WHERE SO.LocationID = @LocationID AND BC.IsVisible = 1
)
SELECT RecordNumber, ShoutOutID, Description, PostedByName, PostedDate,
ImageTitle, ImageBlob, BaseCommentID, DisplayUserName, IsVisible,
NotifyToShoutOutUser, ShoutOutToUserAlias
INTO #tempTable
FROM TempPagingRecord
WHERE RecordNumber BETWEEN @beginRowNumber AND @endRowNumber;
IF (@showimages = 1)
BEGIN
SELECT T.RecordNumber, T.ShoutOutID, T.Description, T.PostedByName, T.PostedDate,
IM.ImageTitle, IM.ImageBlob, IM.Type, T.BaseCommentID,
T.DisplayUserName, T.IsVisible, T.NotifyToShoutOutUser, T.ShoutOutToUserAlias
FROM #tempTable T
LEFT JOIN dbo.Image IM ON IM.BaseCommentID = T.BaseCommentID
ORDER BY T.PostedDate DESC;
END
ELSE
BEGIN
SELECT * FROM #tempTable ORDER BY PostedDate DESC;
END
SELECT @ItemCount = COUNT(*)
FROM Shoutout AS SO
JOIN dbo.BaseComment AS BC ON BC.ID = SO.BaseCommentID
WHERE SO.LocationID = @LocationID AND BC.IsVisible = 1;
END
在我看來,ObjectDataSource 是個相當「聰明」的控制項:它靠函式委派自動執行使用者提供的分頁邏輯,完成資料庫的真分頁,省下不少開發上的麻煩,值得花時間好好研究。
點擊下載本例源碼