C# WinForms通用分页控件实现方法

桃夭

发布时间：2026-10-14| 3人浏览过

原创

在C# WinForms开发中，处理大量数据显示时，通用的分页控件能显著提升开发效率与用户体验。本文将演示如何构建一个集成前端交互、后端数据获取及自动刷新功能的 PagingCtrl 类。

结果或目标

该实现旨在解决WinForms中复杂列表的数据分块显示问题。最终目标是获得一个可复用的控件类，它接收一组UI组件（如按钮、组合框），并自动绑定到指定的Web服务接口，实现首页、上一页、下一页、末页跳转以及页面大小调整等功能。

准备条件

基于 .NET Framework 的 Windows 窗体应用 (WinForms)。
项目需引用 System.Data 以支持数据集操作。
存在一个可访问的 WebService 接口用于返回XML格式的分页数据。
界面设计器中包含以下基本控件实例：

Button：用于触发首页(_btFirst)、上一页(_btPreview)、下一页(_btNext)、末页(_btLast)及刷新(_btreflesh)动作。
ComboBox：_comPageSize 选择每页记录数；_comToPageIndex 直接跳转至指定页码。
Label：_msg 用于显示当前页信息（如“第1页/共5页”）。
DataGrid：_dv（此处使用 C1.Win.C1FlexGrid.C1FlexGrid，也可替换为标准的 DataGridView），用于渲染数据。

真实操作顺序

第1步：定义控制器的核心属性与事件回调

首先，创建一个名为 PagingCtrl 的类。该类需要存储内部的状态变量，包括当前页索引(_PageIndex)、页大小(_PageSize)及总记录数(_RecodeCount)。同时，定义委托类型以支持在数据加载前后的状态提示：

public delegate string LoadXML(int PageIndex, int PageSize);
public delegate void afterDataLoadDelegate();
public delegate void beforeDataLoadDelegate();
public delegate void errorDataLoadDelegate(string ErrMSG);

接着，将上述UI控件保存为类的私有字段，以便后续进行绑定和状态管理。

第2步：实例化构造函数与UI绑定

构造函数接收所有必需的UI组件、WebService通信命令标识(webseiviceComm)以及必要的回调函数。在构造过程中，不仅赋值字段，还需利用Lambda表达式或方法引用将这些按钮和下拉框的事件与内部处理方法连接起来：

if (_btFirst != null)
    _btFirst.Click += new System.EventHandler(this.btFirst_Click); // ...其他控件同理

在此阶段，还初始化了防止重复触发的锁标志位 _comToPageIndex.Tag = "";。

第3步：实现核心数据加载逻辑 (`LoadData`)

这是分页系统的引擎。调用 LoadData(string webservicecomm, string Xmlcommand) 后，流程如下：

防重入检查：通过检查Tag标记位，避免用户快速点击导致的并发请求冲突。
触发前置事件：执行 _beferDataLoad()，例如在界面上显示进度条。
执行远程调用：调用私有方法 LoadWebServiceData。该方法通过解析XML响应，将结果装入 DataSet 对象。若返回失败则抛出异常。
数据源分配：若成功，将DataSet中的 table0 赋给网格控件 _dv.DataSource。
UI状态同步：解析脚本表(TabScript)中的元数据，更新当前的 _PageSize、_ReCodeCount。并根据计算出的总页数，动态重建 _comToPageIndex 的下拉选项内容。
按钮有效性判断：当处于第一页时禁用首页和上一页按钮；处于末页时禁用末页和下一页按钮。
异常处理与后置通知：如果中间发生网络错误或数据解析错误，进入catch块并通过 _errorDataLoad 向用户汇报具体原因。最后无论成功与否，都执行 _afterDataLoad（隐藏进度条）。每次执行完毕，重置Tag标志位允许下次操作。