如何使用 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 文件和大规模数据时表现出色。

环境准备

在开始编写代码之前，我们需要做好以下准备：

1. 创建一个新的 C# .NET 项目：

• 打开 Visual Studio，选择“创建新项目”。
• 选择“控制台应用”（或其他你需要的项目类型，如 ASP.NET Core Web 应用）。
• 为项目命名并选择合适的 .NET 版本。

2. 获取和安装 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 的核心步骤非常简单明了：

1. 加载 Excel 工作簿。
2. 调用 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 文件中包含的复杂图。