如何在不使用 Adob​​e 的情况下，使用IronPrint在.NET中打印 PDF

如何在.NET项目中安装IronPrint ？

通过NuGet包管理器安装IronPrint只需几秒钟。 在 Visual Studio 中打开包管理器控制台并运行：

Install-Package IronPrint

安装完成后，在任何需要打印的文件顶部添加命名空间导入语句，然后在调用任何IronPrint方法之前应用您的许可证密钥：

Imports IronPrint

' Apply your license key (get a free trial key at ironsoftware.com)
License.LicenseKey = "YOUR-LICENSE-KEY"

Imports IronPrint

' Apply your license key (get a free trial key at ironsoftware.com)
License.LicenseKey = "YOUR-LICENSE-KEY"

IronPrint 的目标平台为.NET Framework 4.6.2 及以上版本，以及.NET 6、7、8、9 和 10。它为每个平台都配备了原生渲染引擎，因此您无需安装 Adob​​e Acrobat、Ghostscript 或任何其他 PDF 渲染器。 同一个NuGet包适用于用.NET编写的 Windows Forms、WPF、控制台应用程序和ASP.NET项目。

支持的文档格式包括 PDF、PNG、HTML、TIFF、GIF、JPEG 和 BMP。您可以在IronPrint统一打印 API 参考文档中了解其全部功能。

有关许可和激活的更多信息，请访问IronPrint许可证密钥文档。

如何在.NET中静默打印PDF？

静默打印是指直接将文档发送到打印机，而不显示任何对话框。 此模式对于自动化工作流程、批量发票处理、报表生成管道以及没有用户在场的服务器端文档打印至关重要。

根据微软关于.NET中 GDI+ 打印的文档，传统的.NET打印涉及创建一个 PrintDocument 对象，挂钩到 PrintPage 事件，并手动处理页面布局。 IronPrint省去了所有这些样板代码：

Imports IronPrint

Module SilentPrinting
    Sub Main()
        Dim pdfPath As String = "invoice.pdf"

        ' Print to the system default printer
        Printer.Print(pdfPath)

        ' Print to a specific printer by name
        Dim settings As New PrintSettings()
        settings.PrinterName = "Microsoft Print to PDF"
        Printer.Print(pdfPath, settings)
    End Sub
End Module

Imports IronPrint

Module SilentPrinting
    Sub Main()
        Dim pdfPath As String = "invoice.pdf"

        ' Print to the system default printer
        Printer.Print(pdfPath)

        ' Print to a specific printer by name
        Dim settings As New PrintSettings()
        settings.PrinterName = "Microsoft Print to PDF"
        Printer.Print(pdfPath, settings)
    End Sub
End Module

Printer.Print 方法在内部处理所有 PDF 渲染。 当您调用 Printer.Print(pdfPath) 而不带 PrintSettings 参数时， IronPrint会自动选择系统默认打印机。 当您提供一个带有 PrintSettings 值的 PrinterName 对象时，它会将作业路由到该特定设备。

对于批量处理场景，您可以遍历文件路径列表，并对每个文件调用 Printer.Print。 由于IronPrint不会为静默打印打开任何 UI 线程，因此它在控制台应用程序、Windows 服务和ASP.NET请求处理程序中都能正常工作。

要深入了解可用选项，请阅读IronPrint打印设置文档。

如何在打印前显示打印对话框？

有时，在执行打印作业之前，需要让用户选择打印机、调整页面范围或设置份数。 IronPrint为这种情况提供了 Printer.ShowPrintDialog：

Imports IronPrint

Module DialogPrinting
    Sub Main()
        ' Display the standard Windows print dialog
        Printer.ShowPrintDialog("report.pdf")
    End Sub
End Module

Imports IronPrint

Module DialogPrinting
    Sub Main()
        ' Display the standard Windows print dialog
        Printer.ShowPrintDialog("report.pdf")
    End Sub
End Module

运行此方法时，Windows 将显示其标准打印对话框。 用户可以选择任何已安装的打印机，选择页面范围，选择份数，并调整双面打印设置。 用户点击"打印"或"取消"后，控制权将返回到您的代码。

这种方法可以自然地集成到 Windows Forms 应用程序中。 你可以从按钮点击处理程序中调用它，并相信该对话框的行为将与用户已知的其他 Windows 应用程序的行为保持一致。

打印对话框示例页面显示了其他使用案例，包括在对话框打开之前预先选择打印机或预先填充份数。

如何在.NET中自定义PDF打印设置？

PrintSettings 类使您可以完全通过编程方式控制打印作业的各个方面。 您可以在作业到达打印队列之前设置 DPI、纸张尺寸、方向、份数和目标打印机：

Imports IronPrint

Module CustomPrintSettings
    Sub Main()
        Dim settings As New PrintSettings() With {
            .Dpi = 300,
            .NumberOfCopies = 2,
            .PaperOrientation = PaperOrientation.Landscape,
            .PaperSize = PaperSize.A4,
            .PrinterName = "Office Printer"
        }

        Printer.Print("document.pdf", settings)
    End Sub
