Die Anforderung an die Typenspezifikation

Spire.Barcodes BarcodeScanner.Scan() hat keine Überladung, die nur einen Dateipfad akzeptiert. Jeder Lesevorgang erfordert, dass der aufrufende Code das Barcode-Format im Voraus deklariert. Für Workflows mit nur einem Format ist dies praktikabel, aber bei der Verarbeitung von Dokumenten in verschiedenen Formaten führt es zu einer potenziellen Endlosschleife:

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

Jeder dem Kandidatenarray hinzugefügte Typ ist ein zusätzlicher Scan-Durchlauf. Jedes Format, das in der Liste fehlt, wird stillschweigend ignoriert. Der Entwickler ist verantwortlich für die Pflege eines vollständigen Typeninventars und für erneute Tests, sobald ein neues Format in den Arbeitsablauf aufgenommen wird.

Detaillierter Funktionsvergleich

Spire.Barcode-Ansatz

Spire.Barcodes BarcodeScanner.Scan() erfordert einen BarCodeType-Parameter bei jedem Aufruf. Der Aufruf mit nur einem Datentyp ist dann angebracht, wenn das Format bekannt und garantiert ist:

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

Wenn das Format nicht im Voraus bekannt ist, bleibt nur die Möglichkeit, die Kandidatentypen zu durchlaufen. Jeder Durchlauf entspricht einem vollständigen Scan, und jedes Format, das nicht in der Liste enthalten ist, wird stillschweigend übersehen. Das Ergebnis ist ein string[], der keinerlei Typinformationen trägt, so dass das nachfolgende Routing basierend auf dem Format zusätzliche Zustandsverwaltung durch den Aufrufer erfordert.

IronBarcode Ansatz

IronBarcodes BarcodeReader.Read() erfordert keinen Typ-Parameter. Die Bibliothek erkennt das Format automatisch in einem einzigen Durchlauf über alle unterstützten Symbologien hinweg. Das Auslesen von Barcodes aus Bildern erfolgt durch einen einzigen Methodenaufruf, unabhängig davon, wie viele verschiedene Formate die Quelle enthalten mag:

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Jedes Ergebnisobjekt enthält Format, Value und Positionsmetadaten. Das Downstream-Routing auf Basis des Formats erfordert keinen zusätzlichen Status – der Typ ist im Ergebnis selbst vorhanden.

Spire.Barcode Gratis-Version

FreeSpire.Barcode fügt den generierten Barcode-Bildern ein großes Bewertungswasserzeichen hinzu. Das Wasserzeichen überdeckt den Barcode auf eine Weise, die ihn für den Produktionsprozess ungeeignet macht und eine sinnvolle Bewertung der Erzeugungsqualität verhindert. Die Scanleistung ist in der kostenlosen Version absichtlich reduziert, was bedeutet, dass die während der Evaluierung durchgeführten Durchsatzmessungen nicht die Leistung der kommerziellen Spire.Barcode-Version widerspiegeln. Für das kostenlose Paket ist außerdem ein Registrierungsschlüssel von E-iceblue erforderlich, bevor Warnmeldungen während der Ausführung unterdrückt werden. Die im kostenlosen Tarif verfügbaren Symbole stellen eine Teilmenge des kommerziellen Angebots dar. Diese Einschränkungen bedeuten insgesamt, dass eine auf FreeSpire.Barcode basierende Evaluierung nicht genau widerspiegelt, was das kommerzielle Produkt bietet.

IronBarcode Testmodus

Die Testversion von IronBarcode ist das lizenzierte Paket, das ohne Lizenzschlüssel verwendet wird. Das Lesen erfolgt in voller Geschwindigkeit mit vollständiger Symbolunterstützung und ohne Verhaltensbeschränkungen. Die Optionen für Lesegeschwindigkeit und Lesegenauigkeit verhalten sich im Test- und Lizenzmodus identisch. Im Testmodus generierte Barcodes enthalten ein kleines Wasserzeichen am Bildrand; Es verdeckt den Barcode selbst nicht. Das bei einer IronBarcode -Evaluierung gemessene Verhalten entspricht dem Verhalten, das in der Produktionsumgebung ausgeliefert wird.

