.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 專案。

   Visual Studio 檔案選單打開，顯示建立新專案的選項，其中"新"和"專案"選項已高亮顯示。

2. 選擇合適的專案範本（ eg ，控制台應用程式、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類別的所有可用設定選項。

Windows"儲存列印輸出"對話方塊顯示檔案儲存介面，其中包含一個名為"net6.0"的資料夾，該資料夾內有PDF文件，檔案名稱段已填寫，並且已選取"另存為PDF"選項。