如何使用 Spire.XLS 将 Excel 工作簿转换为 PDF?
在日常工作和开发中,将Excel报表转换为PDF是常见需求(如生成可打印的对账单)。使用Spire.XLS for .NET,无需依赖Excel环境,几行C#代码即可保持原样式批量转换,轻松实现自动化文档输出。
Part 1: Spire.XLS 简介与环境配置
什么是 Spire.XLS?
Spire.XLS 是由 E-iceblue 公司开发的一款专业的 .NET Excel 组件,它允许开发者在 .NET 应用程序中创建、读取、编辑、转换和打印 Excel 文件,而无需安装 Microsoft Office。它支持所有主流的 Excel 文件格式(.xls, .xlsx, .xlsm, .xltm 等),并且提供了丰富的功能,包括单元格操作、图表处理、数据透视表、公式计算等。其高性能和强大的兼容性使得它在处理复杂 Excel 文件和大规模数据时表现出色。
环境准备
在开始编写代码之前,我们需要做好以下准备:
- 创建一个新的 C# .NET 项目:
- 打开 Visual Studio,选择“创建新项目”。
- 选择“控制台应用”(或其他你需要的项目类型,如 ASP.NET Core Web 应用)。
- 为项目命名并选择合适的 .NET 版本。
- 获取和安装 Spire.XLS:
Spire.XLS 可以通过 NuGet 包管理器轻松安装。
- 通过 Visual Studio 界面安装:
- 在“解决方案资源管理器”中,右键点击你的项目 -> “管理 NuGet 包”。
- 在“浏览”选项卡中搜索
Spire.XLS
。 - 选择
Spire.XLS
并点击“安装”。
- 通过 NuGet 包管理器控制台安装:
- 在 Visual Studio 中,打开“工具” -> “NuGet 包管理器” -> “包管理器控制台”。
- 运行以下命令:
Install-Package Spire.XLS
安装完成后,Spire.XLS 的引用将自动添加到你的项目中。
Part 2: Excel 到 PDF 的基本转换步骤与代码实现
使用 Spire.XLS 将 Excel 转换为 PDF 的核心步骤非常简单明了:
- 加载 Excel 工作簿。
- 调用
SaveToFile()
方法并指定输出格式为 PDF。
下面是一个完整的 C# 代码示例,演示了最基本的 Excel 到 PDF 转换过程:
using System;
using Spire.Xls; // 引入 Spire.Xls 命名空间
namespace ExcelToPdfConverter
{
class Program
{
static void Main(string[] args)
{
// 1. 创建一个 Workbook 实例
Workbook workbook = new Workbook();
// 2. 加载源 Excel 文件
// 请确保 'Sample.xlsx' 文件存在于你的项目运行目录下,或者提供完整的文件路径。
// 这里我们以 Excel 2010 格式为例。Spire.XLS 支持多种 Excel 版本。
workbook.LoadFromFile("Sample.xlsx", ExcelVersion.Version2010);
// 3. 将工作簿保存为 PDF 文件
// 'result.pdf' 将是输出的 PDF 文件名。
// Spire.Xls.FileFormat.PDF 指定了输出格式为 PDF。
workbook.SaveToFile("result.pdf", Spire.Xls.FileFormat.PDF);
Console.WriteLine("Excel 文件已成功转换为 PDF!输出文件:result.pdf");
Console.ReadKey(); // 暂停控制台,方便查看输出
}
}
}
代码说明:
Workbook workbook = new Workbook();
:创建了一个Workbook
对象,它是 Spire.XLS 中操作 Excel 文件的核心。workbook.LoadFromFile("Sample.xlsx", ExcelVersion.Version2010);
:加载名为Sample.xlsx
的 Excel 文件。ExcelVersion.Version2010
用于指定文件版本,通常 Spire.XLS 会自动识别,但明确指定可以提高兼容性。workbook.SaveToFile("result.pdf", Spire.Xls.FileFormat.PDF);
:这是转换的核心方法。它将加载的 Excel 工作簿保存为result.pdf
文件,并通过Spire.Xls.FileFormat.PDF
参数明确指定了输出格式为 PDF。
运行这段代码,你将在项目输出目录下看到一个名为 result.pdf
的文件,它就是由 Sample.xlsx
转换而来的 PDF 版本。
Part 3: 高级转换选项与常见问题处理
Spire.XLS 不仅能实现简单的转换,还提供了丰富的选项来精细控制 PDF 的生成,满足更复杂的转换需求。
页面设置与格式控制
在将 Excel 转换为 PDF 时,常常需要对页面布局、打印范围进行调整。Spire.XLS 提供了 Worksheet.PageSetup
属性来控制这些选项。
using System;
using Spire.Xls;
namespace ExcelToPdfAdvanced
{
class Program
{
static void Main(string[] args)
{
Workbook workbook = new Workbook();
workbook.LoadFromFile("Sample.xlsx"); // 默认加载最新版本
// 获取第一个工作表
Worksheet sheet = workbook.Worksheets[0];
// --- 页面设置 ---
// 设置页面方向为横向
sheet.PageSetup.Orientation = PageOrientationType.Landscape;
// 设置纸张大小为 A4
sheet.PageSetup.PaperSize = PaperSizeType.PaperA4;
// 设置页边距(英寸)
sheet.PageSetup.LeftMargin = 0.5;
sheet.PageSetup.RightMargin = 0.5;
sheet.PageSetup.TopMargin = 0.75;
sheet.PageSetup.BottomMargin = 0.75;
// --- 打印范围控制 ---
// 仅打印指定区域 (例如 A1 到 H20)
sheet.PageSetup.PrintArea = "A1:H20";
// 或者,如果你只想转换特定工作表为 PDF
string outputPdfPath = "WorksheetOutput.pdf";
sheet.SaveToPdf(outputPdfPath); // 将单个工作表保存为PDF
// --- 页眉页脚设置 ---
// 设置左侧页眉
sheet.PageSetup.LeftHeader = "&\"Arial\"&8&B&I&K0000FF左侧页眉";
// 设置右侧页脚,包含页码和总页数
sheet.PageSetup.RightFooter = "页码 &P / &N";
// 保存整个工作簿为 PDF,应用上述设置
workbook.SaveToFile("AdvancedResult.pdf", Spire.Xls.FileFormat.PDF);
Console.WriteLine("Excel 文件已应用高级设置并转换为 PDF!输出文件:AdvancedResult.pdf");
Console.WriteLine("单个工作表已转换为 PDF!输出文件:" + outputPdfPath);
Console.ReadKey();
}
}
}
关键 API 解释:
sheet.PageSetup.Orientation = PageOrientationType.Landscape;
:设置页面为横向。sheet.PageSetup.PaperSize = PaperSizeType.PaperA4;
:设置纸张大小为 A4。sheet.PageSetup.LeftMargin = 0.5;
:设置左页边距为 0.5 英寸。sheet.PageSetup.PrintArea = "A1:H20";
:指定只打印A1
到H20
区域的内容。sheet.SaveToPdf(outputPdfPath);
:将当前工作表单独保存为 PDF。sheet.PageSetup.LeftHeader
/RightFooter
:用于设置页眉页脚,支持丰富的格式代码(如&P
代表当前页码,&N
代表总页数)。
安全性设置(密码保护)
Spire.XLS 也支持为生成的 PDF 文件添加密码保护,以增强文档的安全性。
// ... (之前的加载 Excel 代码)
PdfSaveOptions options = new PdfSaveOptions();
options.Password = "mySecurePassword"; // 设置 PDF 打开密码
workbook.SaveToFile("EncryptedResult.pdf", options);
Console.WriteLine("已生成带密码保护的 PDF 文件:EncryptedResult.pdf");
常见问题与解决方案
- 问题1:转换后 PDF 样式与 Excel 不一致?
- 原因分析: 这可能是由于系统缺少 Excel 中使用的特定字体,或者 Excel 文件中包含的复杂图。