C# USB-Barcodescanner: Erstellen Sie eine vollständige Scan-Anwendung

Warum vereinfacht der HID-Tastaturkeilmodus die Integration?

Die meisten USB-Barcodescanner werden standardmäßig im HID-Tastatur-Wedge-Modus ausgeliefert. Wenn Sie ein solches Gerät an einen Windows-Rechner anschließen, erkennt das Betriebssystem es sowohl als USB-Speichergerät (zur Konfiguration) als auch als Tastatur (zur Dateneingabe). Beim Scannen eines Barcodes übersetzt das Gerät den dekodierten Barcode-Wert in Tastatureingaben und sendet diese an das jeweilige Anwendungsfenster, das den Fokus hat, wobei am Ende ein Zeilenumbruch angehängt wird.

Aus der Sicht eines C#-Entwicklers bedeutet dies, dass keine herstellerspezifischen SDKs, COM-Bibliotheken oder spezielle USB-APIs benötigt werden. Ein Standard-TextBox-Steuerelement mit einem KeyDown-Handler genügt, um Eingaben zu erfassen. Die größte Herausforderung bei der Integration besteht darin, die Eingabe durch den Scanner von der tatsächlichen Tastatureingabe zu unterscheiden. Scanner liefern typischerweise alle Zeichen in einem sehr kurzen Moment – ​​oft unter 50 Millisekunden –, während menschliches Tippen die Tastenanschläge über Hunderte von Millisekunden verteilt. Das Timing der Tastenanschläge ist eine zuverlässige Methode, um versehentliche Tastendrücke herauszufiltern.

Professionelle Scanner unterstützen außerdem serielle Schnittstellen (RS-232 oder virtueller COM-Port) und direkte USB-HID-Modi, die Ihnen mehr Kontrolle über Präfix-/Suffixzeichen und Scan-Trigger geben. Das untenstehende Schnittstellenmuster behandelt beide Fälle:

public interface IScannerInput
{
    event EventHandler<string> BarcodeScanned;
    void StartListening();
    void StopListening();
}

public class KeyboardWedgeScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly TextBox _inputBox;
    private readonly System.Windows.Forms.Timer _burstTimer;
    private readonly System.Text.StringBuilder _buffer = new();

    public KeyboardWedgeScanner(TextBox inputBox)
    {
        _inputBox = inputBox;
        _burstTimer = new System.Windows.Forms.Timer { Interval = 80 };
        _burstTimer.Tick += OnBurstTimeout;
        _inputBox.KeyPress += OnKeyPress;
    }

    private void OnKeyPress(object sender, KeyPressEventArgs e)
    {
        if (e.KeyChar == (char)Keys.Enter)
        {
            _burstTimer.Stop();
            string value = _buffer.ToString().Trim();
            _buffer.Clear();
            if (value.Length > 0)
                BarcodeScanned?.Invoke(this, value);
        }
        else
        {
            _buffer.Append(e.KeyChar);
            _burstTimer.Stop();
            _burstTimer.Start();
        }
        e.Handled = true;
    }

    private void OnBurstTimeout(object sender, EventArgs e)
    {
        _burstTimer.Stop();
        _buffer.Clear(); // incomplete burst -- discard
    }

    public void StartListening() => _inputBox.Focus();
    public void StopListening() => _inputBox.Enabled = false;
}

public class SerialPortScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly System.IO.Ports.SerialPort _port;

    public SerialPortScanner(string portName, int baudRate = 9600)
    {
        _port = new System.IO.Ports.SerialPort(portName, baudRate);
        _port.DataReceived += OnDataReceived;
    }

    private void OnDataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
    {
        string data = _port.ReadLine().Trim();
        if (data.Length > 0)
            BarcodeScanned?.Invoke(this, data);
    }

    public void StartListening() => _port.Open();
    public void StopListening() => _port.Close();
}

public interface IScannerInput
{
    event EventHandler<string> BarcodeScanned;
    void StartListening();
    void StopListening();
}

public class KeyboardWedgeScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly TextBox _inputBox;
    private readonly System.Windows.Forms.Timer _burstTimer;
    private readonly System.Text.StringBuilder _buffer = new();

    public KeyboardWedgeScanner(TextBox inputBox)
    {
        _inputBox = inputBox;
        _burstTimer = new System.Windows.Forms.Timer { Interval = 80 };
        _burstTimer.Tick += OnBurstTimeout;
        _inputBox.KeyPress += OnKeyPress;
    }

    private void OnKeyPress(object sender, KeyPressEventArgs e)
    {
        if (e.KeyChar == (char)Keys.Enter)
        {
            _burstTimer.Stop();
            string value = _buffer.ToString().Trim();
            _buffer.Clear();
            if (value.Length > 0)
                BarcodeScanned?.Invoke(this, value);
        }
        else
        {
            _buffer.Append(e.KeyChar);
            _burstTimer.Stop();
            _burstTimer.Start();
        }
        e.Handled = true;
    }

    private void OnBurstTimeout(object sender, EventArgs e)
    {
        _burstTimer.Stop();
        _buffer.Clear(); // incomplete burst -- discard
    }

    public void StartListening() => _inputBox.Focus();
    public void StopListening() => _inputBox.Enabled = false;
}

