C#使用Free Spire.XLS实现Excel转PDF：整表、单表与区域转换

为什么选择编程方式转换

虽然Microsoft Office或WPS提供了内置的“另存为PDF”功能，但在自动化业务场景下，这种方式存在明显局限：通常只能导出全部工作表或当前激活页面，难以直接针对某一表格中的局部数据（如A1到C8）进行裁剪输出。

通过引入Free Spire.XLS库，开发者可以在服务器端或客户端灵活控制转换逻辑。以下是该组件支持的三种典型应用场景：

• 全量转换：将整个Excel工作簿的所有Sheet合并为一个多页PDF。
• 单表提取：仅将指定索引的工作表保存为独立的PDF文件。
• 区域裁剪：通过设置打印区域（PrintArea），将指定范围内的单元格数据输出为PDF。

准备条件与环境搭建

1. 获取组件：前往Free Spire.XLS官网下载免费版安装包，或使用NuGet Package Manager安装对应的DLL引用。
2. 创建项目：打开Visual Studio，新建一个C# Console Application（控制台应用程序）。
3. 添加引用：确保项目中已引用Free Spire.Xls.dll文件。

在编写核心逻辑前，需在代码头部引入必要的命名空间：

using Spire.Xls;

第1步：将完整Excel文档转换为单页或多页PDF

这是最基础的操作模式。适用于需要将整个报表、账单或列表一次性归档的场景。此操作会自动处理分页，每个工作表对应PDF中的一页（或多页）。

操作流程与参数说明：

• 入口：初始化 Workbook 对象并调用 LoadFromFile 加载源文件。
• 动作：调用 SaveToFile，指定输出文件名及 FileFormat.PDF 枚举值。

C# 代码示例：

Workbook workbook = new Workbook();
// 加载输入Excel文件
workbook.LoadFromFile("示例.xlsx");
// 转换为PDF格式
workbook.SaveToFile("输出_整表.pdf", FileFormat.PDF);

运行结果将生成一个包含原Excel所有工作表内容的PDF文件。

第2步：将指定工作表单独转换为PDF

当仅需保留某一份特定报表（如Sheet2的财务明细）时，可以选择锁定目标工作表进行独立转换，避免产生无关的空白页或冗余数据。

操作步骤：

• 定位工作表：通过 Workbook.Worksheets[index] 获取目标Sheet。注意索引从0开始。
• 执行转换：在工作表对象上直接调用 SaveToPdf 方法。

C# 代码示例：

Workbook workbook = new Workbook();
workbook.LoadFromFile("示例.xlsx");

// 获取第一个工作表 (索引为0)
Worksheet sheet = workbook.Worksheets[0];

// 将该工作表单独保存为PDF
sheet.SaveToPdf("输出_单表.pdf");

第3步：将指定单元格区域转换为PDF

这是最具实用价值的功能。在打印发票、合同片段或特定统计图表时，往往只需输出非连续的局部区域。这需要通过修改工作表的 PageSetup 属性来实现。

关键参数设置：

• PrintArea：设置字符串格式的单元格范围，例如 "A1:C8"。只有位于该区域内的内容才会被渲染到PDF中。

C# 代码示例：

// 1. 载入Excel文档
Workbook workbook = new Workbook();
workbook.LoadFromFile("示例.xlsx");
 
// 2. 获取第一张工作表
Worksheet sheet = workbook.Worksheets[0];
 
// 3. 关键步骤：设置打印区域
// 定义要转换的范围为 A1 到 C8
sheet.PageSetup.PrintArea = "A1:C8";
 
// 4. 将指定范围内单元格保存为PDF
sheet.SaveToPdf("输出_区域.pdf");

常见问题排查

• 中文乱码：确保Excel文件中使用的是系统支持的字体（如宋体、微软雅黑）。若PDF中出现方块，通常是因为导出环境缺少相应字体的支持。
• 样式丢失：免费版可能在某些高级格式（如复杂背景图、特殊边框）渲染上存在限制，建议对源文件保持相对简洁的排版以获得最佳效果。

以上就是C#结合Free Spire.XLS实现Excel向PDF转化的详细内容，涵盖了整表、单表及区域转换的核心代码与原理，更多关于C#办公组件开发的资料请关注本站其它相关文章！