C#中PDF操作-QuestPDF介绍和使用教程

一、QuestPDF 简介

QuestPDF 是一个专为 .NET 平台打造的现代化 PDF 生成库，它采用声明式、代码驱动的设计理念，让你直接用 C# 代码描述文档结构，无需依赖 HTML 转换或外部渲染引擎-7。其强大的 Fluent API 支持链式调用，内置布局引擎能够自动处理分页与换行，非常适合用于生成发票、报表、合同、数据导出等场景-7。

二、环境搭建

2.1 安装

QuestPDF 通过 NuGet 安装，在 .NET 6+ 项目中直接使用即可

dotnet add package QuestPDF

2.2 许可证配置

根据项目类型，需要在应用启动时设置许可证。对于个人、非营利组织以及年营收低于 100 万美元的企业，可以免费使用社区版

// 社区版许可证（只需配置一次，通常放在 Program.cs 中）QuestPDF.Settings.License = LicenseType.Community;

如果不配置许可证就会报错

System.Exception:“Thank you for choosing QuestPDF 👋Before you continue, please take a moment to configure your license. This step helps ensure correct license compliance.QuestPDF requires a Commercial License for production use by organizations with more than $1M USD in annual gross revenue. Individuals, non-profits, open-source projects, and smaller companies qualify for the free Community license.If you are not the decision-maker for software purchases, please share the licensing and pricing details with your team lead or manager: https://www.questpdf.com/license Available license options:- Community: free,- Evaluation: intended solely for evaluation before choosing an appropriate license; not suitable for production use,- Professional: paid, for teams up to 10 developers with dedicated support,- Enterprise: paid, for unlimited developers with prioritized dedicated support.Set the license once at application startup. By doing so, you confirm that the selected tier matches your usage:> QuestPDF.Settings.License = LicenseType.Evaluation; // or Community / Professional / EnterpriseNo license key or activation is required — we trust you to select the correct option. By choosing the right license, you help ensure QuestPDF remains sustainable and continuously improving for everyone. We wish you a great experience! 🚀”

2.3 引入命名空间

using QuestPDF.Fluent;using QuestPDF.Helpers;using QuestPDF.Infrastructure;

三、核心概念与文档结构

QuestPDF 的文档结构遵循文档 → 页面 → 容器 → 元素的层次模型-7：

Document
：文档的入口，通过 Document.Create() 定义整体结构。
Page
：代表单个页面，可设置尺寸、边距、页眉、页脚、背景等属性。
Container
：布局容器，负责组织子元素（如 Column、Row 等）。
Element
：具体内容元素，如文本（Text）、图片（Image）、表格（Table）等。

Document 是一个不可变的构建器对象——调用 Create() 后返回的只是一个声明式的描述，并不会立即生成文件；必须显式调用 .GeneratePdf()（同步）或 .GeneratePdfAsync()（异步），传入文件路径或 Stream 才能真正写出 PDF

四、基础使用

生成第一个PDF文档

添加一个文本

using QuestPDF.Fluent;using QuestPDF.Helpers;using QuestPDF.Infrastructure;// 设置许可证QuestPDF.Settings.License = LicenseType.Community;Document    .Create(container =>    {        container.Page(page =>        {            page.Size(PageSizes.A4);            page.Margin(20);            page.Content().Text("Hello World  PDF");        });    })    .GeneratePdf("test.pdf");

使用Column纵向排两行

    Document        .Create(container =>        {            container.Page(page =>            {                page.Size(PageSizes.A4);                page.Margin(20);                //page.Content().Text("Hello World  PDF");                page.Content()                    .Column(col =>                    {                        col.Item().Text("QuestPDF!").FontSize(24).Bold();                        col.Item().Text("这是我的第一个 PDF 文档。").FontSize(14);                    });            });        })        .GeneratePdf("test.pdf");