public class SerialPortScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly System.IO.Ports.SerialPort _port;

    public SerialPortScanner(string portName, int baudRate = 9600)
    {
        _port = new System.IO.Ports.SerialPort(portName, baudRate);
        _port.DataReceived += OnDataReceived;
    }

    private void OnDataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
    {
        string data = _port.ReadLine().Trim();
        if (data.Length > 0)
            BarcodeScanned?.Invoke(this, data);
    }

    public void StartListening() => _port.Open();
    public void StopListening() => _port.Close();
}

Imports System
Imports System.Text
Imports System.Windows.Forms
Imports System.IO.Ports

Public Interface IScannerInput
    Event BarcodeScanned As EventHandler(Of String)
    Sub StartListening()
    Sub StopListening()
End Interface

Public Class KeyboardWedgeScanner
    Implements IScannerInput

    Public Event BarcodeScanned As EventHandler(Of String) Implements IScannerInput.BarcodeScanned
    Private ReadOnly _inputBox As TextBox
    Private ReadOnly _burstTimer As Timer
    Private ReadOnly _buffer As New StringBuilder()

    Public Sub New(inputBox As TextBox)
        _inputBox = inputBox
        _burstTimer = New Timer With {.Interval = 80}
        AddHandler _burstTimer.Tick, AddressOf OnBurstTimeout
        AddHandler _inputBox.KeyPress, AddressOf OnKeyPress
    End Sub

    Private Sub OnKeyPress(sender As Object, e As KeyPressEventArgs)
        If e.KeyChar = ChrW(Keys.Enter) Then
            _burstTimer.Stop()
            Dim value As String = _buffer.ToString().Trim()
            _buffer.Clear()
            If value.Length > 0 Then
                RaiseEvent BarcodeScanned(Me, value)
            End If
        Else
            _buffer.Append(e.KeyChar)
            _burstTimer.Stop()
            _burstTimer.Start()
        End If
        e.Handled = True
    End Sub

    Private Sub OnBurstTimeout(sender As Object, e As EventArgs)
        _burstTimer.Stop()
        _buffer.Clear() ' incomplete burst -- discard
    End Sub

    Public Sub StartListening() Implements IScannerInput.StartListening
        _inputBox.Focus()
    End Sub

    Public Sub StopListening() Implements IScannerInput.StopListening
        _inputBox.Enabled = False
    End Sub
End Class

Public Class SerialPortScanner
    Implements IScannerInput

    Public Event BarcodeScanned As EventHandler(Of String) Implements IScannerInput.BarcodeScanned
    Private ReadOnly _port As SerialPort

    Public Sub New(portName As String, Optional baudRate As Integer = 9600)
        _port = New SerialPort(portName, baudRate)
        AddHandler _port.DataReceived, AddressOf OnDataReceived
    End Sub

    Private Sub OnDataReceived(sender As Object, e As SerialDataReceivedEventArgs)
        Dim data As String = _port.ReadLine().Trim()
        If data.Length > 0 Then
            RaiseEvent BarcodeScanned(Me, data)
        End If
    End Sub

    Public Sub StartListening() Implements IScannerInput.StartListening
        _port.Open()
    End Sub

    Public Sub StopListening() Implements IScannerInput.StopListening
        _port.Close()
    End Sub
End Class

Der entscheidende Punkt ist der Burst-Timer in der Tastatur-Wedge-Implementierung. Es wird bei jedem Tastendruck zurückgesetzt und nur ausgelöst, wenn keine Zeichen mehr eintreffen – das bedeutet, dass bei echten Tastaturbenutzern, die langsam tippen, die unvollständige Eingabe verworfen und nicht wie ein Barcode-Scan behandelt wird.

Wie handhabt man verschiedene Scannermarken?

In Enterprise werden häufig verschiedene Scanner von Honeywell, Zebra (ehemals Symbol/Motorola) und Datalogic auf derselben Etage eingesetzt. Jeder Anbieter hat seine eigenen Standard-Abschlusszeichen, Baudraten und Präfix-/Suffixkonventionen. Ein Konfigurationsmodell sorgt für Flexibilität Ihrer Anwendung:

public class ScannerConfiguration
{
    public string ScannerType { get; set; } = "KeyboardWedge";
    public string PortName { get; set; } = "COM3";
    public int BaudRate { get; set; } = 9600;
    public string Terminator { get; set; } = "\r\n";
    public bool EnableBeep { get; set; } = true;
    public Dictionary<string, string> BrandSettings { get; set; } = new();

    public static ScannerConfiguration GetHoneywellConfig() => new()
    {
        ScannerType = "Serial",
        BaudRate = 115200,
        BrandSettings = new Dictionary<string, string>
        {
            { "Prefix", "STX" },
            { "Suffix", "ETX" },
            { "TriggerMode", "Manual" }
        }
    };

    public static ScannerConfiguration GetZebraConfig() => new()
    {
        ScannerType = "KeyboardWedge",
        BrandSettings = new Dictionary<string, string>
        {
            { "ScanMode", "Continuous" },
            { "BeepVolume", "High" }
        }
    };
}

