如何在 C# 中列印文件到列印機

安裝Visual Studio

如果您尚未安裝Visual Studio，請從官方網站下載並安裝：Visual Studio。

建立新專案

1. 打開Visual Studio。
2. 點擊"建立新專案"。

選擇專案模板

1. 在"建立新專案"對話框中，根據您的偏好選擇"Windows Forms App (.NET Framework)"或"Windows Forms App (.NET Core)"。

2. 為您的專案提供名稱和位置。

3. 點擊下一步，從額外資訊螢幕選擇.NET Framework，然後點擊"建立"。

設計表單

1. 專案建立後，主表單將在設計器中顯示。
2. 使用工具箱向表單中新增按鈕、文字框、標籤等控件。
3. 使用屬性窗口自訂每個控件的屬性。

4. 調整表單的外觀和佈局。

IronPrint簡介

IronPrint是由Iron Software開發的一個全面列印程式庫，設計用於與.NET應用程式無縫整合。 無論您正在進行桌面、網頁還是行動專案，IronPrint提供了多功能的列印PDF文件功能，支援各種文件格式並提供可自訂列印設定。

主要特點

1. 格式支援：IronPrint支援各種文件格式，包括PDF、PNG、TIFF、GIF、JPEG和BITMAP。這種多樣性確保開發者可以處理不同型別的內容以進行列印。
2. 可自訂設定：開發者可以根據其應用程式的需求自訂列印設定。 這包括設置DPI（每英寸點數）、指定紙張方向（縱向或橫向）和控制副本數量的選項。
3. 列印對話框：IronPrint 通過允許開發者在列印前顯示列印對話框來促進無縫的使用者體驗。 這在使用者必須與列印過程互動並選擇特定選項的情況下非常有用。
4. 靜默列印：IronPrint提供了靜默列印功能，特別有利於自動化和提升工作流程效率。 這允許開發者在沒有使用者互動的情況下列印發票，消除手動干預需求並精簡整體過程。
5. 跨平台相容性：IronPrint超越平台限制，提供與多種環境的相容性，包括Windows (7+)、macOS (10+)、iOS (11+)和Android API 21+ (v5 "Lollipop")。 它無縫整合了不同的專案型別，如Mobile (Xamarin, MAUI & Avalonia)、Desktop (WPF, MAUI & Windows Avalonia) 和 Console (App & Library)。
6. 廣泛的.NET版本支援：無論您使用最新的.NET 8、7、6或Core 3.1+，IronPrint都支持。 它也支援.NET Framework (4.6.2+)，確保在各種開發環境中具有相容性。

安裝IronPrint

在深入進行文件列印之前，您需要安裝IronPrint程式庫。 您可以輕鬆使用NuGet套件管理器控制台來執行此操作：

Install-Package IronPrint

此命令行將下載並安裝IronPrint程式庫到您的C#專案中。

初始化IronPrint

安裝IronPrint後，您需要在您的C#程式碼中初始化它。 匯入IronPrint命名空間，並設置授權金鑰以確保其正常運作：

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
    }
}

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
    }
}

Imports IronPrint
Friend Class Program
	Public Shared Sub Main()
		License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY"
	End Sub
End Class

使用IronPrint列印文件

使用IronPrint列印文件很簡單。 您可以使用Printer類別，指定文件路徑到Print方法進行靜默列印PDF：

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        // Specify the file path
        var document = "C:\\path\\to\\your\\file.pdf";
        // Print PDFs
        Printer.Print(document);
    }
}

using IronPrint;
class Program
{
    public static void Main()
    {
        License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        // Specify the file path
        var document = "C:\\path\\to\\your\\file.pdf";
        // Print PDFs
        Printer.Print(document);
    }
}

Imports IronPrint
Friend Class Program
	Public Shared Sub Main()
		License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY"
		' Specify the file path
		Dim document = "C:\path\to\your\file.pdf"
		' Print PDFs
		Printer.Print(document)
	End Sub
End Class

靜默列印的好處是不需要任何使用者互動即可列印PDF，這對於需要自動化來精簡工作流程的情況非常有幫助。 對於需要使用者互動的情況，如列印前的對話框，您可以使用ShowPrintDialog，該功能實現相同結果，但帶有對話框作為額外步驟。

儘管此範例僅顯示列印PDF文件，IronPrint還支援多種文件格式，包括PDF、PNG、TIFF、GIF、JPEG、IMAGE和BITMAP。

自訂列印設定

IronPrint允許您根據應用程式需求自訂列印設定。 您可以使用PrintSettings類別配置DPI、列印份數、紙張方向等設定。 以下程式碼範例幫助您設置頁面設定並列印PDF文件：

using IronPrint;
class Program
{
    public static void Main()
    {
        IronPrint.License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        Console.WriteLine("Printing Started...");
        // Specify the file path
        string filePath = "C:\\path\\to\\your\\file.pdf";
        // Configure print settings
        PrintSettings printSettings = new PrintSettings();
        printSettings.Dpi = 300;
        printSettings.NumberOfCopies = 2;
        printSettings.PaperOrientation = PaperOrientation.Landscape;
        // Print the document with custom settings
        Printer.Print(filePath, printSettings);
        // Print using the Print dialog
        Printer.ShowPrintDialog(filePath, printSettings);
    }
}

using IronPrint;
class Program
{
    public static void Main()
    {
        IronPrint.License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY";
        Console.WriteLine("Printing Started...");
        // Specify the file path
        string filePath = "C:\\path\\to\\your\\file.pdf";
        // Configure print settings
        PrintSettings printSettings = new PrintSettings();
        printSettings.Dpi = 300;
        printSettings.NumberOfCopies = 2;
        printSettings.PaperOrientation = PaperOrientation.Landscape;
        // Print the document with custom settings
        Printer.Print(filePath, printSettings);
        // Print using the Print dialog
        Printer.ShowPrintDialog(filePath, printSettings);
    }
}

Imports IronPrint
Friend Class Program
	Public Shared Sub Main()
		IronPrint.License.LicenseKey = "YOUR_IRONPRINT_LICENSE_KEY"
		Console.WriteLine("Printing Started...")
		' Specify the file path
		Dim filePath As String = "C:\path\to\your\file.pdf"
		' Configure print settings
		Dim printSettings As New PrintSettings()
		printSettings.Dpi = 300
		printSettings.NumberOfCopies = 2
		printSettings.PaperOrientation = PaperOrientation.Landscape
		' Print the document with custom settings
		Printer.Print(filePath, printSettings)
		' Print using the Print dialog
		Printer.ShowPrintDialog(filePath, printSettings)
	End Sub
End Class

這就是輸出的樣子：

如果沒有安裝實體印表機，則使用預設印表機列印PDF文件。 要獲取所有可用的印表機，您還可以使用GetPrinterNames方法。

// Retrieve printers' name
List<string> printersName = Printer.GetPrinterNames();
foreach (string printer in printersName)
{
    Console.WriteLine(printer);
}

// Retrieve printers' name
List<string> printersName = Printer.GetPrinterNames();
foreach (string printer in printersName)
{
    Console.WriteLine(printer);
}

' Retrieve printers' name
Dim printersName As List(Of String) = Printer.GetPrinterNames()
For Each printer As String In printersName
	Console.WriteLine(printer)
Next printer

如需更多詳細資訊，請存取文件頁面。