使用 C# 打印 PDF 文檔：基於 Spire.PDF 的實戰教程詳情 - pdf 宇文成都博客

在現代企業應用中，PDF 文檔因其跨平台、格式穩定的特性，成為了信息交換和存儲的重要載體。然而，如何在 C# 應用程序中實現 PDF 文檔的打印功能，卻常常讓開發者感到困惑。原生 .NET 框架提供的打印功能雖然強大，但對於 PDF 這種特殊格式的文檔，其處理過程相對複雜，需要深入理解 GDI+ 繪圖和打印機制。

面對這一痛點，許多開發者會尋求外部庫的幫助。本文將為您詳細介紹如何利用功能強大且易於使用的 Spire.PDF for .NET 庫，在 C# 應用程序中輕鬆實現 PDF 文檔的打印功能。通過本文，您將掌握從基礎打印到自定義設置的全方位技巧，讓您的應用具備專業的 PDF 打印能力。

Spire.PDF for .NET 簡介與安裝

Spire.PDF for .NET 是一款知名的 .NET PDF 組件，它允許開發者在 .NET 應用程序中創建、讀取、編輯、轉換和打印 PDF 文檔。其主要優勢在於：

功能全面：支持 PDF 的各種操作，包括文本、圖片、表格、書籤、附件等。
易於使用：提供直觀的 API 接口，簡化了 PDF 操作的複雜性。
性能優越：能夠高效處理大型 PDF 文檔。
兼容性強：支持 .NET Framework、.NET Core、.NET 5/6/7/8 等多種 .NET 環境。

如何安裝 Spire.PDF for .NET

在您的 C# 項目中集成 Spire.PDF for .NET 非常簡單，最推薦的方式是通過 NuGet 包管理器。

打開 Visual Studio 並加載您的項目。
在“解決方案資源管理器”中，右鍵點擊您的項目，選擇“管理 NuGet 包”。
在“瀏覽”選項卡中，搜索 Spire.PDF。
找到 Spire.PDF 包後，點擊“安裝”。
接受許可協議，完成安裝。

您也可以在 NuGet 包管理器控制枱中使用以下命令進行安裝：

Install-Package Spire.PDF

安裝完成後，Spire.PDF 的相關引用將自動添加到您的項目中。

基本的 PDF 打印實現

接下來，我們通過一個簡單的 C# 代碼示例，演示如何加載一個 PDF 文檔並使用 Spire.PDF for .NET 進行默認打印。

using System;
using System.Windows.Forms; // 如果是控制枱應用，可以省略此using並自行處理打印對話框
using Spire.Pdf; // 導入 Spire.Pdf 命名空間

namespace PdfPrintDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 假設您有一個名為 "sample.pdf" 的PDF文件在項目根目錄或指定路徑
            string pdfFilePath = "sample.pdf"; 

            // 檢查文件是否存在
            if (!System.IO.File.Exists(pdfFilePath))
            {
                Console.WriteLine($"錯誤：文件 '{pdfFilePath}' 不存在。");
                Console.ReadKey();
                return;
            }

            try
            {
                // 創建一個 PdfDocument 實例
                PdfDocument doc = new PdfDocument();

                // 加載 PDF 文檔
                doc.LoadFromFile(pdfFilePath);

                // 創建一個打印對話框，允許用户選擇打印機和設置
                PrintDialog dialogPrint = new PrintDialog();
                dialogPrint.AllowPrintToFile = true; // 允許打印到文件
                dialogPrint.AllowSomePages = true;   // 允許選擇部分頁面

                // 設置默認的打印頁碼範圍為整個文檔
                dialogPrint.PrinterSettings.FromPage = 1;
                dialogPrint.PrinterSettings.ToPage = doc.Pages.Count;

                // 顯示打印對話框
                if (dialogPrint.ShowDialog() == DialogResult.OK)
                {
                    // 根據用户在對話框中的選擇配置打印設置
                    doc.PrintSettings.SelectPageRange(dialogPrint.PrinterSettings.FromPage, dialogPrint.PrinterSettings.ToPage);
                    doc.PrintSettings.PrinterName = dialogPrint.PrinterSettings.PrinterName;

                    Console.WriteLine($"正在打印文件：{pdfFilePath}");
                    Console.WriteLine($"打印機名稱：{dialogPrint.PrinterSettings.PrinterName}");
                    Console.WriteLine($"打印頁碼範圍：{dialogPrint.PrinterSettings.FromPage} - {dialogPrint.PrinterSettings.ToPage}");

                    // 執行打印操作
                    doc.Print();

                    Console.WriteLine("PDF 文檔已發送到打印機。");
                }
                else
                {
                    Console.WriteLine("用户取消了打印操作。");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"打印過程中發生錯誤：{ex.Message}");
            }
            finally
            {
                // 釋放 PdfDocument 資源
                // doc.Dispose(); // Spire.PDF 內部通常會處理資源的釋放，但顯式調用 Dispose 是個好習慣
            }

            Console.ReadKey();
        }
    }
}

