数据网格 Web 控件有内置的自动或自定义分页功能,但是
数据网格 Windows 控件却没有这些功能。本文介绍如何为
数据网格 Windows 控件创建简单的分页机制。
本文中的代码示例利用了
数据集对象。在 ADO.NET 中,
数据集对象是通过单次操作填充的,它们始终驻留在内存中。如果您在使用一个大型
数据集,本文介绍如何以编程方式按块区或页面形式显示数据。
本示例将 Microsoft SQL Server Northwind 数据库中的 Customers 表用作数据库后端。如果连接到任何其他数据库或一个不同的表,请确保相应地更新代码。
此技巧有一些局限性。有关更多信息,请参阅
疑难解答一节。
返回页首
要求
下面的列表列出了推荐使用的硬件、软件、网络结构以及所需的 Service Pack:
• | Microsoft Windows 2000 Professional、Windows 2000 Server、Windows 2000 Advanced Server 或 Windows NT 4.0 Server |
• | Microsoft Visual Studio .NET |
• | Microsoft SQL Server 7.0 或更高版本 |
本文假定您熟悉下列主题:
• | Visual C# .NET |
• | ADO.NET 基础知识和语法 |
返回页首
向 DataGrid Windows 控件添加分页的步骤
当您对
DataGrid 进行分页时,您会在页面大小的"块区"中显示数据,即,一次显示一页记录。下面的代码示例将每页的
DataRow 对象从内存中的
数据集复制到一个临时表中。该临时表然后会绑定到
DataGrid(数据网格)控件。
1. | 打开新的 Visual C# .NET Windows 应用程序项目。 |
2. | 添加 DataGrid 控件,将其 ReadOnly 属性设置为 True。 |
3. | 将以下附加控件添加到 Form1 上,然后按如下所示设置它们的属性:
控件 | Name 属性 | Text 属性 |
---|
Button | btnFirstPage | First Page | Button | btnNextPage | Next Page | TextBox | txtDisplayPageNo | | Button | btnPreviousPage | Previous Page | Button | btnLastPage | Last Page | TextBox | txtPageSize | 5 | Button | btnFillGrid | Fill Grid | DataGrid | dataGrid1 | |
|
4. | 将下面的代码复制并粘贴到 Form1 的代码窗口的顶部。确保对每个名称空间只引用一次。默认情况下可能已经引用 System 和 System.Data。 using System;
using System.Data;
using System.Data.SqlClient;
|
5. | 复制以下代码并将其粘贴到公共类 Form1 的顶部 以便为 Form1 声明窗体级变量: SqlDataAdapter da;
DataSet ds;
DataTable dtSource;
int PageCount;
int maxRec;
int pageSize;
int currentPage;
int recNo;
|
6. | 复制以下代码并将其粘贴到紧挨在静态的空 Main 方法之后的位置,以使其作用范围为窗体级: private void LoadPage() {
int i;
int startRec;
int endRec;
DataTable dtTemp;
//Clone the source table to create a temporary table.
dtTemp = dtSource.Clone();
if (currentPage == PageCount) {
endRec = maxRec;
}
else {
endRec = pageSize * currentPage;
}
startRec = recNo;
//Copy rows from the source table to fill the temporary table.
for (i = startRec; i < endRec; i++) {
dtTemp.ImportRow(dtSource.Rows[i]);
recNo += 1;
}
dataGrid1.DataSource = dtTemp;
DisplayPageInfo();
}
private void DisplayPageInfo() {
txtDisplayPageNo.Text = "Page " + currentPage.ToString() + "/ " + PageCount.ToString();
}
private bool CheckFillButton() {
//Check if the user clicks the "Fill Grid" button.
if (pageSize == 0) {
MessageBox.Show("Set the Page Size, and then click the Fill Grid button!");
return false;
}
else {
return true;
}
}
|
7. | 将以下代码粘贴到 Form1_Load 事件过程中: //Open Connection.
SqlConnection con = new SqlConnection("server=server;uid=login;pwd=pwd;database=northwind");
//Set the DataAdapter's query.
da = new SqlDataAdapter("select * from customers", conn);
ds = new DataSet();
//Fill the DataSet.
da.Fill(ds, "customers");
//Set the source table.
dtSource = ds.Tables["customers"];
|
8. | 修改上述代码中出现的连接字符串,使之适合您的环境: SqlConnection con = new SqlConnection("server=server;uid=login;pwd=pwd;database=northwind");
</WWCODE>
<WWITEM>双击<B> Fill Grid</B> 以打开 btnFillGrid 的代码窗口。复制以下代码并将其粘贴到 <B>btnFillGrid_Click</B> 事件过程中: </WWITEM>
<WWCODE>
<![CDATA[
// Set the start and max records.
pageSize = Convert.ToInt32(txtPageSize.Text);
maxRec = dtSource.Rows.Count;
PageCount = maxRec / pageSize;
//Adjust the page number if the last page contains a partial page.
if ((maxRec % pageSize) > 0) {
PageCount += 1;
}
// Initial seeings
currentPage = 1;
recNo = 0;
// Display the content of the current page.
LoadPage();
|
9. | 双击 First Page 以打开 btnFirstPage 的代码窗口。复制以下代码并将其粘贴到 btnFirstPage_Click 事件过程中: if (CheckFillButton() == false) {
return;
}
//Check if you are already at the first page.
if (currentPage == 1) {
MessageBox.Show("You are at the First Page!");
return;
}
currentPage = 1;
recNo = 0;
LoadPage();
|
10. | 双击 Next Page 以打开 btnNextPage 的代码窗口。复制以下代码并将其粘贴到 btnNextPage_Click 事件过程中: //If the user did not click the "Fill Grid" button, then return.
if (CheckFillButton() == false) {
return;
}
//Check if the user clicks the "Fill Grid" button.
if (pageSize == 0) {
MessageBox.Show("Set the Page Size, and then click the Fill Grid button!");
return;
}
currentPage += 1;
if (currentPage > PageCount) {
currentPage = PageCount;
//Check if you are already at the last page.
if (recNo == maxRec) {
MessageBox.Show("You are at the Last Page!");
return;
}
}
LoadPage();
|
11. | 双击 Previous Page 以打开 btnPreviousPage 的代码窗口。复制以下代码并将其粘贴到 btnPreviousPage_Click 事件过程中: if (CheckFillButton() == false) {
return;
}
if (currentPage == PageCount) {
recNo = pageSize * (currentPage -2);
}
currentPage -= 1;
//Check if you are already at the first page.
if (currentPage < 1) {
MessageBox.Show("You are at the First Page!");
currentPage = 1;
return;
}
else {
recNo = pageSize * (currentPage - 1);
}
LoadPage();
|
12. | 双击 Last Page 以打开 btnLastPage 的代码窗口。复制以下代码并将其粘贴到 btnLastPage_Click 事件过程中: if (CheckFillButton() == false) {
return;
}
//Check if you are already at the last page.
if (recNo == maxRec) {
MessageBox.Show("You are at the Last Page!");
return;
}
currentPage = PageCount;
recNo = pageSize * (currentPage - 1);
LoadPage();
|
13. | 按 F5 键生成并运行此项目。 |
14. | 默认情况下,Page Size(页面大小)设置为 5 条记录。可以在文本框中更改此设置。 |
15. | 单击 Fill Grid。注意,DataGrid(数据网格)中填充了 5 项记录。 |
16. | 单击 First Page、Next Page、Previous Page 和 Last Page 可以在不同的页面之间浏览。 |
返回页首
疑难解答
• | 此技巧仅适用于只读 DataGrid 控件。当您向 DataTable 对象中导入一行数据时,实际上是创建了一个副本。所以,所作的更改将不会保存到主表中。 |
• | 如果想让用户能够通过一个 DataRelation 对象定位到子记录,或者如果您的记录以父子关系相链接并且同时出现在窗体上,则无法使用此技巧(也不能用集合或数组)。 |
返回页首
有关 ADO.NET 的更多信息,请访问以下 MSDN Web 站点:
有关更多信息,请参阅 Microsoft .NET 框架 SDK 文档:
返回页首