public class ScannerConfiguration
{
    public string ScannerType { get; set; } = "KeyboardWedge";
    public string PortName { get; set; } = "COM3";
    public int BaudRate { get; set; } = 9600;
    public string Terminator { get; set; } = "\r\n";
    public bool EnableBeep { get; set; } = true;
    public Dictionary<string, string> BrandSettings { get; set; } = new();

    public static ScannerConfiguration GetHoneywellConfig() => new()
    {
        ScannerType = "Serial",
        BaudRate = 115200,
        BrandSettings = new Dictionary<string, string>
        {
            { "Prefix", "STX" },
            { "Suffix", "ETX" },
            { "TriggerMode", "Manual" }
        }
    };

    public static ScannerConfiguration GetZebraConfig() => new()
    {
        ScannerType = "KeyboardWedge",
        BrandSettings = new Dictionary<string, string>
        {
            { "ScanMode", "Continuous" },
            { "BeepVolume", "High" }
        }
    };
}

Option Strict On



Public Class ScannerConfiguration
    Public Property ScannerType As String = "KeyboardWedge"
    Public Property PortName As String = "COM3"
    Public Property BaudRate As Integer = 9600
    Public Property Terminator As String = vbCrLf
    Public Property EnableBeep As Boolean = True
    Public Property BrandSettings As Dictionary(Of String, String) = New Dictionary(Of String, String)()

    Public Shared Function GetHoneywellConfig() As ScannerConfiguration
        Return New ScannerConfiguration() With {
            .ScannerType = "Serial",
            .BaudRate = 115200,
            .BrandSettings = New Dictionary(Of String, String) From {
                {"Prefix", "STX"},
                {"Suffix", "ETX"},
                {"TriggerMode", "Manual"}
            }
        }
    End Function

    Public Shared Function GetZebraConfig() As ScannerConfiguration
        Return New ScannerConfiguration() With {
            .ScannerType = "KeyboardWedge",
            .BrandSettings = New Dictionary(Of String, String) From {
                {"ScanMode", "Continuous"},
                {"BeepVolume", "High"}
            }
        }
    End Function
End Class

Durch das Speichern dieser Konfigurationen in einer Einstellungsdatei oder Datenbank können die Lagermitarbeiter die Scannermodelle austauschen, ohne dass eine erneute Bereitstellung erforderlich ist. Das Feld ScannerType steuert, welche IScannerInput Implementierung beim Start instanziiert wird.

Wie kann IronBarcode am schnellsten über NuGet hinzugefügt werden?

Öffnen Sie die Paketmanager-Konsole in Visual Studio und führen Sie den Befehl aus:

Install-Package IronBarCode

Install-Package IronBarCode

Alternativ können Sie die .NET -Befehlszeilenschnittstelle verwenden:

dotnet add package IronBarCode

dotnet add package IronBarCode

Beide Befehle laden die aktuelle Version von NuGet herunter und fügen den Assemblyverweis zu Ihrer Projektdatei hinzu. Die Bibliothek ist for .NET Standard 2.0 ausgelegt und funktioniert daher ohne zusätzliche Kompatibilitätsschnittstellen unter .NET Framework 4.6.2 bis .NET 10.

Nach der Installation müssen Sie Ihren Lizenzschlüssel festlegen, bevor Sie eine beliebige IronBarcode -Methode aufrufen. Für Entwicklungs- und Evaluierungszwecke ist ein kostenloser Testschlüssel auf derIronBarcode -Lizenzseite erhältlich:

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Für containerisierte Bereitstellungen arbeitet IronBarcode mit Docker unter Linux zusammen , und für Cloud-Funktionen unterstützt es AWS Lambda und Azure Functions .

Welcher Ansatz ist für die Formatverifizierung der richtige?

IronBarcode unterstützt über 30 Barcode-Symbologien, darunter Code 128 , EAN-13 , Code 39 , QR-Codes und Data Matrix . Bei USB-Scanneranwendungen wird die gescannte Zeichenkette durch das Validierungsmuster als Barcode-Bild neu codiert und sofort wieder durch den Decoder eingelesen. Dieser Roundtrip bestätigt, dass die Zeichenkette ein gültiger Wert für das angegebene Format ist:

public class BarcodeValidator
{
    public async Task<ValidationResult> ValidateAsync(string scannedText, BarcodeEncoding preferredFormat = BarcodeEncoding.Code128)
    {
        var result = new ValidationResult { RawInput = scannedText };

        try
        {
            var barcode = BarcodeWriter.CreateBarcode(scannedText, preferredFormat);
            var readResults = await BarcodeReader.ReadAsync(barcode.ToBitmap());

            if (readResults.Any())
            {
                var first = readResults.First();
                result.IsValid = true;
                result.Format = first.BarcodeType;
                result.Value = first.Value;
                result.Confidence = first.Confidence;
            }
            else
            {
                result.IsValid = false;
                result.Error = "No barcode could be decoded from the scanned input.";
            }
        }
        catch (Exception ex)
        {
            result.IsValid = false;
            result.Error = ex.Message;
        }

        return result;
    }
}

