Mehrere BarCodes gleichzeitig lesen in C#

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Aktualisiert: 2. August 2026

IronBarcode ermöglicht das gleichzeitige Lesen mehrerer Barcodes aus Bildern und PDFs durch das Setzen von ExpectMultipleBarcodes = true, was die Datenverarbeitung für Logistik-, Einzelhandels- und Bestandsverwaltungsanwendungen vereinfacht. Egal, ob Sie Lagersysteme, Einzelhandels-PoS-Anwendungen oder Dokumentenverarbeitungslösungen entwickeln, bietet die fortschrittlichen Lesefähigkeiten von IronBarcode die Zuverlässigkeit und Leistung, die Sie benötigen.

Schnellstart: Einfach alle Barcodes aus einem Bild lesen

Dieses Beispiel zeigt, wie schnell Sie IronBarcode verwenden können, um ein Bild nach allen darin enthaltenen Barcodes zu scannen. Legen Sie einfach ExpectMultipleBarcodes = true zusammen mit den gewünschten Barcode-Typen fest - kein Boilerplate, kein Aufwand.

  1. 1Installieren Sie IronBarcode mit NuGet Package Manager

    PM > Install-Package BarCode

  2. 2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { ExpectMultipleBarcodes = true, ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.AllOneDimensional });
  3. 3Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronBarcode in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden
    arrow pointer

Wie lese ich mehrere BarCodes aus einem Bild?

Standardmäßig scannt IronBarcode kontinuierlich ein Dokument, um mehrere Barcodes zu lesen. Es gibt jedoch Fälle, in denen nur ein BarCode-Wert zurückgegeben wird, auch wenn mehrere BarCodes vorhanden sind. Passen Sie daher die Einstellungen an, um das Lesen mehrerer BarCodes zu ermöglichen, wie unten gezeigt. Die Eigenschaft ExpectMultipleBarcodes existiert sowohl in den Klassen BarcodeReaderOptions als auch PdfBarcodeReaderOptions, sodass Sie sie für das Lesen von Barcodes in Bildern und PDF-Dokumenten verwenden können.

Drei Beispiel-Barcodes mit den Bezeichnungen A, B und C, die verschiedene Strichmuster für die Demonstration des Lesens mehrerer Barcodes zeigen
using IronBarCode;
using System;

// Set the option to read multiple barcodes
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

Das Setzen von ExpectMultipleBarcodes auf wahr ermöglicht es IronBarcode, das gesamte Dokument nach mehreren Barcodes zu scannen und sie in der Variable BarcodeResults zu speichern. Mit einer foreach-Schleife können Sie einfach auf alle Barcode-Werte zugreifen und sie auf der Konsole ausgeben.

Erweiterte Szenarien zum Lesen mehrerer BarCodes

Wenn Sie mit mehreren BarCodes arbeiten, können Sie auf Szenarien stoßen, die eine zusätzliche Konfiguration erfordern. Hier ist ein umfassendes Beispiel, das zeigt, wie man mehrere Barcodes mit unterschiedlichen Formaten aus einem komplexen Dokument liest:

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read barcodes from the image
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

In diesem fortgeschrittenen Beispiel werden mehrere wichtige Funktionen vorgestellt:

Wie kann ich einen einzelnen BarCode lesen, um die Leistung zu verbessern?

IronBarcode liest sowohl einzelne als auch mehrere Barcodes in Bildern oder PDFs. Standardmäßig scannt die Engine das gesamte Dokument, auch wenn nur ein Barcode vorhanden ist. Für eine erhöhte Leistung beim Lesen eines einzelnen Barcodes stellen Sie ExpectMultipleBarcodes auf falsch ein. Dadurch wird verhindert, dass die Engine nach der Erkennung des ersten Barcodes das gesamte Dokument scannt, was zu einer schnelleren Abfrage von Barcodes führt. Der folgende Code veranschaulicht diesen Ansatz.

Drei identische Beispiel-Barcodes mit den Bezeichnungen A, B und C zur Demonstration des Barcode-Lesens
using IronBarCode;
using System;

// Set the option to read single barcode
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}

In diesem Beispiel haben wir dasselbe Bild wie zuvor mit mehreren Barcodes verwendet, aber ExpectMultipleBarcodes auf falsch gesetzt. Infolgedessen wird nur der erste Barcode-Wert zurückgegeben, und der Scanvorgang stoppt, sobald der erste Barcode erfasst wird.

Optimierung des Lesens einzelner BarCodes mit Crop-Regionen

Für noch bessere Leistung beim Lesen einzelner Barcodes kombinieren Sie die Einstellung ExpectMultipleBarcodes = false mit Spezifikationen des Zuschneidungsbereichs. Diese Technik ist besonders nützlich, wenn Sie die ungefähre Position Ihres Barcodes kennen:

using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Linq;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
}

Wie viel schneller ist das Lesen eines einzelnen Barcodes?

Das Setzen von ExpectMultipleBarcodes = false verbessert die Effizienz beim Lesen einzelner Barcodes erheblich. Der Leistungsgewinn ist besonders bemerkbar bei der Arbeit mit hochauflösenden Bildern oder bei der Implementierung von asynchronem Barcode-Lesen in Anwendungen mit hohem Durchsatz.

