快捷導(dǎo)航

C#使用Spire.XLS將Excel工作簿轉(zhuǎn)換為PDF的實(shí)現(xiàn)步驟

更新時(shí)間：2025年09月02日 08:27:04 作者：缺點(diǎn)內(nèi)向

在日常工作和開發(fā)中,將Excel報(bào)表轉(zhuǎn)換為PDF是常見需求（如生成可打印的對賬單）,使用Spire.XLS?for?.NET,無需依賴Excel環(huán)境,所以本文給大家介紹了C#使用Spire.XLS將Excel工作簿轉(zhuǎn)換為PDF的實(shí)現(xiàn)步驟,需要的朋友可以參考下

引言

在日常工作和開發(fā)中，將Excel報(bào)表轉(zhuǎn)換為PDF是常見需求（如生成可打印的對賬單）。使用Spire.XLS for .NET，無需依賴Excel環(huán)境，幾行C#代碼即可保持原樣式批量轉(zhuǎn)換，輕松實(shí)現(xiàn)自動(dòng)化文檔輸出。

Part 1: Spire.XLS 簡介與環(huán)境配置

什么是 Spire.XLS？

Spire.XLS 是由 E-iceblue 公司開發(fā)的一款專業(yè)的 .NET Excel 組件，它允許開發(fā)者在 .NET 應(yīng)用程序中創(chuàng)建、讀取、編輯、轉(zhuǎn)換和打印 Excel 文件，而無需安裝 Microsoft Office。它支持所有主流的 Excel 文件格式（.xls, .xlsx, .xlsm, .xltm 等），并且提供了豐富的功能，包括單元格操作、圖表處理、數(shù)據(jù)透視表、公式計(jì)算等。其高性能和強(qiáng)大的兼容性使得它在處理復(fù)雜 Excel 文件和大規(guī)模數(shù)據(jù)時(shí)表現(xiàn)出色。

環(huán)境準(zhǔn)備

在開始編寫代碼之前，我們需要做好以下準(zhǔn)備：

創(chuàng)建一個(gè)新的 C# .NET 項(xiàng)目：

打開 Visual Studio，選擇“創(chuàng)建新項(xiàng)目”。
選擇“控制臺(tái)應(yīng)用”（或其他你需要的項(xiàng)目類型，如 ASP.NET Core Web 應(yīng)用）。
為項(xiàng)目命名并選擇合適的 .NET 版本。

獲取和安裝 Spire.XLS：

Spire.XLS 可以通過 NuGet 包管理器輕松安裝。

安裝完成后，Spire.XLS 的引用將自動(dòng)添加到你的項(xiàng)目中。

通過 Visual Studio 界面安裝：

在“解決方案資源管理器”中，右鍵點(diǎn)擊你的項(xiàng)目 -> “管理 NuGet 包”。
在“瀏覽”選項(xiàng)卡中搜索 Spire.XLS。
選擇 Spire.XLS 并點(diǎn)擊“安裝”。

通過 NuGet 包管理器控制臺(tái)安裝：

在 Visual Studio 中，打開“工具” -> “NuGet 包管理器” -> “包管理器控制臺(tái)”。
運(yùn)行以下命令：

 Install-Package Spire.XLS

Part 2: Excel 到 PDF 的基本轉(zhuǎn)換步驟與代碼實(shí)現(xiàn)

使用 Spire.XLS 將 Excel 轉(zhuǎn)換為 PDF 的核心步驟非常簡單明了：

加載 Excel 工作簿。
調(diào)用 SaveToFile() 方法并指定輸出格式為 PDF。

下面是一個(gè)完整的 C# 代碼示例，演示了最基本的 Excel 到 PDF 轉(zhuǎn)換過程：

using System;
using Spire.Xls; // 引入 Spire.Xls 命名空間

namespace ExcelToPdfConverter
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 創(chuàng)建一個(gè) Workbook 實(shí)例
            Workbook workbook = new Workbook();

            // 2. 加載源 Excel 文件
            // 請確保 'Sample.xlsx' 文件存在于你的項(xiàng)目運(yùn)行目錄下，或者提供完整的文件路徑。
            // 這里我們以 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 文件已成功轉(zhuǎn)換為 PDF！輸出文件：result.pdf");
            Console.ReadKey(); // 暫?？刂婆_(tái)，方便查看輸出
        }
    }
}

代碼說明：

Workbook workbook = new Workbook();：創(chuàng)建了一個(gè) Workbook 對象，它是 Spire.XLS 中操作 Excel 文件的核心。
workbook.LoadFromFile("Sample.xlsx", ExcelVersion.Version2010);：加載名為 Sample.xlsx 的 Excel 文件。ExcelVersion.Version2010 用于指定文件版本，通常 Spire.XLS 會(huì)自動(dòng)識(shí)別，但明確指定可以提高兼容性。
workbook.SaveToFile("result.pdf", Spire.Xls.FileFormat.PDF);：這是轉(zhuǎn)換的核心方法。它將加載的 Excel 工作簿保存為 result.pdf 文件，并通過 Spire.Xls.FileFormat.PDF 參數(shù)明確指定了輸出格式為 PDF。