public record ValidationResult
{
    public string RawInput { get; init; } = "";
    public bool IsValid { get; set; }
    public BarcodeEncoding Format { get; set; }
    public string Value { get; set; } = "";
    public float Confidence { get; set; }
    public string Error { get; set; } = "";
}

public class BarcodeValidator
{
    public async Task<ValidationResult> ValidateAsync(string scannedText, BarcodeEncoding preferredFormat = BarcodeEncoding.Code128)
    {
        var result = new ValidationResult { RawInput = scannedText };

        try
        {
            var barcode = BarcodeWriter.CreateBarcode(scannedText, preferredFormat);
            var readResults = await BarcodeReader.ReadAsync(barcode.ToBitmap());

            if (readResults.Any())
            {
                var first = readResults.First();
                result.IsValid = true;
                result.Format = first.BarcodeType;
                result.Value = first.Value;
                result.Confidence = first.Confidence;
            }
            else
            {
                result.IsValid = false;
                result.Error = "No barcode could be decoded from the scanned input.";
            }
        }
        catch (Exception ex)
        {
            result.IsValid = false;
            result.Error = ex.Message;
        }

        return result;
    }
}

public record ValidationResult
{
    public string RawInput { get; init; } = "";
    public bool IsValid { get; set; }
    public BarcodeEncoding Format { get; set; }
    public string Value { get; set; } = "";
    public float Confidence { get; set; }
    public string Error { get; set; } = "";
}

Imports System
Imports System.Linq
Imports System.Threading.Tasks

Public Class BarcodeValidator
    Public Async Function ValidateAsync(scannedText As String, Optional preferredFormat As BarcodeEncoding = BarcodeEncoding.Code128) As Task(Of ValidationResult)
        Dim result As New ValidationResult With {.RawInput = scannedText}

        Try
            Dim barcode = BarcodeWriter.CreateBarcode(scannedText, preferredFormat)
            Dim readResults = Await BarcodeReader.ReadAsync(barcode.ToBitmap())

            If readResults.Any() Then
                Dim first = readResults.First()
                result.IsValid = True
                result.Format = first.BarcodeType
                result.Value = first.Value
                result.Confidence = first.Confidence
            Else
                result.IsValid = False
                result.Error = "No barcode could be decoded from the scanned input."
            End If
        Catch ex As Exception
            result.IsValid = False
            result.Error = ex.Message
        End Try

        Return result
    End Function
End Class

Public Class ValidationResult
    Public Property RawInput As String = ""
    Public Property IsValid As Boolean
    Public Property Format As BarcodeEncoding
    Public Property Value As String = ""
    Public Property Confidence As Single
    Public Property Error As String = ""
End Class

Bei GS1-128-Barcodes , die in Supply-Chain-Anwendungen verwendet werden, enthält die gescannte Zeichenkette Anwendungsidentifikatorpräfixe in Klammern, wie z. B. (01) für GTIN und (17) für das Ablaufdatum. IronBarcode analysiert diese Anwendungsbezeichner automatisch, wenn Sie BarcodeEncoding.GS1_128 angeben.

Welche EAN-13-Prüfsummenlogik sollten Entwickler implementieren?

Kassensysteme im Einzelhandel müssen häufig die Prüfziffern der EAN-13-Nummer separat verifizieren, bevor der Wert an eine Preisabfrage übergeben wird. Die Luhn-Prüfsumme für EAN-13 verwendet abwechselnd die Gewichtungen 1 und 3 für die ersten 12 Ziffern.

public static bool ValidateEan13Checksum(string value)
{
    if (value.Length != 13 || !value.All(char.IsDigit))
        return false;

    int sum = 0;
    for (int i = 0; i < 12; i++)
    {
        int digit = value[i] - '0';
        sum += (i % 2 == 0) ? digit : digit * 3;
    }

    int expectedCheck = (10 - (sum % 10)) % 10;
    return expectedCheck == (value[12] - '0');
}

public static bool ValidateEan13Checksum(string value)
{
    if (value.Length != 13 || !value.All(char.IsDigit))
        return false;

    int sum = 0;
    for (int i = 0; i < 12; i++)
    {
        int digit = value[i] - '0';
        sum += (i % 2 == 0) ? digit : digit * 3;
    }

    int expectedCheck = (10 - (sum % 10)) % 10;
    return expectedCheck == (value[12] - '0');
}

Public Shared Function ValidateEan13Checksum(value As String) As Boolean
    If value.Length <> 13 OrElse Not value.All(AddressOf Char.IsDigit) Then
        Return False
    End If

    Dim sum As Integer = 0
    For i As Integer = 0 To 11
        Dim digit As Integer = AscW(value(i)) - AscW("0"c)
        sum += If(i Mod 2 = 0, digit, digit * 3)
    Next

    Dim expectedCheck As Integer = (10 - (sum Mod 10)) Mod 10
    Return expectedCheck = (AscW(value(12)) - AscW("0"c))
End Function

