c#如何生成报表_c#生成报表深入理解与底层原理-C#.Net教程-PHP中文网

printdocument 是 windows forms 的底层打印通道，用于简单打印（如小票），而非生成复杂报表；它仅提供 graphics 绘图能力，缺乏自动分页、多格式导出及样式管理等报表核心功能。

c#如何生成报表_c#生成报表深入理解与底层原理

PrintDocument 不是报表生成器，它只是 Windows Forms 下的底层打印通道。真正在 C# 中“生成报表”，核心动作是：把结构化数据按业务规则渲染成可读、可导出、可复用的视觉文档——这一步必须依赖专用报表引擎或手动构造输出格式。

为什么不用 `PrintDocument` 直接做报表？

很多人卡在第一步：以为绑个 PrintPage 事件、用 e.Graphics.DrawString 拼几行字就是“生成报表”。实际会立刻撞上三堵墙：

没有自动分页逻辑 —— 表格跨页时表头不重复、页脚不居中、内容被截断
无法导出 PDF/Excel —— PrintDocument 只走打印机驱动，不产生文件流
样式与数据强耦合 —— 字体、边框、合并单元格全靠手算坐标，改一个字段位置就要重调所有 DrawString 坐标

换句话说：PrintDocument 是“画图”，不是“生成报表”。它适合极简单据（如小票），但不适用于带分组、交叉汇总、动态列、条件高亮的业务报表。

`FastReport` 和 `CrystalReports` 的数据绑定本质是什么？

它们不是魔法，底层都是 ADO.NET + 报表模板解析引擎。关键差异在于数据消费方式：

FastReport 默认接受 DataTable、IEnumerable<t></t> 或 IDataReader，内部将数据转为命名数据集（如 "Orders"），模板里用 {Orders.OrderID} 引用
CrystalReports 强依赖 DataSet 结构，要求模板设计时就绑定到特定 DataTable 名称和字段名；运行时若字段缺失或类型不匹配，直接抛 CrystalReportsException
两者都支持参数化查询，但 FastReport 的 Report.GetDataSource("Orders") 可运行时替换数据源，CrystalReports 的 SetDataSource() 必须在加载前调用，否则报 InvalidOperation

所以别迷信“拖控件就完事”——模板里写的每个 {xxx} 都对应一次反射取值或索引器访问，字段名拼错一个字母，预览时就空白。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

NPOI 手动生成 Excel 报表时，样式共享陷阱怎么破？

NPOI 的 ICellStyle 是工作簿级共享对象。常见错误是：

循环写入多行时，反复调用 cell.CellStyle = workbook.CreateCellStyle() —— 看似新建，实则创建了大量冗余样式，Excel 打开时提示“文件已损坏”
想给某列加红色字体，却修改了全局 DefaultCellStyle，导致所有未显式设样式的单元格也变红

正确做法是缓存样式对象：

// ✅ 推荐：按样式特征哈希缓存
private static readonly Dictionary<string icellstyle> _styleCache = new();
public static ICellStyle GetOrCreateStyle(IWorkbook wb, string key) {
    if (!_styleCache.TryGetValue(key, out var style)) {
        style = wb.CreateCellStyle();
        // 根据 key 解析并设置字体、对齐等...
        _styleCache[key] = style;
    }
    return style;
}
</string>

注意：key 必须包含所有影响样式的维度（字体名+大小+颜色+对齐+边框），漏一个就可能复用错样式。

报表导出 PDF 时中文乱码的根本原因

不是字体没嵌入，而是 PDF 渲染引擎默认用 Base14 字体（如 Helvetica），不支持中文。不同工具处理方式不同：

FastReport：需在设计器里选中文本控件 → 属性面板设 Font.Name = "SimSun" → 勾选 Embed Font（否则部署到无中文字体的服务器就乱码）
CrystalReports：必须提前在开发机安装对应字体，并在报表属性中启用 Use Unicode Fonts，否则导出 PDF 时自动降级为 ???
纯代码方案（如 iTextSharp）：必须显式注册中文字体路径，且 PDF 内容要用 BaseFont.CreateFont("simhei.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED) —— 注意 NOT_EMBEDDED 在无字体环境必乱码