運(yùn)行這段代碼，你將在項(xiàng)目輸出目錄下看到一個(gè)名為 result.pdf 的文件，它就是由 Sample.xlsx 轉(zhuǎn)換而來的 PDF 版本。

Part 3: 高級轉(zhuǎn)換選項(xiàng)與常見問題處理

Spire.XLS 不僅能實(shí)現(xiàn)簡單的轉(zhuǎn)換，還提供了豐富的選項(xiàng)來精細(xì)控制 PDF 的生成，滿足更復(fù)雜的轉(zhuǎn)換需求。

頁面設(shè)置與格式控制

在將 Excel 轉(zhuǎn)換為 PDF 時(shí)，常常需要對頁面布局、打印范圍進(jìn)行調(diào)整。Spire.XLS 提供了 Worksheet.PageSetup 屬性來控制這些選項(xiàng)。

using System;
using Spire.Xls;

namespace ExcelToPdfAdvanced
{
    class Program
    {
        static void Main(string[] args)
        {
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("Sample.xlsx"); // 默認(rèn)加載最新版本

            // 獲取第一個(gè)工作表
            Worksheet sheet = workbook.Worksheets[0];

            // --- 頁面設(shè)置 ---
            // 設(shè)置頁面方向?yàn)闄M向
            sheet.PageSetup.Orientation = PageOrientationType.Landscape;
            // 設(shè)置紙張大小為 A4
            sheet.PageSetup.PaperSize = PaperSizeType.PaperA4;
            // 設(shè)置頁邊距（英寸）
            sheet.PageSetup.LeftMargin = 0.5;
            sheet.PageSetup.RightMargin = 0.5;
            sheet.PageSetup.TopMargin = 0.75;
            sheet.PageSetup.BottomMargin = 0.75;

            // --- 打印范圍控制 ---
            // 僅打印指定區(qū)域 (例如 A1 到 H20)
            sheet.PageSetup.PrintArea = "A1:H20";
            // 或者，如果你只想轉(zhuǎn)換特定工作表為 PDF
            string outputPdfPath = "WorksheetOutput.pdf";
            sheet.SaveToPdf(outputPdfPath); // 將單個(gè)工作表保存為PDF

            // --- 頁眉頁腳設(shè)置 ---
            // 設(shè)置左側(cè)頁眉
            sheet.PageSetup.LeftHeader = "&"Arial"&8&B&I&K0000FF左側(cè)頁眉";
            // 設(shè)置右側(cè)頁腳，包含頁碼和總頁數(shù)
            sheet.PageSetup.RightFooter = "頁碼 &P / &N";

            // 保存整個(gè)工作簿為 PDF，應(yīng)用上述設(shè)置
            workbook.SaveToFile("AdvancedResult.pdf", Spire.Xls.FileFormat.PDF);

            Console.WriteLine("Excel 文件已應(yīng)用高級設(shè)置并轉(zhuǎn)換為 PDF！輸出文件：AdvancedResult.pdf");
            Console.WriteLine("單個(gè)工作表已轉(zhuǎn)換為 PDF！輸出文件：" + outputPdfPath);
            Console.ReadKey();
        }
    }
}

關(guān)鍵 API 解釋：

sheet.PageSetup.Orientation = PageOrientationType.Landscape;：設(shè)置頁面為橫向。
sheet.PageSetup.PaperSize = PaperSizeType.PaperA4;：設(shè)置紙張大小為 A4。
sheet.PageSetup.LeftMargin = 0.5;：設(shè)置左頁邊距為 0.5 英寸。
sheet.PageSetup.PrintArea = "A1:H20";：指定只打印 A1 到 H20 區(qū)域的內(nèi)容。
sheet.SaveToPdf(outputPdfPath);：將當(dāng)前工作表單獨(dú)保存為 PDF。
sheet.PageSetup.LeftHeader / RightFooter：用于設(shè)置頁眉頁腳，支持豐富的格式代碼（如 &P 代表當(dāng)前頁碼，&N 代表總頁數(shù)）。

安全性設(shè)置（密碼保護(hù)）

Spire.XLS 也支持為生成的 PDF 文件添加密碼保護(hù)，以增強(qiáng)文檔的安全性。

// ... (之前的加載 Excel 代碼)

PdfSaveOptions options = new PdfSaveOptions();
options.Password = "mySecurePassword"; // 設(shè)置 PDF 打開密碼
workbook.SaveToFile("EncryptedResult.pdf", options);

Console.WriteLine("已生成帶密碼保護(hù)的 PDF 文件：EncryptedResult.pdf");