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

Updated: 2026年5月9日

IronPrint 提供 Printer.ShowPrintDialog()：一種方法可以打開本機作業系統的列印對話框，捕捉使用者的印表機和紙張選擇，並將文件發送到列印隊列。安裝一個 NuGet 套件並撰寫一行程式碼。

列印對話框是標準的作業系統窗口，用於讓使用者選擇印表機、設置份數、選擇頁面範圍，以及調整紙張選項後再進行列印。需要在每次工作前給使用者這種控制的桌面應用程式是主要使用案例。

快速入門：使用對話框進行列印

1Install IronPrint with NuGet Package Manager
PM > Install-Package IronPrint
```
Install-Package IronPrint
```

2複製並運行這段程式碼片段。

using IronPrint;

// Display the print dialog and print the document
Printer.ShowPrintDialog("document.pdf");

using IronPrint;

// Display the print dialog and print the document
Printer.ShowPrintDialog("document.pdf");

3部署以在您的實時環境中測試

今天就開始在您的專案中使用IronPrint，透過免費試用

最小化工作流程（5 步驟）

安裝 IronPrint C# 列印程式庫
Call Printer.ShowPrintDialog("filepath")
使用者選擇印表機、份數和頁面範圍
點擊列印將文件發送到所選的印表機
驗證文件按照所選設定列印

列印對話框在 C# 中如何運作？

Printer.ShowPrintDialog() 方法打開作業系統的本機列印對話框。使用者可以看到完整的列印選項集：印表機選擇、份數、頁面範圍、方向和紙張大小。他們點擊列印發送工作，或取消退出對話框而不列印。

在底層，本機 .NET 方法需要建立一個 System.Windows.Forms.PrintDialog 實例，將其連接到 PrintDocument，處理 PrintPage 事件以在列印圖形表面上繪製內容，檢查 DialogResult，然後呼叫 PrintDocument.Print()。此設置通常需要15到25行程式碼。它還不包括內建的 PDF 或圖片渲染（通過本機對話框列印 PDF 意味著首先必須將 PDF 解析為可繪制的頁面，這需要另一個程式庫）。

IronPrint 能夠在一次呼叫中處理整個流程：

輸入

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

using IronPrint;

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

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")

Imports IronPrint

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

輸出

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

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

如何預先配置對話框設置？

我們可以通過建立 PrintSettings 物件並將其作為第二個參數傳入來設置預設值。對話框將以這些預選值打開，使用者可以按原樣接受或覆蓋任何設置。

輸入

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

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);

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)

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 中未設置的任何屬性預設為所選印表機的標準配置。

如何非同步顯示對話框？

Printer.ShowPrintDialogAsync() 方法返回 Task，使其與 await 相容。這防止了對話框阻塞 UI 執行緒，這對於 WPF、MAUI 和任何因介面凍結而導致糟糕使用者體驗的應用程式是必需的。

輸入

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

using IronPrint;

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

using IronPrint;

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

Imports 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 和控制台應用程式。對話框的外觀適應於主機平台和作業系統版本，因此使用者始終看到他們期望的本機列印窗口。

我什麼時候應該使用對話框，什麼時候應該使用靜默列印？

當使用者需要在每次任務前選擇列印設置時使用對話框；對於不需要人為決策的自動化工作流程使用靜默列印。

標準	使用對話框列印	靜默列印
使用者互動	使用者選擇印表機、份數、頁面範圍	無互動； prints immediately
最適合	桌面應用程式、一次性列印、面向使用者的功能	批量作業、背景服務、售票亭應用程式
印表機選擇	使用者從對話框中選擇	透過 `PrintSettings` 程式化設定
IronPrint 方法	`Printer.ShowPrintDialog()`	`Printer.Print()`
非同步變體	`ShowPrintDialogAsync()`	`PrintAsync()`

報告匯出、發票列印以及任何錯誤的印表機會浪費物料的工作都是對話框的絕佳候選項。靜默列印適合於無需在文件之間進行人為決策的自動化工作流程。

列印對話框支持哪些文件格式？

Printer.ShowPrintDialog() 支持與靜默列印相同的格式：PDF、PNG、TIFF、JPEG、GIF、HTML 和 BMP。我們不論格式都傳入文件路徑，IronPrint 處理渲染和列印排隊機通信。也接受作為 byte[] 的文件資料，這在文件是在記憶體中生成或從資料庫獲取時很有用。

輸入

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

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);

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)

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 配合得非常自然。

下一步

使用對話框列印歸結為兩種方法：同步呼叫的 Printer.ShowPrintDialog() 和非阻塞執行的 Printer.ShowPrintDialogAsync()。使用 PrintSettings 預設置預設值，然後讓使用者從那里進行調整。這兩種方法都支持 IronPrint 的所有文件格式，並適用於 WinForms、WPF、MAUI 及控制台專案。

探索 IronPrint 教學指南以獲得完整指南，Printer 類別 API 參考以了解每個可用的方法，或列印設置指南以進行進階配置。更新記錄跟蹤最新改進和新特性。

開始免費 30 天試用在實際專案中測試對話框列印，無需信用卡。準備好發佈時，查看授權選項從 $999 開始。