使用C#及OPOS SDK.Net的PosExplorer通过IP地址连接打印机并实现页眉正文格式打印的技术求助

Hey there! Let's tackle your problem of switching from device-name-based to IP-based POS printer connectivity, plus adding formatted header and body printing.

First, a quick note: POS for .NET relies on the printer's driver/management service to expose network-connected printers—so make sure your printer is properly configured with its IP, the correct POS driver is installed, and the printer is reachable over the network (ping it first to confirm!).

Step 1: Locate the Network Printer via IP #

Instead of hardcoding a device name like "SRP2", we'll filter the available POS printers to find the one matching your target IP. Most network POS printers expose their IP in the DeviceInfo.Properties collection (look for keys like IPAddress or similar, depending on your printer's driver).

Step 2: Add Formatted Printing (Header + Body) #

To format text (bold, centered, line breaks), you'll use ESC/POS control codes—these are standard for most receipt printers. We'll define helper constants for common formatting commands, then build our print string with those.

Full Working Code Example #

using Microsoft.PointOfService;
using System.Linq;

internal void PrintFormattedReceiptOverIP(string printerIp)
{
    // Initialize PosExplorer
    using var posExplorer = new PosExplorer();
    
    // Get all available POS printers
    var receiptPrinters = posExplorer.GetDevices(DeviceType.PosPrinter);
    
    // Find the printer matching our target IP
    var targetPrinter = receiptPrinters.FirstOrDefault(device => 
        device.Properties.ContainsKey("IPAddress") && 
        device.Properties["IPAddress"].ToString() == printerIp);

    if (targetPrinter == null)
    {
        throw new System.Exception($"No POS printer found with IP: {printerIp}");
    }

    // Create printer instance
    using var printer = (PosPrinter)posExplorer.CreateInstance(targetPrinter);
    
    try
    {
        // Open, claim, and enable the printer
        printer.Open();
        printer.Claim(10000); // Wait up to 10 seconds for claim
        printer.DeviceEnabled = true;

        // Define ESC/POS control codes for formatting (adjust based on your printer model)
        const string Esc = "\x1B";
        const string BoldOn = $"{Esc}E\x01";
        const string BoldOff = $"{Esc}E\x00";
        const string CenterAlign = $"{Esc}a\x01";
        const string LeftAlign = $"{Esc}a\x00";
        const string LineFeed = "\n";

        // Build the formatted receipt content
        var receiptContent = new System.Text.StringBuilder();
        // Header section: centered, bold
        receiptContent.Append(CenterAlign);
        receiptContent.Append(BoldOn);
        receiptContent.Append("MY STORE RECEIPT");
        receiptContent.Append(BoldOff);
        receiptContent.Append(LineFeed);
        receiptContent.Append("----------------");
        receiptContent.Append(LineFeed);
        // Body section: left-aligned, regular text
        receiptContent.Append(LeftAlign);
        receiptContent.Append("Item 1: Coffee");
        receiptContent.Append(LineFeed);
        receiptContent.Append("Price: $2.99");
        receiptContent.Append(LineFeed);
        receiptContent.Append(LineFeed);
        receiptContent.Append(CenterAlign);
        receiptContent.Append("Thank you for your visit!");
        receiptContent.Append(LineFeed);
        // Add a cut command (if your printer supports it)
        receiptContent.Append($"{Esc}i");

        // Send the content to the printer
        printer.PrintNormal(PrinterStation.Receipt, receiptContent.ToString());
    }
    finally
    {
        // Clean up resources regardless of success/failure
        if (printer.Claimed)
        {
            printer.Release();
        }
        printer.Close();
    }
}

Key Notes: #

• IP Detection: The IPAddress property name might vary by printer manufacturer—check your printer's POS driver documentation if this doesn't work. Some printers use NetworkAddress instead.
• Control Codes: ESC/POS codes differ slightly between printer models. For example, some use \x1B\x45\x01 for bold on instead of \x1B\xE\x01—refer to your printer's programming manual for exact codes.
• Error Handling: I added basic error handling, but you'll want to expand this (catch PosControlException for POS-specific errors, handle timeouts, etc.).
• Using Statements: Wrapping PosExplorer and PosPrinter in using ensures proper resource disposal.

To use this method, just call it with your printer's IP:

PrintFormattedReceiptOverIP("192.168.1.100");

内容的提问来源于stack exchange，提问作者Mik AA