Spire.Barcode-Ansatz

Spire.Barcode verfügt über keine native PDF-Lesefunktion. Um Barcodes aus einer PDF-Datei zu extrahieren, muss ein Entwickler das separate Spire.PDF-Paket installieren, eine separate Spire.PDF-Lizenz erwerben und den Code zur Seiteniteration und Bildextraktion manuell schreiben, bevor der Barcode-Scan beginnen kann:

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

Dieses Muster erfordert zwei NuGet Pakete, zwei Lizenzvereinbarungen und vom Entwickler geschriebenen Seitenverwaltungscode. Sind Barcodes in Vektorinhalten anstatt in Rasterbildern innerhalb der PDF-Datei eingebettet, kann es passieren, dass der Bildextraktionsansatz sie vollständig erfasst.

IronBarcode Ansatz

IronBarcode verarbeitet PDF-Dateien nativ ohne zusätzliche Abhängigkeiten. Das Lesen von Barcodes aus PDF-Dokumenten erfolgt durch einen einzigen Methodenaufruf unter Verwendung derselben BarcodeReader.Read()-API wie bei Bilddateien. In jedem Ergebnisobjekt sind Seitenzahlen enthalten:

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

Es ist keine manuelle Seitenextraktion, kein zweites Paket und kein zusätzlicher Lizenzkauf erforderlich.

Spire.Barcode-Ansatz

Das Generierungsmodell von Spire.Barcode konzentriert sich auf ein veränderliches BarcodeSettings-Konfigurationsobjekt. Ein Entwickler initialisiert die Einstellungen, weist die Eingabewerte individuell zu, übergibt das Einstellungsobjekt an eine BarCodeGenerator und ruft dann GenerateImage() auf:

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

Das veränderliche Einstellungsobjekt bedeutet, dass Konfigurationen versehentlich über mehrere Aufrufe hinweg geteilt werden können, wenn eine einzelne Instanz über mehrere Generierungsvorgänge hinweg wiederverwendet wird. Die Generatorklasse fügt einen zusätzlichen Instanziierungsschritt hinzu, der keine eigene Konfigurationslogik enthält.

IronBarcode Ansatz

IronBarcode verwendet eine statische Factory-Methode mit optionaler Fluent Chaining. Es gibt kein Einstellungsobjekt und keine Generatorinstanz, die verwaltet werden muss:

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

// IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

QR-Codes mit individuellen Logos sind in allen IronBarcode -Lizenzstufen verfügbar:

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

Verarbeitung von Dokumenten in gemischten Formaten

Teams, die mit einem einzigen bekannten Barcode-Format beginnen, stellen oft fest, dass die Vielfalt der verwendeten Formate im Laufe der Zeit zunimmt. Eine Lagerverwaltungsanwendung, die mit Code128-Etiketten gestartet ist, kann beispielsweise Lieferungen von Lieferanten empfangen, die DataMatrix-, GS1-128- oder QR-Codes verwenden. Jedes neue Format, das in den Workflow gelangt, erfordert eine Aktualisierung des Kandidatenarrays in der Typerkennungsschleife, einen erneuten Test der Erkennungslogik und die Bestätigung, dass kein vorhandenes Format durch die Iterationsreihenfolge verdrängt wird. Wenn die Formatvielfalt ein Ausmaß erreicht, bei dem der Wartungsaufwand für diese Schleife zu wiederkehrenden Entwicklungskosten wird, prüfen die Teams, ob eine automatische Erkennung diese Belastung vollständig beseitigen würde.

PDF-Integration

Bei dokumentenintensiven Anwendungen kommt es häufig vor, dass Barcodes aus PDF-Dateien anstatt aus eigenständigen Bildern extrahiert werden müssen. In einem Spire.Barcode-Workflow erfordert dieser Übergang den Erwerb einer Spire.PDF-Lizenz, die Integration eines zweiten Pakets und die Entwicklung einer Infrastruktur für Seiteniteration und Bildextraktion, bevor überhaupt ein Barcode gelesen werden kann. Teams, die diese Anforderung beim ursprünglichen Kauf nicht berücksichtigt hatten, sehen sich nun mit der Verwaltung von zwei Produktlizenzen und zwei API-Schnittstellen für eine Aufgabe konfrontiert, die konzeptionell zum Barcode-Lesen gehört. Die Erkenntnis, dass die PDF-Unterstützung einen separaten Kauf erfordert, ist ein häufiger Anlass, die Produktauswahl zu überdenken.

