USING IRONPRINT

如何在 C# 中使用網路列印機列印

Curtis Chau
Curtis Chau
Updated: 2026年6月28日

在各種軟體應用程式中，透過程式印刷在網路印表機上是一項常見的任務。 無論您是在建立桌面、移動應用程式，還是網路服務，能夠直接將文件發送到網路印表機可以極大地提升您的軟體的易用性和效率。 在本文中，我們將探討如何使用C#和IronPrint從Iron Software在網路印表機上印刷。

How to Print with Network Printer in C#

  1. 使用IronPrint建立一個新的專案以進行文件印刷。
  2. 將IronPrint安裝到新專案中。
  3. 列出可用來印刷文件的網路印表機。
  4. 使用IronPrint印刷PDF文件。
  5. 使用IronPrint的對話框印刷PDF文件。
  6. 使用印刷設置進行高級印刷。

設定環境

在進入編碼部分之前，讓我們確保我們的環境已正確設定。 在C#中要在網路印表機上印刷，您需要以下幾點：

  1. 確保一台網路印表機從運行您C#應用程式的機器上可存取。
  2. 印表機的網路地址（IP地址或網路印表機名稱）。
  3. 在機器上安裝必要的印表機驅動程式/驅動程式。
  4. 如果需要，安裝印表機或驅動程式的管理員權限。

IronPrint

在深入了解實現細節之前，讓我們熟悉如何開始使用IronPrint：

  1. 安裝：可以透過NuGet包管理器輕鬆安裝IronPrint。 只需存取NuGet頁面並按照安裝說明進行操作。
  2. 文件：參閱官方文件以獲得快速入門指南和全面的API參考。

相容性和支持：IronPrint在各種環境和專案型別中提供廣泛的相容性和支持：

  • .NET版本支持：IronPrint支持C#，VB.NET和F#，包括.NET 8,7,6,5及Core 3.1+。
  • 操作系統和環境：IronPrint與Windows (7+), macOS (10+), iOS (11+)和Android API 21+ (v5 "Lollipop")相容。
  • 專案型別：無論您是在開發移動應用程式（Xamarin, MAUI, Avalonia），桌面（WPF, MAUI, Windows Avalonia）或控制台應用程式，IronPrint都能滿足您的需求。

現在讓我們看看如何使用IronPrint印刷，以下是一個例子。

using IronPrint;

namespace IronPrintDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configure printer setting
            PrintSettings printSettings = new PrintSettings();
            printSettings.Dpi = 220;
            printSettings.NumberOfCopies = 10;
            printSettings.PaperOrientation = PaperOrientation.Portrait;
            
            // Print the document
            Printer.Print("awesomeIronPrint.pdf", printSettings);
        }
    }
}

System.Printing

C#中的System.Printing命名空間包含類和接口，使開發人員能夠透過程式與印表機、列印隊列、列印伺服器和列印作業進行交互。 此命名空間中的一些關鍵類和接口包括：

  1. PrintQueue：代表系統連接的印表機或印刷裝置。
  2. PrintServer：代表網路上的一個列印伺服器。
  3. PrintSystemJobInfo：提供有關列印作業的資訊，如其狀態和屬性。
  4. PrintTicket：表示列印作業的設置，包括紙張大小、方向和列印質量。

開始使用System.Printing列印的基本了解：

  1. PrintQueue物件。
  2. PrintTicket物件以指定列印設置，如紙張大小、方向和份數。
  3. 文件印刷：最後，將要列印的文件發送到所選的PrintQueue。

使用System.Printing列印文件的過程：

這是源程式碼：

using System;
using System.IO;
using System.Printing;

class Program
{
    static void Main(string[] args)
    {
        // Specify the path to the document to be printed on the local printer
        string documentPath = "path/to/your/document.pdf";

        // Instantiate a Printer Server object representing the local print server
        using (PrintServer printServer = new PrintServer())
        {
            // Get the default PrintQueue from the PrintServer default 
            PrintQueue defaultPrintQueue = printServer.DefaultPrintQueue;

            // Create a PrintTicket object to specify print settings (optional)
            PrintTicket printTicket = new PrintTicket();

            // Configure print settings, e.g., number of copies
            printTicket.CopyCount = 1;

            // Print the document to the default PrintQueue with the specified PrintTicket
            defaultPrintQueue.AddJob("MyPrintJob", documentPath, false, printTicket);
        }

        Console.WriteLine("Document sent to print queue.");
    }
}

IronPrint 與 System.Printing

如何用 C#: 在網路印表機上印刷：圖1 - IronPrint vs System.Printing 快速比較表

此表提供了IronPrint和System.Printing的功能和特性的一個快速概覽，幫助開發人員根據他們的特殊需求和平台目標做出明智的決定。

第一步：使用IronPrint建立一個新的文件印刷專案

在Visual Studio中建立以下所示的控制台應用程式。

如何用 C#: 在網路印表機上印刷：圖2 - 建立控制台應用程式

提供專案的名稱和位置。

如何用 C#: 在網路印表機上印刷：圖3 - 提供專案名稱

選擇 .NET 版本。

如何用 C#: 在網路印表機上印刷：圖4 - 選擇合適的 .NET 版本

現在專案已建立並準備進行進一步的編碼。

第二步：在新項目上安裝 IronPrint

從Visual Studio包管理器安裝IronPrint，如下所示。

