[C#學習] DataAdapter.Fill()分頁

查詢結果分頁是以較小數據子集（即頁）的形式返回查詢結果的過程。 它通常用于以易于管理的小塊形式向用戶顯示結果。

DataAdapter 提供了通過 Fill 方法的重載來僅返回一頁數據的功能。 但是，對于大量的查詢結果，它可能并不是首選的分頁方法，因為 DataAdapter 雖然僅使用所請求的記錄來填充目標 DataTable 或 DataSet，但仍會使用返回整個查詢的資源。 若要在從數據源中返回一頁數據時不使用返回整個查詢的資源，請為查詢指定附加條件，使返回的行數減少到只返回所需的行。

若要使用 Fill 方法返回一頁數據，請指定 startRecord 參數（代表該數據頁中的第一個記錄），并指定 maxRecords 參數（代表該數據頁中的記錄數）。

以下代碼示例顯示如何使用 Fill 方法來返回查詢結果（頁大小為 5 個記錄）的第一頁。

int currentIndex = 0;

int pageSize = 5;

string orderSQL = ”SELECT * FROM Orders ORDER BY OrderID”;
// Assumes that connection is a valid SqlConnection object.
SqlDataAdapter adapter = new SqlDataAdapter(orderSQL, connection);

DataSet dataSet = new DataSet();
adapter.Fill(dataSet, currentIndex, pageSize, ”Orders”);

在上例中，DataSet 只填充了 5 個記錄，但卻返回了整個 Orders 表。 若要用相同的 5 個記錄填充 DataSet 但僅返回這 5 個記錄，請在 SQL 語句中使用 TOP 和 WHERE 子句，如以下代碼示例所示。

int pageSize = 5;

string orderSQL = ”SELECT TOP ” + pageSize +
“ * FROM Orders ORDER BY OrderID”;
SqlDataAdapter adapter = new SqlDataAdapter(orderSQL, connection);

DataSet dataSet = new DataSet();
adapter.Fill(dataSet, ”Orders”);

請注意，當以這種方式進行查詢結果分頁時，必須保留用于對行進行排序的唯一標識符，以便將唯一 ID 傳遞給用于返回下一頁記錄的命令，如以下代碼示例所示。

string lastRecord =

dataSet.Tables["Orders"].Rows[pageSize - 1]["OrderID"].ToString();

若要使用接受 startRecord 和 maxRecords 參數的 Fill 方法的重載來返回下一頁記錄，請使當前記錄索引按頁大小遞增，并填充該表。 請記住，即使僅在 DataSet 中添加一頁記錄，數據庫服務器仍會返回全部查詢結果。 在以下代碼示例中，先清除表行，然后再用下一頁數據填充這些表行。 您可能需要在本地緩存中保留一定數量的返回行，以減少與數據庫服務器的往返次數。

currentIndex += pageSize;

dataSet.Tables["Orders"].Rows.Clear();

adapter.Fill(dataSet, currentIndex, pageSize, ”Orders”);

若要返回下一頁記錄而不讓數據庫服務器返回整個查詢，請指定對 SQL SELECT 語句的限制條件。 由于上例保留了返回的最后一個記錄，因此可以在 WHERE 子句中使用它來指定查詢的起點，如以下代碼示例所示。

orderSQL = ”SELECT TOP ” + pageSize +

“ * FROM Orders WHERE OrderID > ” + lastRecord + ” ORDER BY OrderID”;
adapter.SelectCommand.CommandText = orderSQL;

dataSet.Tables["Orders"].Rows.Clear();

adapter.Fill(dataSet, ”Orders”);