0
点赞
收藏
分享

微信扫一扫

如何使用 Spire.XLS 将 Excel 工作簿转换为 PDF?

如何使用 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 版本。
  1. 获取和安装 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";:指定只打印 A1H20 区域的内容。
  • 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 文件中包含的复杂图。

举报

相关推荐

0 条评论