C# 实现高保真 Excel 转 PDF（无需 Office 环境）

在日常办公自动化或系统报表开发中，常常需要将 Excel 文件转换为 PDF 格式，用于归档、打印或共享。然而，许多开发者遇到的一个共同问题是：如何在没有安装 Microsoft Office 的环境下实现高保真 Excel 转 PDF 转换？

本文将介绍如何使用 Spire.XLS for .NET 实现这一功能。该库提供独立的 Excel 处理能力，能够精准还原单元格样式、表格布局、图表和图片内容，无需依赖 Office，即可完成高质量的 Excel 到 PDF 转换。

一、准备工作

在开始之前，先在项目中安装 Spire.XLS 库。可通过 NuGet 直接安装：

cs 复制代码

Install-Package Spire.XLS

安装完成后，在代码文件中引用命名空间：

cs 复制代码

using Spire.Xls;

Spire.XLS 提供了 Workbook 类用于加载、编辑和导出 Excel 文件，支持 .xls、.xlsx、.csv 等多种格式。

二、基本的 Excel 转 PDF 操作

以下示例展示了最基础的 Excel 转 PDF 过程，仅需几行代码即可完成整个文件的转换：

cs 复制代码

using Spire.Xls;

namespace ExcelToPDFDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象并加载 Excel 文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("示例.xlsx");

            // 将整个 Excel 文件导出为 PDF
            workbook.SaveToFile("输出.pdf", FileFormat.PDF);
        }
    }
}

说明

Workbook.LoadFromFile()：加载 Excel 文件。
SaveToFile("输出.pdf", FileFormat.PDF)：以 PDF 格式保存。
此方法会自动将所有工作表按顺序合并输出为一个 PDF 文件。

这种方式最适合快速、完整地将 Excel 文档导出为 PDF 文件。

三、调整页面设置以获得更佳输出效果

在生成 PDF 时，常常需要控制页面方向、缩放比例或边距，以确保内容分页合理、排版整齐。可以通过 PageSetup 对象进行灵活调整。

cs 复制代码

Workbook workbook = new Workbook();
workbook.LoadFromFile("示例.xlsx");

Worksheet sheet = workbook.Worksheets[0];

// 设置页面方向为横向
sheet.PageSetup.Orientation = PageOrientationType.Landscape;

// 调整内容缩放，使宽度适应单页显示
sheet.PageSetup.FitToPagesWide = 1;
sheet.PageSetup.FitToPagesTall = 0;

// 设置页边距（单位：英寸）
sheet.PageSetup.LeftMargin = 0.3;
sheet.PageSetup.RightMargin = 0.3;

workbook.SaveToFile("横向输出.pdf", FileFormat.PDF);

提示： 若 Excel 表格内容较宽，建议使用横向模式并设置"每页一宽度"，可以避免内容被分页截断。

四、导出特定工作表或单元格区域

在实际场景中，有时只需导出一张工作表，或者仅输出特定的单元格区域（如报表摘要或部分数据）。Spire.XLS 允许灵活控制导出范围，以下示例展示了具体用法：

cs 复制代码

using Spire.Xls;

namespace WorksheetOrCellRangeToPdf
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 创建 Workbook 对象
            Workbook workbook = new Workbook();
            // 加载 Excel 文件
            workbook.LoadFromFile("C:\\Users\\Administrator\\Desktop\\示例.xlsx");

            // 获取第一张工作表
            Worksheet sheet = workbook.Worksheets[0];

            // 设置打印区域（可导出指定单元格范围）
            // 如果要导出整张表，可注释掉此行
            sheet.PageSetup.PrintArea = "B1:E6";

            // 将指定区域导出为 PDF
            sheet.SaveToPdf("指定区域.pdf");

            // 释放资源
            workbook.Dispose();
        }
    }
}

要点说明

PrintArea 用于指定导出范围（如 "B1:E6"）。
SaveToPdf() 方法直接导出该工作表或指定区域。
若不设置 PrintArea，则默认导出整张工作表。

这种方式非常适合需要导出局部数据或生成固定报表模板的场景。

五、小结

本文介绍了几种常见的 Excel 转 PDF 操作方式，从最基本的转换，到调整页面设置，再到导出特定工作表或单元格区域。

这些方法都可以在纯 C# 环境中实现，无需 Office 环境，执行速度快，输出结果稳定。如果你需要在后台服务、Web API 或桌面应用中批量生成高质量 PDF 报表，这种方式会非常实用。