代碼説明：

using Spire.Pdf;: 導入 Spire.Pdf 命名空間，以便使用其提供的類和方法。
PdfDocument doc = new PdfDocument();: 創建 PdfDocument 類的實例。
doc.LoadFromFile(pdfFilePath);: 加載指定的 PDF 文件。
PrintDialog dialogPrint = new PrintDialog();: 創建一個標準 Windows 打印對話框，讓用户選擇打印機和設置。這提供了良好的用户體驗。
dialogPrint.ShowDialog() == DialogResult.OK: 判斷用户是否點擊了打印對話框的“確定”按鈕。
doc.PrintSettings.SelectPageRange(...): 根據用户選擇設置打印頁碼範圍。
doc.PrintSettings.PrinterName = ...: 設置要使用的打印機名稱。
doc.Print();: 執行實際的打印操作。

自定義打印設置

Spire.PDF for .NET 提供了豐富的 API，允許您在不顯示打印對話框的情況下，通過編程方式精細控制打印設置。這在自動化打印場景中尤為有用。

常用自定義打印選項

設置選項	對應 Spire.PDF 屬性/方法	描述
打印機名稱	doc.PrintSettings.PrinterName	指定要使用的打印機名稱，例如 "Microsoft Print to PDF"。
打印頁碼範圍	doc.PrintSettings.SelectPageRange(fromPage, toPage)	指定打印的起始頁和結束頁。
打印份數	doc.PrintSettings.Copies	設置打印份數。
打印方向	doc.PrintSettings.Landscape	設置為 true 為橫向打印，false 為縱向打印。
紙張大小	doc.PrintSettings.PaperSize	設置紙張大小，例如 PaperKind.A4。
多頁佈局	doc.PrintSettings.SelectMultiPageLayout(rows, cols, ...)	將多頁內容打印到一張紙上，例如 2x2 佈局。
單頁縮放	doc.PrintSettings.SelectSinglePageLayout(mode, fit, scale)	控制單頁內容如何縮放以適應紙張，例如適應紙張或自定義縮放比例。
打印邊距	doc.PrintSettings.SetPaperMargins(left, top, right, bottom)	設置打印的紙張邊距，單位為百分之一英寸 (hundredths of an inch)。

代碼示例：自定義打印設置

以下代碼演示瞭如何跳過打印對話框，直接將 PDF 文檔的指定頁面以橫向方式打印到特定打印機，並設置打印份數。

using System;
using System.Drawing.Printing; // 用於 PaperKind 枚舉
using Spire.Pdf;

