.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对象。 此代码片段展示了使用 IronPrint 库在 C# 和默认打印机中进行 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"选项。