.NET PDF 列印機（開發者教程）

IronPrint有哪些使其脫穎而出的核心功能？

1.多功能性：支援 PDF、HTML 和影像文件，可靈活處理不同類型的文件。列印文件教學示範了在多個平台上的使用方法。

2.易於整合：直覺的 API 和全面的文件減少了開發時間和精力。 該庫的功能概述重點介紹了無縫集成功能。

3.進階列印選項：控制頁面佈局、方向、紙張尺寸和質量，以滿足特定要求。 使用簡單的程式碼應用自訂列印設置，包括邊距、DPI 和紙張規格。

4.無縫相容性：可與ASP.NET、WPF 和 Windows Forms 集成，適用於各種開發場景。 ASP.NET Web App Framework的專門指南包括非同步列印功能。

5.可靠性和支援：憑藉 Iron Software 的良好聲譽、強大的支援和頻繁的更新，為您提供保障。 更新日誌會讓您了解最新的改進。

如何設定我的項目以進行 PDF 列印？

首先，讓我們在 Visual Studio 中建立一個新的.NET項目，並透過NuGet套件管理器安裝IronPrint庫。 開啟 Visual Studio 並依照下列步驟操作：

1. 選擇"檔案">"新建">"專案"建立一個新的.NET專案。

   

2. 選擇合適的專案範本（e.g.、控制台應用程式、 ASP.NET Web 應用程式），然後按一下"下一步"。

   Visual Studio 的"建立新專案"對話方塊顯示了各種.NET專案模板，包括控制台應用程式、 Blazor Web 應用程式和ASP.NET Core選項，並提供 C#、Windows 和所有專案類型的篩選選項。

3. 輸入項目名稱並選擇儲存位置。 點選"下一步"繼續。

   Visual Studio 的"配置新專案"對話方塊窗口，顯示了控制台應用程式的專案配置選項，包括專案名稱、位置和解決方案設定欄位。

4. 專案建立完成後，開啟NuGet套件管理器控制台（可透過"工具">"NuGet套件管理員">"套件管理器控制台"存取）。

5. 使用以下指令安裝IronPrint軟體包：

   Install-Package IronPrint

6. 或者，您可以使用NuGet程式包管理器 UI 安裝該程式包，方法是搜尋"IronPrint"並按一下"安裝"。

IronPrint安裝成功後，我們就可以進行下一步了：實現 PDF 列印功能。 請務必正確配置用於生產環境的許可證密鑰。 對於ASP.NET應用程序，您可能需要在 Web.config 中設定許可證金鑰，以避免常見的安裝錯誤。

列印PDF文檔需要什麼代碼？

現在我們的專案已經設定好了，讓我們寫一些程式碼，使用IronPrint來實作 PDF 列印功能。 我們將建立一個簡單的.NET應用程序，使用IronPrint列印 PDF 文件。 以下是一個實現此目的的基本範例：

using IronPrint;

class Program
{
    static void Main(string[] args)
    {
        // Create a new PrintSettings object to define printing preferences
        PrintSettings printSettings = new PrintSettings();

        // Set DPI (dots per inch) for clear printing
        printSettings.Dpi = 150;

        // Specify the number of copies to print
        printSettings.NumberOfCopies = 2;

        // Set paper orientation to Portrait
        printSettings.PaperOrientation = PaperOrientation.Portrait;

        // Print the specified PDF file using the default printer
        Printer.Print("output.pdf", printSettings);
    }
}

using IronPrint;

class Program
{
    static void Main(string[] args)
    {
        // Create a new PrintSettings object to define printing preferences
        PrintSettings printSettings = new PrintSettings();

        // Set DPI (dots per inch) for clear printing
        printSettings.Dpi = 150;

        // Specify the number of copies to print
        printSettings.NumberOfCopies = 2;

        // Set paper orientation to Portrait
        printSettings.PaperOrientation = PaperOrientation.Portrait;

        // Print the specified PDF file using the default printer
        Printer.Print("output.pdf", printSettings);
    }
}

上面的 C# 程式碼使用了IronPrint庫進行 PDF 列印。 首先導入必要的命名空間IronPrint。 在 Main 方法內部，它初始化一個 PrintSettings 對象，配置 DPI、份數和紙張方向等參數。 在這種情況下，DPI 設定為 150，份數設定為 2，紙張方向設定為縱向。 最後，它呼叫 Printer 類別的 Print 方法，指定輸出檔案名稱為"output.pdf"，並傳遞 printSettings 物件。 此程式碼片段示範了使用 C# 中的IronPrint庫和預設印表機進行 PDF 列印的基本設定。

對於更進階的場景，您可能需要使用對話方塊選項進行列印，讓使用者透過熟悉的介面配置列印首選項。 舉個例子：

using IronPrint;
using System;
using System.Collections.Generic;

class AdvancedPrintingExample
{
    static void Main(string[] args)
    {
        // Get available printers on the system
        List<string> printerNames = Printer.GetPrinterNames();

        Console.WriteLine("Available printers:");
        foreach (string printer in printerNames)
        {
            Console.WriteLine($"- {printer}");
        }

        // Create advanced print settings
        PrintSettings advancedSettings = new PrintSettings()
        {
            // Specify a particular printer
            PrinterName = printerNames[0], // Use first available printer

            // Set paper size to A4
            PaperSize = PaperSize.A4,

            // Configure margins (in hundredths of an inch)
            MarginTop = 50,
            MarginBottom = 50,
            MarginLeft = 100,
            MarginRight = 100,

            // Enable grayscale printing
            Grayscale = true,

            // Set custom DPI for high-quality output
            Dpi = 300
        };

        // Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings);
    }
}

using IronPrint;
using System;
using System.Collections.Generic;

class AdvancedPrintingExample
{
    static void Main(string[] args)
    {
        // Get available printers on the system
        List<string> printerNames = Printer.GetPrinterNames();

        Console.WriteLine("Available printers:");
        foreach (string printer in printerNames)
        {
            Console.WriteLine($"- {printer}");
        }

        // Create advanced print settings
        PrintSettings advancedSettings = new PrintSettings()
        {
            // Specify a particular printer
            PrinterName = printerNames[0], // Use first available printer

            // Set paper size to A4
            PaperSize = PaperSize.A4,

            // Configure margins (in hundredths of an inch)
            MarginTop = 50,
            MarginBottom = 50,
            MarginLeft = 100,
            MarginRight = 100,

            // Enable grayscale printing
            Grayscale = true,

            // Set custom DPI for high-quality output
            Dpi = 300
        };

        // Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings);
    }
}

本範例示範如何取得印表機名稱和擷取印表機訊息，使您的應用程式能夠取得 Windows、iOS 和 Android 平台上本機裝置的印表機資訊。 全面的列印設定指南涵蓋了使用 PrintSettings 類別的所有可用設定選項。