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的资料请关注脚本之家其它相关文章!

相关文章

  • C#自定义繁体和简体字库实现中文繁体和简体之间转换的方法

    C#自定义繁体和简体字库实现中文繁体和简体之间转换的方法

    这篇文章主要介绍了C#自定义繁体和简体字库实现中文繁体和简体之间转换的方法,通过自定义繁简转换字库实现繁体与简体转换的技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04
  • C#中计数排序算法的原理及实现

    C#中计数排序算法的原理及实现

    计数排序是一种线性时间复杂度的排序方法,主要通过统计元素出现的次数实现排序,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-10-10
  • c#同步两个子目录文件示例分享 两个文件夹同步

    c#同步两个子目录文件示例分享 两个文件夹同步

    这篇文章主要介绍了使用c#同步两个子目录文件的方法,大家参考使用吧
    2014-01-01
  • C#构建树形结构数据(全部构建,查找构建)

    C#构建树形结构数据(全部构建,查找构建)

    这篇文章主要介绍了C#构建树形结构数据(全部构建,查找构建),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • WPF实现控件拖动的示例代码

    WPF实现控件拖动的示例代码

    这篇文章主要介绍了WPF实现控件拖动的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-08-08
  • C#微信开发之接收 / 返回文本消息

    C#微信开发之接收 / 返回文本消息

    本文主要介绍了C#微信开发之接收 / 返回文本消息原理与实现方法,具有一定的参考价值,下面跟着小编一起来看下吧
    2017-02-02
  • 图解如何使用C#创建Windows服务

    图解如何使用C#创建Windows服务

    本文主要介绍了图解如何使用C#创建Windows服务,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • C#回收机制之资源回收托管

    C#回收机制之资源回收托管

    这篇文章介绍了C#回收机制之资源回收托管,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-05-05
  • C#遍历集合与移除元素的方法

    C#遍历集合与移除元素的方法

    这篇文章主要介绍了C#遍历集合与移除元素的方法,结合实例形式分析了C#使用for循环遍历集合以及add与Remove方法进行元素添加与移除的使用技巧,需要的朋友可以参考下
    2016-06-06
  • c#获取字符串宽度的示例代码(字节数方法)

    c#获取字符串宽度的示例代码(字节数方法)

    本篇文章主要介绍了c#获取字符串宽度的示例代码(字节数方法)。需要的朋友可以过来参考下,希望对大家有所帮助
    2014-01-01

最新评论