Diese rein logische Prüfung wird vor der Kodierung durchgeführt, um den Aufwand der Bildgenerierung für jeden Scan in einer Einzelhandelsumgebung mit hohem Durchsatz zu vermeiden. Gemäß der GS1-Spezifikation ist der Prüfziffernalgorithmus für UPC-A (12 Ziffern) identisch, wenn man die führende Null weglässt.

Wann sollte eine Anwendung nach einem Scan neue Barcodes erstellen?

Ein gängiges Muster bei der Warenannahme im Lager ist der Arbeitsablauf "Scannen und Neuetikettieren": Ein eingehender Artikel trägt einen Lieferanten-Barcode (oft EAN-13 oder ITF-14), und das Lagerverwaltungssystem muss ein internes Code-128-Etikett mit eigenen Standort- und Chargencodes drucken. Die Generierungsfunktionen von IronBarcode erledigen dies in wenigen Zeilen:

public class InventoryLabelGenerator
{
    private readonly string _outputDirectory;

    public InventoryLabelGenerator(string outputDirectory)
    {
        _outputDirectory = outputDirectory;
        Directory.CreateDirectory(_outputDirectory);
    }

    public async Task<string> GenerateLabelAsync(string internalCode, string locationCode)
    {
        string fullCode = $"{internalCode}|{locationCode}|{DateTime.UtcNow:yyyyMMdd}";

        // Primary Code 128 label for scanners
        var linearBarcode = BarcodeWriter.CreateBarcode(fullCode, BarcodeEncoding.Code128);
        linearBarcode.ResizeTo(500, 140);
        linearBarcode.SetMargins(12);
        linearBarcode.AddAnnotationTextAboveBarcode(fullCode);
        linearBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black);

        // QR code companion for mobile apps
        var qrCode = BarcodeWriter.CreateQrCode(fullCode);
        qrCode.ResizeTo(200, 200);
        qrCode.SetMargins(8);

        string timestamp = DateTime.UtcNow.ToString("yyyyMMddHHmmss");
        string pngPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.png");
        string pdfPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.pdf");

        await Task.Run(() =>
        {
            linearBarcode.SaveAsPng(pngPath);
            linearBarcode.SaveAsPdf(pdfPath);
        });

        return pngPath;
    }
}

public class InventoryLabelGenerator
{
    private readonly string _outputDirectory;

    public InventoryLabelGenerator(string outputDirectory)
    {
        _outputDirectory = outputDirectory;
        Directory.CreateDirectory(_outputDirectory);
    }

    public async Task<string> GenerateLabelAsync(string internalCode, string locationCode)
    {
        string fullCode = $"{internalCode}|{locationCode}|{DateTime.UtcNow:yyyyMMdd}";

        // Primary Code 128 label for scanners
        var linearBarcode = BarcodeWriter.CreateBarcode(fullCode, BarcodeEncoding.Code128);
        linearBarcode.ResizeTo(500, 140);
        linearBarcode.SetMargins(12);
        linearBarcode.AddAnnotationTextAboveBarcode(fullCode);
        linearBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black);

        // QR code companion for mobile apps
        var qrCode = BarcodeWriter.CreateQrCode(fullCode);
        qrCode.ResizeTo(200, 200);
        qrCode.SetMargins(8);

        string timestamp = DateTime.UtcNow.ToString("yyyyMMddHHmmss");
        string pngPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.png");
        string pdfPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.pdf");

        await Task.Run(() =>
        {
            linearBarcode.SaveAsPng(pngPath);
            linearBarcode.SaveAsPdf(pdfPath);
        });

        return pngPath;
    }
}

Imports System.IO
Imports System.Threading.Tasks

Public Class InventoryLabelGenerator
    Private ReadOnly _outputDirectory As String

    Public Sub New(outputDirectory As String)
        _outputDirectory = outputDirectory
        Directory.CreateDirectory(_outputDirectory)
    End Sub

    Public Async Function GenerateLabelAsync(internalCode As String, locationCode As String) As Task(Of String)
        Dim fullCode As String = $"{internalCode}|{locationCode}|{DateTime.UtcNow:yyyyMMdd}"

        ' Primary Code 128 label for scanners
        Dim linearBarcode = BarcodeWriter.CreateBarcode(fullCode, BarcodeEncoding.Code128)
        linearBarcode.ResizeTo(500, 140)
        linearBarcode.SetMargins(12)
        linearBarcode.AddAnnotationTextAboveBarcode(fullCode)
        linearBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black)

        ' QR code companion for mobile apps
        Dim qrCode = BarcodeWriter.CreateQrCode(fullCode)
        qrCode.ResizeTo(200, 200)
        qrCode.SetMargins(8)

        Dim timestamp As String = DateTime.UtcNow.ToString("yyyyMMddHHmmss")
        Dim pngPath As String = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.png")
        Dim pdfPath As String = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.pdf")

        Await Task.Run(Sub()
                           linearBarcode.SaveAsPng(pngPath)
                           linearBarcode.SaveAsPdf(pdfPath)
                       End Sub)

        Return pngPath
    End Function
End Class

Das Speichern als PDF ist besonders nützlich für Etikettendrucker, die PDF-Eingaben über eine Netzwerkfreigabe akzeptieren. Sie können auch als SVG exportieren, um qualitativ hochwertige Thermodrucketiketten auszugeben, oder als Byte-Stream exportieren, um ihn direkt an eine Etikettendrucker-API zu senden.