namespace PdfPrintCustomDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            string pdfFilePath = "sample.pdf"; // 確保文件存在
            string targetPrinterName = "Microsoft Print to PDF"; // 替換為您的實際打印機名稱

            if (!System.IO.File.Exists(pdfFilePath))
            {
                Console.WriteLine($"錯誤：文件 '{pdfFilePath}' 不存在。");
                Console.ReadKey();
                return;
            }

            try
            {
                PdfDocument doc = new PdfDocument();
                doc.LoadFromFile(pdfFilePath);

                // --- 自定義打印設置 ---
                doc.PrintSettings.PrinterName = targetPrinterName; // 指定打印機
                doc.PrintSettings.Copies = 2; // 打印兩份
                doc.PrintSettings.Landscape = true; // 設置為橫向打印
                doc.PrintSettings.SelectPageRange(1, 3); // 打印第1頁到第3頁
                doc.PrintSettings.PaperSize = new PaperSize("A4", 827, 1169); // 設置紙張大小為 A4 (單位：百分之一英寸)
                                                                            // 注意：PaperSize 的寬度和高度通常需要根據實際紙張的尺寸和DPI進行調整
                // doc.PrintSettings.SetPaperMargins(50, 50, 50, 50); // 設置邊距，例如所有邊距為0.5英寸

                // 如果不想顯示打印進度對話框，可以設置 PrintController
                doc.PrintSettings.PrintController = new StandardPrintController(); 

                Console.WriteLine($"正在使用自定義設置打印文件：{pdfFilePath}");
                Console.WriteLine($"目標打印機：{doc.PrintSettings.PrinterName}");
                Console.WriteLine($"打印份數：{doc.PrintSettings.Copies}");
                Console.WriteLine($"打印方向：{(doc.PrintSettings.Landscape ? "橫向" : "縱向")}");
                Console.WriteLine($"打印頁碼範圍：{doc.PrintSettings.FromPage} - {doc.PrintSettings.ToPage}");

                doc.Print();

                Console.WriteLine("PDF 文檔已根據自定義設置發送到打印機。");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"打印過程中發生錯誤：{ex.Message}");
                // 打印內部異常信息，可能有助於調試
                if (ex.InnerException != null)
                {
                    Console.WriteLine($"內部異常：{ex.InnerException.Message}");
                }
            }
            finally
            {
                // 確保資源被釋放
                // doc.Dispose(); 
            }

            Console.ReadKey();
        }
    }
}

打印過程中的錯誤處理與注意事項

在實際應用中，打印過程可能會遇到各種問題，例如：

打印機未連接或脱機：導致打印任務無法執行。
PDF 文件不存在或路徑錯誤： LoadFromFile 方法會拋出異常。
權限不足：應用程序可能沒有足夠的權限訪問打印機或文件。
內存不足：處理大型 PDF 文檔時可能發生。
Spire.PDF 許可證問題：如果使用的是免費版或試用版，可能會有功能限制或水印。

為了提高應用程序的健壯性，強烈建議使用 try-catch 塊來捕獲和處理潛在的異常。

try
{
    // 您的打印代碼
}
catch (System.Printing.PrintException pEx)
{
    Console.WriteLine($"打印機錯誤：{pEx.Message}");
    // 提示用户檢查打印機連接或狀態
}
catch (System.IO.FileNotFoundException fnfEx)
{
    Console.WriteLine($"文件未找到錯誤：{fnfEx.Message}");
    // 提示用户檢查文件路徑
}
catch (Exception ex)
{
    Console.WriteLine($"通用打印錯誤：{ex.Message}");
    // 記錄詳細異常信息以便調試
}
finally
{
    // 確保在任何情況下都能釋放資源
    if (doc != null)
    {
        doc.Close(); // Spire.PDF 的 Close 方法可以釋放資源
    }
}

注意事項：

資源釋放：儘管 Spire.PDF 內部通常會處理資源的釋放，但在 finally 塊中顯式調用 doc.Close() 或 doc.Dispose() 是一個好的編程習慣，可以避免內存泄漏。
打印機名稱：確保您在代碼中指定的打印機名稱與用户系統上的實際打印機名稱完全匹配。您可以通過 System.Drawing.Printing.PrinterSettings.InstalledPrinters 集合獲取所有已安裝的打印機名稱。
用户體驗：對於桌面應用程序，通常會顯示一個打印對話框，讓用户確認打印設置，而不是完全靜默打印。
異步打印：對於需要長時間打印的任務，考慮使用異步方法，避免阻塞 UI 線程。

結論

通過本文的詳細介紹，您應該已經掌握瞭如何使用 Spire.PDF for .NET 庫在 C# 應用程序中實現 PDF 文檔的打印功能。無論是簡單的默認打印，還是複雜的自定義打印設置，Spire.PDF for .NET 都提供了簡潔而強大的 API 來滿足您的需求。

它不僅簡化了原生 .NET 打印 PDF 的複雜性，還提供了豐富的控制選項，讓您的應用程序能夠更靈活地處理 PDF 打印任務。現在，是時候將這些知識應用到您的項目中，提升您應用程序的文檔處理能力了！立即嘗試在您的項目中集成 Spire.PDF for .NET，體驗它帶來的便捷與高效吧！

宇文成都博客

宇文成都博客

博客 / 詳情