C#使用Spire.XLS将Excel工作簿转换为PDF的实现步骤

 更新时间:2025年09月02日 08:27:04   作者:缺点内向  
在日常工作和开发中,将Excel报表转换为PDF是常见需求(如生成可打印的对账单),使用Spire.XLS for .NET,无需依赖Excel环境,所以本文给大家介绍了C#使用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 包管理器轻松安装。

安装完成后,Spire.XLS 的引用将自动添加到你的项目中。

通过 Visual Studio 界面安装:

  • 在“解决方案资源管理器”中,右键点击你的项目 -> “管理 NuGet 包”。
  • 在“浏览”选项卡中搜索 Spire.XLS
  • 选择 Spire.XLS 并点击“安装”。

通过 NuGet 包管理器控制台安装:

  • 在 Visual Studio 中,打开“工具” -> “NuGet 包管理器” -> “包管理器控制台”。
  • 运行以下命令:
 Install-Package 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 文件中包含的复杂图。

以上就是C#使用Spire.XLS将Excel工作簿转换为PDF的实现步骤的详细内容,更多关于C# Spire.XLS将Excel转为PDF的资料请关注脚本之家其它相关文章!

相关文章

  • Unity shader实现消融效果

    Unity shader实现消融效果

    这篇文章主要为大家详细介绍了Unity shader实现消融效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-02-02
  • C#过滤sql特殊字符串的方法

    C#过滤sql特殊字符串的方法

    这篇文章介绍了C#过滤sql特殊字符串的方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • unity使用socket编程实现聊天室功能

    unity使用socket编程实现聊天室功能

    这篇文章主要为大家详细介绍了unity使用socket编程实现聊天室功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-11-11
  • C#实现创建、修改和删除Excel中的VBA宏

    C#实现创建、修改和删除Excel中的VBA宏

    在处理 Excel 电子表格时,VBA(Visual Basic for Applications)宏成为自动化任务的强大工具,本文将详细介绍如何在 C# 中操作 Excel 工作簿中的 VBA 宏,感兴趣的小伙伴可以了解下
    2026-04-04
  • C#中this的用法集锦

    C#中this的用法集锦

    本文给大家汇总介绍了C#中的几种this用法,相信大家应该有用过,但你用过几种?以下是个人总结的this几种用法,欢迎大家拍砖,废话少说,直接列出用法及相关代码。
    2015-06-06
  • C#获取文件夹所占空间大小的功能

    C#获取文件夹所占空间大小的功能

    这篇文章介绍了C#获取文件夹所占空间大小的方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-06-06
  • 深入浅析C#泛型类型

    深入浅析C#泛型类型

    这篇文章主要介绍C#泛型类型,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2017-02-02
  • C#模板方法模式(Template Method Pattern)实例教程

    C#模板方法模式(Template Method Pattern)实例教程

    这篇文章主要介绍了C#模板方法模式(Template Method Pattern),以实例形式讲述了C#抽象类模板方法的用法,具有很高的实用价值,需要的朋友可以参考下
    2014-09-09
  • C#使用NAudio录音并导出录音数据

    C#使用NAudio录音并导出录音数据

    这篇文章主要为大家详细介绍了C#如何使用NAudio实现录音功能并导出录音数据,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-12-12
  • c++ STL之list对结构体的增加,删除,排序等操作详解

    c++ STL之list对结构体的增加,删除,排序等操作详解

    这篇文章主要介绍了c++ STL之list对结构体的增加,删除,排序等操作详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12

最新评论