IronBarcode unterstützt umfangreiche Stilanpassungen, darunter benutzerdefinierte Farben, Randanpassungen , lesbare Textüberlagerungen und, bei QR-Codes, die Einbettung von Logos für markengekennzeichnete mobile Etiketten.

![Windows Forms-Anwendungsoberfläche, die die Dual-Barcode-Generierungsfunktionen von IronBarcode demonstriert. Die Benutzeroberfläche zeigt die erfolgreiche Generierung sowohl eines linearen Code-128-Barcodes als auch eines QR-Codes für die Inventarnummer "INV-20250917-helloworld". Über das Eingabefeld oben können Benutzer benutzerdefinierte Inventarcodes eingeben. Mit der Schaltfläche "Generieren" lassen sich die Barcodes erstellen. Die Erfolgsmeldung "Element erfolgreich verarbeitet – Etiketten generiert" bestätigt den Abschluss des Vorgangs. Der Code-128-Barcode ist als primäres Format für die Bestandsverfolgung gekennzeichnet, während der darunter stehende QR-Code als mobile Alternative dient. Die Anwendung verwendet einen Professional grauen Hintergrund mit klarer visueller Hierarchie und demonstriert, wie IronBarcode Entwicklern die Erstellung von Barcode-Generierungssystemen für verschiedene Formate zur umfassenden Bestandsverwaltung ermöglicht.

Wie sieht eine Implementierung auf Basis einer Produktionswarteschlange aus?

Bei Anwendungen, die Dutzende von Scans pro Minute verarbeiten, wird ein einfacher synchroner Handler im UI-Thread zum Flaschenhals. Das unten beschriebene Muster entkoppelt die Scan-Erfassung von der Verarbeitung mithilfe eines ConcurrentQueue<t> und einer Hintergrundverarbeitungsschleife. Die asynchrone API von IronBarcode übernimmt die Validierung, ohne die Benutzeroberfläche zu blockieren:

using IronBarCode;
using System.Collections.Concurrent;

public partial class HighVolumeScanner : Form
{
    private readonly ConcurrentQueue<(string Data, DateTime Timestamp)> _scanQueue = new();
    private readonly SemaphoreSlim _semaphore;
    private readonly CancellationTokenSource _cts = new();
    private IScannerInput _scanner;

    public HighVolumeScanner()
    {
        InitializeComponent();
        IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
        _semaphore = new SemaphoreSlim(Environment.ProcessorCount);
        InitializeScanner();
        _ = RunProcessingLoopAsync();
    }

    private void InitializeScanner()
    {
        _scanner = System.IO.Ports.SerialPort.GetPortNames().Any()
            ? new SerialPortScanner("COM3", 115200)
            : new KeyboardWedgeScanner(txtScannerInput);

        _scanner.BarcodeScanned += (_, barcode) =>
            _scanQueue.Enqueue((barcode, DateTime.UtcNow));

        _scanner.StartListening();
    }

    private async Task RunProcessingLoopAsync()
    {
        while (!_cts.Token.IsCancellationRequested)
        {
            if (_scanQueue.TryDequeue(out var scan))
            {
                await _semaphore.WaitAsync(_cts.Token);
                _ = Task.Run(async () =>
                {
                    try { await ProcessScanAsync(scan.Data, scan.Timestamp); }
                    finally { _semaphore.Release(); }
                }, _cts.Token);
            }
            else
            {
                await Task.Delay(10, _cts.Token);
            }
        }
    }

    private async Task ProcessScanAsync(string rawData, DateTime scanTime)
    {
        var options = new BarcodeReaderOptions
        {
            Speed = ReadingSpeed.Balanced,
            ExpectMultipleBarcodes = false,
            ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode,
            MaxParallelThreads = 1
        };

        var testBarcode = BarcodeWriter.CreateBarcode(rawData, BarcodeEncoding.Code128);
        var results = await BarcodeReader.ReadAsync(testBarcode.ToBitmap(), options);

        if (results.Any())
        {
            var item = results.First();
            BeginInvoke(() => UpdateInventoryDisplay(item.Value, scanTime));
        }
        else
        {
            BeginInvoke(() => LogRejectedScan(rawData, scanTime));
        }
    }

    protected override void OnFormClosing(FormClosingEventArgs e)
    {
        _cts.Cancel();
        _scanner.StopListening();
        base.OnFormClosing(e);
    }
}

using IronBarCode;
using System.Collections.Concurrent;

public partial class HighVolumeScanner : Form
{
    private readonly ConcurrentQueue<(string Data, DateTime Timestamp)> _scanQueue = new();
    private readonly SemaphoreSlim _semaphore;
    private readonly CancellationTokenSource _cts = new();
    private IScannerInput _scanner;

    public HighVolumeScanner()
    {
        InitializeComponent();
        IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
        _semaphore = new SemaphoreSlim(Environment.ProcessorCount);
        InitializeScanner();
        _ = RunProcessingLoopAsync();
    }

    private void InitializeScanner()
    {
        _scanner = System.IO.Ports.SerialPort.GetPortNames().Any()
            ? new SerialPortScanner("COM3", 115200)
            : new KeyboardWedgeScanner(txtScannerInput);

        _scanner.BarcodeScanned += (_, barcode) =>
            _scanQueue.Enqueue((barcode, DateTime.UtcNow));

        _scanner.StartListening();
    }

    private async Task RunProcessingLoopAsync()
    {
        while (!_cts.Token.IsCancellationRequested)
        {
            if (_scanQueue.TryDequeue(out var scan))
            {
                await _semaphore.WaitAsync(_cts.Token);
                _ = Task.Run(async () =>
                {
                    try { await ProcessScanAsync(scan.Data, scan.Timestamp); }
                    finally { _semaphore.Release(); }
                }, _cts.Token);
            }
            else
            {
                await Task.Delay(10, _cts.Token);
            }
        }
    }

    private async Task ProcessScanAsync(string rawData, DateTime scanTime)
    {
        var options = new BarcodeReaderOptions
        {
            Speed = ReadingSpeed.Balanced,
            ExpectMultipleBarcodes = false,
            ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode,
            MaxParallelThreads = 1
        };

        var testBarcode = BarcodeWriter.CreateBarcode(rawData, BarcodeEncoding.Code128);
        var results = await BarcodeReader.ReadAsync(testBarcode.ToBitmap(), options);

        if (results.Any())
        {
            var item = results.First();
            BeginInvoke(() => UpdateInventoryDisplay(item.Value, scanTime));
        }
        else
        {
            BeginInvoke(() => LogRejectedScan(rawData, scanTime));
        }
    }

    protected override void OnFormClosing(FormClosingEventArgs e)
    {
        _cts.Cancel();
        _scanner.StopListening();
        base.OnFormClosing(e);
    }
}

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading
Imports System.Threading.Tasks

Public Partial Class HighVolumeScanner
    Inherits Form

    Private ReadOnly _scanQueue As New ConcurrentQueue(Of (Data As String, Timestamp As DateTime))()
    Private ReadOnly _semaphore As SemaphoreSlim
    Private ReadOnly _cts As New CancellationTokenSource()
    Private _scanner As IScannerInput

    Public Sub New()
        InitializeComponent()
        IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"
        _semaphore = New SemaphoreSlim(Environment.ProcessorCount)
        InitializeScanner()
        _ = RunProcessingLoopAsync()
    End Sub

    Private Sub InitializeScanner()
        _scanner = If(System.IO.Ports.SerialPort.GetPortNames().Any(),
                      New SerialPortScanner("COM3", 115200),
                      New KeyboardWedgeScanner(txtScannerInput))

        AddHandler _scanner.BarcodeScanned, Sub(_, barcode)
                                                _scanQueue.Enqueue((barcode, DateTime.UtcNow))
                                            End Sub

        _scanner.StartListening()
    End Sub

    Private Async Function RunProcessingLoopAsync() As Task
        While Not _cts.Token.IsCancellationRequested
            Dim scan As (Data As String, Timestamp As DateTime)
            If _scanQueue.TryDequeue(scan) Then
                Await _semaphore.WaitAsync(_cts.Token)
                _ = Task.Run(Async Function()
                                 Try
                                     Await ProcessScanAsync(scan.Data, scan.Timestamp)
                                 Finally
                                     _semaphore.Release()
                                 End Try
                             End Function, _cts.Token)
            Else
                Await Task.Delay(10, _cts.Token)
            End If
        End While
    End Function

    Private Async Function ProcessScanAsync(rawData As String, scanTime As DateTime) As Task
        Dim options As New BarcodeReaderOptions With {
            .Speed = ReadingSpeed.Balanced,
            .ExpectMultipleBarcodes = False,
            .ExpectBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.QRCode,
            .MaxParallelThreads = 1
        }

        Dim testBarcode = BarcodeWriter.CreateBarcode(rawData, BarcodeEncoding.Code128)
        Dim results = Await BarcodeReader.ReadAsync(testBarcode.ToBitmap(), options)

        If results.Any() Then
            Dim item = results.First()
            BeginInvoke(Sub() UpdateInventoryDisplay(item.Value, scanTime))
        Else
            BeginInvoke(Sub() LogRejectedScan(rawData, scanTime))
        End If
    End Function

    Protected Overrides Sub OnFormClosing(e As FormClosingEventArgs)
        _cts.Cancel()
        _scanner.StopListening()
        MyBase.OnFormClosing(e)
    End Sub
End Class

Der SemaphoreSlim begrenzt die Anzahl gleichzeitiger Validierungsaufgaben auf die Anzahl logischer Prozessoren und verhindert so die Entstehung unkontrollierter Threads während Burst-Scanning-Ereignissen. Die BeginInvoke-Aufrufe führen UI-Aktualisierungen sicher zurück zum Hauptthread.

Wie optimiert man die Leistung für unterschiedliche Scanvolumina?

Die Eigenschaft BarcodeReaderOptions.Speed akzeptiert ReadingSpeed.Schneller, ReadingSpeed.Ausgewogen und ReadingSpeed.Ausführlich. Bei USB-Scannereingaben, bei denen der Zeichenkettenwert bereits bekannt ist, ist Ausgewogen geeignet – der Decoder muss nur das Format bestätigen, nicht aber einen Barcode in einem Bild finden. Laut der Dokumentation zur Lesegeschwindigkeit von IronBarcode werden im Modus Schneller einige Verzerrungskorrekturalgorithmen übersprungen, was für eine saubere Scannerausgabe unbedenklich ist, aber dazu führen kann, dass beschädigte Barcodes in bildbasierten Szenarien nicht erkannt werden.

Die folgende Tabelle fasst zusammen, wann welcher Geschwindigkeitsmodus verwendet werden sollte:

Für Anwendungen, die neben USB-Scannereingaben auch Bilder oder PDFs verarbeiten, kann IronBarcode Barcodes aus PDF-Dokumenten und mehrseitigen TIFF-Dateien über dieselbe API-Schnittstelle IronBarcode .

Welche Fehlerszenarien sollten Entwickler erwarten?

USB-Scanner-Anwendungen versagen auf vorhersehbare Weise. Die häufigsten Probleme und ihre Abhilfemaßnahmen sind:

Scannerverbindung unterbrochen - Wenn ein USB-Scanner ausgesteckt wird, verliert das Tastatur-Wedge-TextBox seine virtuelle Tastatur. Die einfachste Abhilfemaßnahme ist ein periodischer Timer, der _inputBox.Focused überprüft und ihn neu fokussiert, wenn der Scanner noch in der Liste der verbundenen HID-Geräte aufgeführt ist. Bei seriellen Scannern erkennt SerialPort.GetPortNames() eine erneute Verbindung.

Mehrdeutige Barcode-Formate – Einige Produkte tragen Barcodes, die in mehreren Symbologien gültig sind. Eine 12-stellige Zeichenkette ist beispielsweise ein gültiger UPC-A-Code und gleichzeitig ein gültiger Code 128. Die Angabe von ExpectBarcodeTypes in BarcodeReaderOptions beschränkt den Decoder auf die von Ihnen erwarteten Formate und beseitigt Mehrdeutigkeiten. Der IronBarcode Leitfaden zur Fehlerbehebung enthält formatspezifische Erkennungstipps.

Ungültige Formatausnahmen -- Wenn BarcodeWriter.CreateBarcode eine Zeichenkette empfängt, die gegen die Regeln der ausgewählten Kodierung verstößt (z. B. alphabetische Zeichen in einem nur numerischen EAN-13-Feld), wird eine IronBarCode.Exceptions.InvalidBarcodeException-Ausnahme ausgelöst. Durch das Einbetten des Aufrufs in einen try-catch-Block und den Rückgriff auf einen Validierungspfad, der nur Zeichenketten zulässt, kann die Anwendung weiterlaufen.

Kollisionen der Tastenanschlagzeiten – In Umgebungen, in denen die Bediener auch manuell in dasselbe Textfeld tippen, ist der zuvor beschriebene Burst-Timer-Ansatz die primäre Verteidigungsmethode. Eine weitere Schutzmaßnahme ist die Mindestlänge: Die meisten realen Barcodes bestehen aus mindestens 8 Zeichen, daher können kürzere Zeichenketten als Tastatureingabe behandelt werden.

Die Microsoft .NET -Dokumentation zu System.IO.Ports.SerialPort ist hilfreich bei der Fehlersuche in Bezug auf die serielle Scannerverbindung, insbesondere im Zusammenhang mit den Einstellungen ReadTimeout und WriteTimeout. Zur Einhaltung gesetzlicher Vorschriften im Einzelhandel definieren die GS1 General Specifications gültige Wertebereiche für jede Anwendungskennung.

Wie lässt sich die Anwendung auf mobile und Web-Plattformen erweitern?

Das oben gezeigte Scanner-Schnittstellenmuster -- IScannerInput mit BarcodeScanned Ereignis -- abstrahiert die Hardware von der Verarbeitungslogik. Durch den Austausch der Implementierungen kann derselbe Validierungs- und Generierungscode auf verschiedenen Plattformen ausgeführt werden:

• .NET MAUI bietet eine kamerabasierte Scanner-Implementierung für Android- und iOS-Tablets, die als mobile Empfangsstationen verwendet werden.
• Blazor Server unterstützt browserbasiertes Scannen mit JavaScript Kamerazugriff, der in dasselbe BarcodeScanned Ereignis eingespeist wird.
• Native Implementierungen für Android und iOS bieten mobilen Entwicklern die Möglichkeit, mit der Kamera zu scannen, wobei im Backend derselbe IronBarcode -Decoder verwendet wird.

Bei Cloud-nativen Architekturen können die Validierungs- und Labelgenerierungsschritte als Azure Functions ausgeführt werden, die durch Warteschlangennachrichten ausgelöst werden, wobei die Desktop-Anwendung lediglich als Eingabegateway für den Scanner fungiert. Diese Trennung ist besonders dann nützlich, wenn die Logik für den Etikettendruck im Rahmen von Compliance-Audits zentralisiert werden muss.