End Module

Imports IronPrint

Module CustomPrintSettings
    Sub Main()
        Dim settings As New PrintSettings() With {
            .Dpi = 300,
            .NumberOfCopies = 2,
            .PaperOrientation = PaperOrientation.Landscape,
            .PaperSize = PaperSize.A4,
            .PrinterName = "Office Printer"
        }

        Printer.Print("document.pdf", settings)
    End Sub
End Module

如何通过编程方式枚举和选择打印机？

在企业环境中，工作站通常可以访问数十台网络打印机。 IronPrint可以轻松列出所有可用打印机，并在运行时选择正确的打印机：

Imports IronPrint

Module PrinterManagement
    Sub Main()
        ' Retrieve all available printers
        Dim printers As List(Of String) = Printer.GetPrinterNames()

        Console.WriteLine($"Found {printers.Count} printer(s):")
        For Each printerName As String In printers
            Console.WriteLine($"  - {printerName}")
        Next

        ' Print to the first available printer
        If printers.Count > 0 Then
            Dim settings As New PrintSettings()
            settings.PrinterName = printers(0)
            Printer.Print("document.pdf", settings)
        Else
            Console.WriteLine("No printers found. Check system configuration.")
        End If
    End Sub
End Module

Imports IronPrint

Module PrinterManagement
    Sub Main()
        ' Retrieve all available printers
        Dim printers As List(Of String) = Printer.GetPrinterNames()

        Console.WriteLine($"Found {printers.Count} printer(s):")
        For Each printerName As String In printers
            Console.WriteLine($"  - {printerName}")
        Next

        ' Print to the first available printer
        If printers.Count > 0 Then
            Dim settings As New PrintSettings()
            settings.PrinterName = printers(0)
            Printer.Print("document.pdf", settings)
        Else
            Console.WriteLine("No printers found. Check system configuration.")
        End If
    End Sub
End Module

Printer.GetPrinterNames() 查询 Windows 打印子系统，并返回当前用户可以访问的所有打印机，包括本地 USB 打印机、网络打印机、虚拟打印机(如 Microsoft Print to PDF)以及通过第三方软件安装的任何打印机驱动程序。

如何在.NET中处理打印错误？

生产打印代码必须能够优雅地处理故障。 文件路径可能错误，打印机可能处于脱机状态，或者用户帐户可能缺少打印权限。 将打印调用封装在结构化的异常处理中，可以防止未处理的异常导致应用程序崩溃：

Imports IronPrint
Imports System.IO

Module 错误Handling
    Sub Main()
        Dim filePath As String = "document.pdf"

        If Not File.Exists(filePath) Then
            Console.WriteLine("PDF file not found. Verify the path and try again.")
            Return
        End If

        Try
            Dim settings As New PrintSettings()
            settings.PrinterName = "Office Printer"
            Printer.Print(filePath, settings)
            Console.WriteLine("Print job sent successfully.")
        Catch ex As Exception
            Console.WriteLine($"Printing failed: {ex.Message}")
        End Try
    End Sub
End Module

Imports IronPrint
Imports System.IO

Module 错误Handling
    Sub Main()
        Dim filePath As String = "document.pdf"

        If Not File.Exists(filePath) Then
            Console.WriteLine("PDF file not found. Verify the path and try again.")
            Return
        End If

        Try
            Dim settings As New PrintSettings()
            settings.PrinterName = "Office Printer"
            Printer.Print(filePath, settings)
            Console.WriteLine("Print job sent successfully.")
        Catch ex As Exception
            Console.WriteLine($"Printing failed: {ex.Message}")
        End Try
    End Sub
End Module

如何在.NET中将PDF生成和打印结合起来？

常见的工作流程是在运行时生成 PDF 文件并立即打印——例如，一步到位地从数据库记录创建发票并将其发送到打印机。IronPDF 负责生成 PDFIronPDF，而IronPrint负责输出：

如何打印多页并控制页面范围？

打印大型文档时，您可能只需要打印特定页面——例如，50 页报告中的第 1 至 5 页。 IronPrint 的 PrintSettings 类支持页面范围配置：

下一步计划是什么？

现在您已经掌握了在.NET应用程序中进行PDF打印的基本要素：

-静默打印-- Printer.Print(path) 用于自动化工作流程 -对话框打印-- Printer.ShowPrintDialog(path) 用于用户控制的作业 -自定义设置-- PrintSettings 用于 DPI、方向、份数和打印机选择 -打印机枚举-- Printer.GetPrinterNames() 用于动态打印机路由 -错误处理——结构化的异常处理，并带有预检文件验证 -组合工作流程IronPDF用于生成， IronPrint用于输出

要体验这些功能，请开始您的IronPrint免费试用，并探索以下其他资源：

IronPrint入门指南——完整设置步骤 -带对话框的打印示例-- 对话框自定义模式 高级打印设置功能——完整设置参考 -打印机信息功能-- 查询打印机属性 IronPrint API 参考——完整的类和方法文档 IronPrint故障排除指南——解决常见问题