如何在 C# 中使用對話框進行列印

輸入

quarterly-report.pdf 透過 ShowPrintDialog 傳入，這是一份帶有 KPI 指標卡和部門收入表的樣式化企業 Q3 財務摘要，代表典型的業務文件傳送至列印對話框。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-open-and-print.cs

using IronPrint;

// Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf");

Imports IronPrint

' Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf")

輸出

ShowPrintDialog 為季度報告打開本機列印對話框。

此方法接受作為 string 的文件路徑或作為 byte[] 的原始文件資料。 IronPrint 偵測文件格式，通過適當的引擎渲染並呈現對話框。 當使用者確認後，文件將按照他們選擇的設置列印。 列印文件教學更詳細地介紹了完整的列印生命周期。

輸入

invoice.pdf 預載入 A4 肖像設置，300 DPI：專業帳單發票，包含項目明細、折扣、稅款和電匯指示，顯示即使應用程式已經知道所需的紙張大小和方向時的現實文件。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-preconfigure-dialog-settings.cs

using IronPrint;

// Pre-configure default dialog settings
var settings = new PrintSettings
{
    PrinterName = "HP LaserJet Pro",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false
};

// Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings);

Imports IronPrint

' Pre-configure default dialog settings
Dim settings As New PrintSettings With {
    .PrinterName = "HP LaserJet Pro",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False
}

' Open the dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings)

輸出

本機列印對話框以預先配置的 A4 肖像設置打開。

這在應用程式已經提前知道可能的印表機或紙張格式時很有用。 例如，一個始終在特定熱感印表機上列印收據的銷售點系統可以將 PrinterName 預設為那個裝置。使用者仍然可以選擇在對話框中更改它。

要發現系統上有哪些印表機可用，我們呼叫 Printer.GetPrinterNames()，它返回所有已安裝印表機的 List<string>。 類似地，Printer.GetPrinterTrays() 返回給定印表機的可用紙匣。

可配置屬性的全列表包括 PrinterName, PaperSize, PaperOrientation, Dpi, NumberOfCopies, Grayscale, PaperMargins, Flatten（對於 PDF 表單欄位），和 Tray。 列印設置指南涵蓋每個屬性並提供程式碼範例。 在 PrintSettings 中未設置的任何屬性預設為所選印表機的標準配置。

輸入

report.pdf 非同步等待中：一份多部分的 IT 基礎設施和安全報告，代表那種長篇文件，其中非阻塞對話框展示在文件載入時保持介面響應。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-async.cs

using IronPrint;

// Open the print dialog asynchronously
await Printer.ShowPrintDialogAsync("report.pdf");

Imports IronPrint

' Open the print dialog asynchronously
Await Printer.ShowPrintDialogAsync("report.pdf")

輸出

ShowPrintDialogAsync 非同步打開本機列印對話框，並透過控制台確認非阻塞執行。

ShowPrintDialogAsync() 接受與同步版本相同的參數：文件路徑或位元組陣列，外加可選的 PrintSettings 物件。 這個非同步模式遵循一致用於現代 .NET 開發的以任務為基礎的非同步模式。

IronPrint 適用於 WinForms、WPF、MAUI 和控制台應用程式。 對話框的外觀適應於主機平台和作業系統版本，因此使用者始終看到他們期望的本機列印窗口。

輸入

monthly-report.pdf 讀入 byte[]，代表從資料庫獲取或在記憶體中生成然後再發送到對話框的文件。

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-print-dialog-image-and-byte-array.cs

using IronPrint;

// Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png");

// Print from a byte array
byte[] reportData = File.ReadAllBytes("monthly-report.pdf");
Printer.ShowPrintDialog(reportData);

Imports IronPrint

' Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png")

' Print from a byte array
Dim reportData As Byte() = File.ReadAllBytes("monthly-report.pdf")
Printer.ShowPrintDialog(reportData)

輸出

對話框如上面的範例所示打開。 格式檢測是自動的：不論我們是傳入文件路徑還是 byte[]， IronPrint 都會渲染文件並呈現相同的本機對話框。

程式碼範例頁面展示了額外的格式特定場景。 對於特定於 PDF 的工作流程（生成 PDF 並立即列印），IronPDF 與 IronPrint 配合得非常自然。