C# 程式化打印 PDF（代碼示例教程）

透過NuGet套件管理器進行安裝流程

安裝IronPrint非常簡單。 將其新增至.NET專案中最簡單的方法是透過NuGet套件管理器：

• 在 Visual Studio 中開啟您的專案。
• 導航至NuGet套件管理器。
• 搜尋"IronPrint" 。 點選"安裝" ，剩下的就交給 Visual Studio 處理。

如果您喜歡使用軟體包管理器控制台，請使用以下命令：

Install-Package IronPrint

安裝完成後，請確保所有相依性都已正確復原。

.NET專案的基本設定與配置

安裝完成後， IronPrint只需進行少量配置即可開始工作。 首先，請確保您的應用程式可以存取所需的印表機驅動程式。 然後，透過引用函式庫並設定基本參數來初始化IronPrint 。 一個簡單的實作方式可能如下所示：

// Import the IronPrint namespace to access its functionalities.
using IronPrint;

// Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf");

// Import the IronPrint namespace to access its functionalities.
using IronPrint;

// Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf");

此基本設定使應用程式能夠立即將 PDF 檔案傳送到預設印表機。 開發人員可以根據需要，透過指定不同的印表機、調整列印設定或整合其他配置來客製化行為。 安裝和設定完成後，下一步是探索 IronPrint 的核心功能，以有效地管理不同的列印場景。

以程式設計方式列印 PDF

IronPrint讓列印 PDF 和影像變得簡單。 Print 方法能夠有效率地處理 PDF 文件，直接將其傳送到印表機，無需不必要的步驟。 當您需要快速且有效率地列印 PDF 文件時，這尤其有用。 一個簡單的實作方式如下：

using IronPrint;

// Print a PDF document using the default settings.
Printer.Print("invoice.pdf");

using IronPrint;

// Print a PDF document using the default settings.
Printer.Print("invoice.pdf");

列印影像

IronPrint支援 PNG、JPEG 和 BMP 等常見影像檔案格式。它採用的自動偵測和處理方法能夠確保影像在列印時保持清晰度和解析度。

using IronPrint;

// Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png");

using IronPrint;

// Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png");

依序處理單一文件中的多張影像。 IronPrint可確保格式維持不變，防止失真或品質損失。 這使其成為列印複雜報告或圖形文件以及 PDF 文件的理想選擇。

靜默列印與列印對話框

IronPrint讓開發者能夠控製文件的列印方式。 靜默列印功能無需使用者輸入即可將 PDF 文件直接傳送到印表機。 這對於可自動批量列印的應用非常有用，可以減少中斷並加快工作流程。 您也可以有效率地列印多個PDF文件。

using IronPrint;

// Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf");

using IronPrint;

// Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf");

或者，如果使用者需要在列印前調整設置， IronPrint可以觸發列印對話框。 這樣，使用者可以在最終完成列印作業之前選擇印表機、設定頁面方向並調整列印品質。

using IronPrint;

// Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf");

using IronPrint;

// Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf");

靜默列印最適合不需要使用者介入的自動化工作流程，而列印對話方塊則是需要自訂時的理想選擇。 兩種方法都能根據應用需求確保靈活性和效率。 透過利用這些功能，開發人員可以在其.NET應用程式中整合自動化和使用者友好的列印功能，從而確保順利處理列印 PDF 文件。

紙面配置

借助IronPrint，開發人員可以自訂紙張尺寸和方向，以滿足其應用程式的需求。 這對於在非標準紙張格式上列印或需要特定佈局的情況尤其有用。 目前的列印文件物件允許開發人員有效率地管理這些配置。 要設定紙張尺寸和方向，只需初始化 PrintSettings 類別並指定所需的屬性：

using IronPrint;

// Configure paper settings such as size and orientation.
PrintSettings printSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape
};

// Print the document using the specified settings.
Printer.Print("document.pdf", printSettings);

using IronPrint;

// Configure paper settings such as size and orientation.
PrintSettings printSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape
};

// Print the document using the specified settings.
Printer.Print("document.pdf", printSettings);

列印品質和影印份數

為了更好地控制列印質量，開發人員可以調整 DPI(每英寸點數)設置，以確保文件以適當的細節水平列印出來。 更高的DPI設定可以提高清晰度，但可能會增加列印時間。此外，您也可以指定列印份數：

using IronPrint;

// Configure print settings for quality and number of copies.
PrintSettings printSettings = new PrintSettings
{
    Dpi = 300,
    NumberOfCopies = 2
};

// Print the document with the specified settings.
Printer.Print("report.pdf", printSettings);

using IronPrint;

// Configure print settings for quality and number of copies.
PrintSettings printSettings = new PrintSettings
{
    Dpi = 300,
    NumberOfCopies = 2
};

// Print the document with the specified settings.
Printer.Print("report.pdf", printSettings);

印表機選擇

開發人員可以指定要使用的印表機，而不是依賴系統的預設印表機。 這在配備多台印表機的辦公環境中尤其有用：

using IronPrint;

// Specify the printer to use for printing the document.
PrintSettings printSettings = new PrintSettings
{
    PrinterName = "Your Printer Name"
};

// Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings);

using IronPrint;

// Specify the printer to use for printing the document.
PrintSettings printSettings = new PrintSettings
{
    PrinterName = "Your Printer Name"
};

// Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings);

頁邊距和灰階列印

自訂邊距有助於確保文件正確對齊，而灰階列印可以在不需要顏色時節省墨水。 為了精確調整，裕量以毫米為單位定義：

using IronPrint;

// Configure print settings for margins and grayscale printing.
PrintSettings printSettings = new PrintSettings
{
    PaperMargins = new Margins
    {
        Top = 10,
        Right = 10,
        Bottom = 10,
        Left = 10
    },
    Grayscale = true
};

// Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings);

using IronPrint;

// Configure print settings for margins and grayscale printing.
PrintSettings printSettings = new PrintSettings
{
    PaperMargins = new Margins
    {
        Top = 10,
        Right = 10,
        Bottom = 10,
        Left = 10
    },
    Grayscale = true
};

// Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings);

利用這些高級列印設置，開發人員可以微調列印過程，以滿足對一致且專業品質輸出的特定要求。