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 等常見影像檔案格式。 Print方式會自動偵測處理影像，確保列印後影像依然清晰銳利。

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);

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