如何用 C#: 在網路印表機上印刷：圖5 - 通過Visual Studio包管理器搜索IronPrint

IronPrint也可以使用以下命令進行安裝：

PM > Install-Package IronPrint

第三步：列出可用來印刷文件的網路印表機

要使用IronPrint列出印表機名稱，請使用以下程式碼：

using System;
using System.Collections.Generic;
using IronPrint;

namespace IronPrintDemo
{
    public class Program
    {
        public static void Main()
        {
            // Get printer names using printer drivers
            List<string> printersName = Printer.GetPrinterNames();
            foreach (var printer in printersName)
            {
                Console.WriteLine(printer);
            }
        }
    }
}

程式碼解釋

  1. 使用Printer.GetPrinterNames獲取所有可用的驅動程式。
  2. 使用Console.WriteLine列印名稱。

輸出

如何用 C#: 在網路印表機上印刷：圖6 - 有關可用印表機的範例輸出

第四步：使用 IronPrint 印刷 PDF 文件

使用以下程式碼以安靜方式列印文件：

using IronPrint;

namespace IronPrintDemo
{
    public class Program
    {
        public static void Main()
        {
            // Print the document silently
            Printer.Print("sample.pdf");
        }
    }
}

執行後，文件將按輸出所示新增到列印隊列中。

輸出

如何用 C#: 在網路印表機上印刷：圖7 - 加入列印隊列的文件範例輸出

第五步：使用 IronPrint 和對話框列印 PDF 文件

使用以下程式碼通過對話框列印文件：

using IronPrint;

namespace IronPrintDemo
{
    public class Program
    {
        public static void Main()
        {
            // Print with Dialog
            Printer.ShowPrintDialog("sample.pdf");
        }
    }
}

程式碼解釋

  1. 使用ShowPrintDialog從IronPrint我們可以通過對話框印刷。
  2. 一旦對話框打開，選擇所需的印表機以列印文件。

輸出

如何用 C#: 在網路印表機上印刷：圖8 - 選擇正確的列印機

第六步：使用列印設置進行高級列印

文件列印中的高級設置由IronPrint支援。 它支持以下屬性：

  1. PaperSize： 指定印表機所用的紙張尺寸。
  2. PaperOrientation： 定義紙張方向，例如自動、縱向或橫向。
  3. DPI： 以每英寸點數設置所需的列印解析度。 預設值是300，通常用於商業印刷。 實際DPI可能受印表機能力限制。
  4. NumberOfCopies： 指定要列印的文件的相同複本數量。
  5. PrinterName： 指定用於列印任務的印表機名稱。
  6. PaperMargins： 確定列印的邊距，以毫米為單位。
  7. Grayscale： 一個布林值，決定是否以灰階列印。 預設為false。

現在讓我們看看程式碼範例：

using IronPrint;

namespace IronPrintDemo
{
    public class Program
    {
        public static void Main()
        {
            // Configure custom print settings
            PrintSettings printSettings = new PrintSettings();
            printSettings.Dpi = 150;
            printSettings.NumberOfCopies = 2;
            printSettings.PaperOrientation = PaperOrientation.Portrait;

            // Print the required document
            Printer.Print("sample.pdf", printSettings);
        }
    }
}

程式碼解釋

  1. 程式碼開始時導入必要的命名空間IronPrint，其中包含列印所需的類和方法。
  2. 在IronPrintDemo命名空間內，有一個被聲明為公共的Program類。
  3. Main方法作為該程式的進入點。
  4. 在Main方法中：
    • 實例化一個命名為PrintSettings物件以配置自定義列印設置。
    • Dpi屬性設置為150，表示150每英寸點的列印解析度。
    • NumberOfCopies屬性設置為2，指定將列印文件的兩個相同副本。
    • PaperOrientation.Portrait，表示文件將以縱向列印。
  5. 最後，調用Printer.Print方法，參數為"sample.pdf"（要列印的文件名稱）和 printSettings（自定義列印設置）。 此方法使用指定的設置處理列印過程。

輸出

如何用 C#: 在網路印表機上印靠：圖9 - 將PDF文件新增到列隊中的範例輸出

授權

IronPrint來自Iron Software，是一個企業級程式庫，運行需要許可證。 新增IronPrint授權金鑰使專案無限制或浮水印地運行。 在此處購買許可證或註冊免費30天試用金鑰。

一旦獲得許可證密鑰，必須將該密鑰放在應用程式的appSettings.json文件中

{
  "IronPrint.License.LicenseKey": "IRONPRINT.KEY"
}
JSON

這將使沒有限制和浮水印的文件列印。

結論

總結，IronPrint和System.Printing各有所長，適合不同的場景。 IronPrint提供了簡化的跨平台解決方案，注重簡單性和多功能性，而System.Printing提供了原生整合和精細控制，尤其適用於基於Windows的應用程式。 在選擇這些列印程式庫進行C#項目時，開發人員應考慮他們的具體要求和平台目標。

IronPrint透過提供使用者友好的API和跨平台的廣泛相容性，簡化了.NET應用程式中的文件列印。您可以透過本文中所概述的步驟，將列印功能無縫整合到您的.NET專案中，提高其可用性和生產力。 探索IronPrint的可能性，解鎖您應用程式內高效文件列印的世界。

Curtis Chau
Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

閱讀更多

相關文章