如何使用 IronPDF 在 .NET 中构建可投入生产的发票生成器

Source: Dev.to

发票生成器需求

业务需求

• 创建发票客户和发件人
• 创建发票：发票及日期详情、已有的客户和发件人数据、明细行
• 生成并下载发票 PDF 文件

PDF 需求

• 任意长度下布局一致：单条或数百行都能整洁分页。
• 在任何设备上渲染准确、格式稳定。
• 高质量渲染，文字、徽标和表格清晰，适合打印或归档。
• PDF/UA 合规，满足长期存储和审计需求。
• 数字签名以证明完整性和来源，可选可见签名外观。
• 完全托管、跨平台运行时，生成快速、运行开销小。

UI 功能

首页

• 选项卡：发票、客户、发件人

发票

• 以表格视图分页列出发票
• 创建新发票
• 表格操作：查看、编辑、删除（需确认）、下载 PDF

客户

• 以表格视图分页列出客户
• 创建新客户
• 表格操作：查看、编辑、删除（需确认）

发件人

• 以表格视图分页列出发件人
• 创建新发件人
• 表格操作：查看、编辑、删除（需确认）

实现技术栈

后端

• ASP.NET Core 10、EF Core、IronPDF 用于生成 PDF

前端

• React、TypeScript、TailwindCSS

架构

• 模块化单体
• 垂直切片架构 + 清洁架构

数据库

• PostgreSQL

部署

• Docker Compose

发票生成器 UI 概览

首页

发票 选项卡显示发票列表，并提供查看、编辑、删除和下载 PDF 等操作。创建新发票前必须先存在相应的客户和发件人。

创建客户 / 发件人

创建发票表单

需要填写的字段

• 发票详情（编号、日期、税率、备注等）
• 发件人信息
• 客户信息
• 明细行

从下拉框中选择客户和发件人。

点击 Create Invoice 后，发票会存入数据库。PDF 可以在发票详情页或发票列表中下载。

选择 C# PDF 库用于发票生成

在 C# 与 ASP.NET Core 中生成 PDF 有多种方案：

• IronPDF
• QuestPDF
• Aspose.PDF
• PuppeteerSharp

IronPDF

IronPDF 是一款功能强大的 .NET 库，可用于创建、编辑、签名和渲染 PDF，提供开发者友好的流式 API。

优点

• 支持 HTML、DOCX、RTF、XML、MD、图片转 PDF
• 支持从 URL 生成 PDF、PDF 转 HTML
• 符合 PDF/A、PDF/UA、PDF/X 标准
• 完全托管、跨平台
• 高性能渲染
• 数字签名与安全功能
• 丰富的 PDF 操作（编辑、合并、拆分）
• 文档完善

缺点

• 商业使用需付费授权。

QuestPDF

QuestPDF 是一个开源 PDF 生成库，使用流式 C# API 直接在代码中构建文档。

优点

• 流式 C# API，基于布局的方式
• 对结构化文档输出一致、可重复
• 文档丰富，示例众多
• 对小型公司免费，可用于商业用途

缺点

• 不支持 HTML 转 PDF
• 未内置 PDF/A 或 PDF/UA 合规支持
• 缺少数字签名、安全、交互式表单或 JavaScript 渲染功能
• 大型公司需付费授权才能商业使用

Aspose.PDF

Aspose.PDF 提供高级的编程式 PDF 创建与操作能力。

优点

• 对 PDF 元素（段落、表格、图片、表单、批注）有广泛控制
• 复杂工作流的高级操作功能
• 支持 PDF/A 标准和数字签名
• 成熟的企业级库，历史悠久

缺点

• API 冗长，即使是简单任务也需要大量代码，学习曲线较陡
• HTML 转 PDF 支持有限，缺少原生 Chromium 引擎，渲染受限

PuppeteerSharp

注：原文未详细说明，此处仅作补充。

通过对比优缺点，IronPDF 在需要 HTML 转 PDF、合规标准以及数字签名功能的生产环境发票生成器中表现突出，成为强有力的候选方案。