Das Setzen von ExpectMultipleBarcodes = false ermöglicht es der Engine, nach Erkennung des ersten Barcodes zu stoppen, anstatt das gesamte Dokument zu scannen, was die Lesezeit für Workloads mit einem einzigen Barcode deutlich reduzieren kann. Der tatsächliche Leistungsgewinn variiert je nach:

  • Bildauflösung und Komplexität
  • Anzahl der im Bild vorhandenen BarCodes
  • Ausgewählte BarCode-Formate
  • Angewandte Bildfilter
  • Hardware-Spezifikationen

Best Practices für das Lesen mehrerer BarCodes

Beachten Sie bei der Implementierung des Lesens mehrerer Barcodes in Produktionsanwendungen die folgenden Best Practices:

  1. Erwarten Sie bestimmte Barcode-Typen: Anstatt BarcodeEncoding.All zu verwenden, geben Sie nur die Formate an, die Sie erwarten. Dies verbessert die Leistung erheblich.
  2. Verwenden Sie geeignete Bildformate: Für beste Ergebnisse verwenden Sie hochkontrastreiche Bilder. Erfahren Sie mehr über das Erstellen optimaler Barcode-Bilder.
  3. Behandeln Sie unvollkommene Barcodes: Barcodes aus der realen Welt können beschädigt oder schlecht gedruckt sein. Verwenden Sie Bildkorrekturtechniken, um die Erfolgsrate beim Lesen zu verbessern.
  4. Stream-Verarbeitung: Für große Mengen ziehen Sie das Lesen aus Streams in Betracht, um den Speicherverbrauch zu optimieren.
  5. Fehlerbehandlung: Implementieren Sie immer eine ordnungsgemäße Fehlerbehandlung für Szenarien, in denen Barcodes nicht gelesen werden können:
try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        ExpectMultipleBarcodes = true 
    });
    
    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

Durch die Befolgung dieser Praktiken und die Nutzung der umfassenden Funktionen von IronBarcode können Sie zuverlässige Anwendungen entwickeln, die mehrere Barcode-Leseszenarien in verschiedenen Branchen und Anwendungsfällen effizient bearbeiten.

Häufig gestellte Fragen

Wie aktiviere ich das Scannen mehrerer Barcodes in IronBarcode?

Um das Scannen mehrerer Barcodes in IronBarcode zu aktivieren, setzen Sie die Eigenschaft 'ExpectMultipleBarcodes' auf true in den Klassen BarcodeReaderOptions oder PdfBarcodeReaderOptions.

Welchen Zweck erfüllt die Eigenschaft ExpectMultipleBarcodes in IronBarcode?

Die Eigenschaft 'ExpectMultipleBarcodes' ermöglicht es IronBarcode, mehrere Barcodes aus einem Bild oder PDF gleichzeitig zu lesen, was die Datenextraktion in Logistik- und Einzelhandelsanwendungen optimiert.

Kann IronBarcode sowohl 1D- als auch 2D-Barcodes lesen?

Ja, IronBarcode kann sowohl 1D- als auch 2D-Barcodes lesen. Sie können die erwarteten Barcode-Typen angeben, indem Sie die Eigenschaft 'ExpectBarcodeTypes' in den BarcodeReaderOptions konfigurieren.

Wie erhöhe ich die Leistung beim Lesen nur eines Barcodes mit IronBarcode?

Um die Leistung beim Lesen eines einzelnen Barcodes zu steigern, setzen Sie 'ExpectMultipleBarcodes' in den BarcodeReaderOptions auf false. Dies stoppt den Scan-Prozess nach dem Erkennen des ersten Barcodes.

Welche Konfigurationen stehen für das Lesen mehrerer Barcodes mit unterschiedlichen Formaten zur Verfügung?

IronBarcode bietet erweiterte Optionen, wie das Kombinieren verschiedener Barcode-Decode-Typen, das Anwenden von Bildkorrekturfiltern und die Anpassung der Lesegeschwindigkeit zur Handhabung mehrerer Barcode-Formate.

Wie kann Bildkorrektur das Barcode-Lesen in IronBarcode verbessern?

Durch das Anwenden von Bildkorrekturfiltern wie dem SharpenFilter und ContrastFilter kann die Lesegenauigkeit von Barcodes verbessert werden, indem sie schlechte Bildqualität oder beschädigte Barcodes ausgleicht.

Welche Strategien werden für die optimale Barcode-Leseleistung empfohlen?

Für optimale Leistung spezifizieren Sie erwartete Barcode-Typen, verwenden Sie kontrastreiche Bilder, implementieren Sie Bildkorrekturtechniken, lesen Sie aus Streams für große Mengen und integrieren Sie Fehlerbehandlung.

Wie kann ich Fehler beim Lesen von Barcodes mit IronBarcode behandeln?

Implementieren Sie eine ordnungsgemäße Fehlerbehandlung mit try-catch-Blöcken, um Szenarien zu verwalten, in denen Barcodes nicht gelesen werden können, und protokollieren Sie Fehler zur Fehlersuche, falls erforderlich.

Wird die Stream-Verarbeitung in IronBarcode für große Barcode-Mengen unterstützt?

Ja, IronBarcode unterstützt das Lesen von Barcodes aus Streams, was besonders nützlich ist zur Optimierung des Speicherverbrauchs in Anwendungen mit hohem Durchsatz oder bei der Verarbeitung großer Mengen.

Bereit loszulegen?

NuGet-Downloads 2,564,559Version:2026.11gerade veröffentlicht