Einschränkungen bei der Bewertung der kostenlosen Version

Teams, die FreeSpire.Barcode evaluiert und anschließend die kommerzielle Lizenz erworben haben, berichten mitunter, dass sich das kommerzielle Produkt anders verhält, als ihre Evaluierung vermuten ließ. Dies ist so beabsichtigt: Die kostenlose Version reduziert absichtlich die Leseleistung und beschränkt den Symboliksatz, was bedeutet, dass die während der Evaluierung durchgeführten Benchmarks und Formatabdeckungstests nicht auf die kommerzielle Bereitstellung übertragbar sind. Wenn ein Team diese Diskrepanz nach dem Kauf feststellt, sucht es häufig nach Alternativen, deren Testverhalten repräsentativ für das Produktionsverhalten ist.

Reduzierung der Produktanzahl

Organisationen, die ihren Technologie-Stack standardisieren, betrachten Spire.Barcode manchmal als eine Komponente in einem wachsenden Bestand an E-iceblue-Produkten, von denen jedes seine eigenen Lizenzkosten und seinen eigenen Erneuerungszyklus hat. Wenn der Hauptzweck von Spire.Barcode das Lesen von Barcodes innerhalb einer Dokumentenverarbeitungspipeline ist – und nicht die tiefe Integration mit Spire.Doc oder Spire.XLS – prüfen die Teams, ob eine einzige, in sich geschlossene Barcode-Bibliothek sowohl die Lizenzierungskomplexität als auch den Supportaufwand reduzieren würde.

Entfernen des Parameters "BarCodeType"

Jeder scanner.Scan()-Aufruf in einer Spire.Barcode-Codebasis trägt ein BarCodeType-Argument. Das Ersetzen dieser Aufrufe durch BarcodeReader.Read() entfernt den Typ-Parameter vollständig. Typ-Raten-Schleifen — foreach-Blöcke, die durch Kandidaten BarCodeType-Werte iterieren — können vollständig gelöscht werden; ein einziger BarcodeReader.Read()-Aufruf ersetzt die gesamte Schleife.

Aktualisierung des Rückgabetyps

Spire.Barcodes Scan() gibt string[] zurück. IronBarcode gibt eine BarcodeResults-Sammlung zurück. Aufrufstellen, die Wert zu string[] zuweisen oder Ergebnisse an Methoden übergeben, die diesen Typ erwarten, erfordern eine Aktualisierung. Das Extrahieren von Werten als Array verwendet .Select(r => r.Value).ToArray(); der Zugriff auf das erste Ergebnis erfolgt mit .First()?.Value.

Entfernen des Spire.PDF-Pakets

Wenn Spire.PDF ausschließlich installiert wurde, um Barcodes aus PDF-Dateien zu extrahieren, kann es nach der Migration zu IronBarcode entfernt werden. Alle using Spire.Pdf;-Importe und manuellen Seiteniterationsblöcke werden durch einen einzigen BarcodeReader.Read("file.pdf")-Aufruf ersetzt. Wenn Spire.PDF für andere Dokumentoperationen außerhalb der Barcodeextraktion verwendet wird, sollte es behalten werden und nur die barcodebezogenen Codepfade ersetzt werden.

Namensraumänderungen

Ersetzen Sie using Spire.Barcode; durch using IronBarCode;. Das BarCodeType-Enum wird durch BarcodeEncoding für die Generierung ersetzt und erfordert kein Äquivalent für das Lesen. Die Lizenzinitialisierung ändert sich von Spire.License.LicenseProvider.SetLicenseKey() zu einer einzigen IronBarCode.License.LicenseKey-Eigenschaftszuweisung beim Anwendungsstart.