C#实现高保真的Excel转PDF详解(无需 Office 环境)_Asp.net

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

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

一、准备工作

在开始之前，先在项目中安装 spire.xls 库。可通过 nuget 直接安装：

install-package spire.xls

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

using spire.xls;

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

二、基本的 excel 转 pdf 操作

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

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 对象进行灵活调整。

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 允许灵活控制导出范围，以下示例展示了具体用法：

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\example.xlsx");

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

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

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

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

要点说明