Exigences relatives aux spécifications de type

L'BarcodeScanner.Scan() de Spire.Barcode n'a pas de surcharge qui accepte uniquement un chemin de fichier. Chaque opération de lecture exige que le code appelant déclare le format du code-barres à l'avance. Pour les flux de travail à format unique, cela fonctionne, mais pour le traitement de documents à formats mixtes, cela produit une boucle d'itération potentielle :

// 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

Chaque type ajouté au tableau des candidats correspond à une passe d'analyse supplémentaire. Tout format absent de la liste est ignoré sans que cela ne soit pris en compte. Le développeur est responsable de la tenue d'un inventaire exhaustif des types et de la réalisation de nouveaux tests chaque fois qu'un nouveau format est intégré au flux de travail.

Comparaison détaillée des fonctionnalités

Approche Spire.Barcode

L'BarcodeScanner.Scan() de Spire.Barcode nécessite un paramètre BarCodeType à chaque appel. L'appel à type unique est approprié lorsque le format est connu et garanti :

// 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

Lorsque le format est inconnu à l'avance, la seule approche possible consiste à parcourir les types candidats. Chaque itération correspond à une analyse complète, et tout format absent de la liste est ignoré sans notification. Le résultat est une string[] qui ne contient pas d'informations de type, donc le routage en aval basé sur le format nécessite une gestion d'état supplémentaire par l'appelant.

Approche IronBarcode

L'BarcodeReader.Read() d'IronBarcode ne nécessite pas de paramètre de type. La bibliothèque détecte automatiquement le format pour toutes les symbologies prises en charge, en une seule passe. La lecture des codes-barres à partir d'images se résume à un seul appel de méthode, quel que soit le nombre de formats différents que peut contenir la source :

// 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

Chaque objet résultat inclut Format, Value, et des métadonnées positionnelles. Le routage en aval basé sur le format ne nécessite aucun état supplémentaire : le type est présent dans le résultat lui-même.

Spire.Barcode Niveau gratuit

FreeSpire.Barcode applique un grand filigrane d'évaluation aux images de codes-barres générées. Le filigrane recouvre le code-barres de telle sorte qu'il le rend inutilisable pour la production et empêche toute évaluation pertinente de la qualité de la génération. Les performances de numérisation sont intentionnellement dégradées dans la version gratuite, ce qui signifie que les mesures de débit effectuées lors de l'évaluation ne représentent pas les performances commerciales de Spire.Barcode. Le package gratuit nécessite également une clé d'enregistrement obtenue auprès d'E-iceblue pour que les boîtes de dialogue d'avertissement soient supprimées lors de l'exécution. L'ensemble de symboles disponibles dans la version gratuite est un sous-ensemble de l'offre commerciale. Ces restrictions signifient collectivement qu'une évaluation basée sur FreeSpire.Barcode ne représente pas fidèlement les performances du produit commercial.

Mode d'essai IronBarcode

La version d'essai d'IronBarcode est le package sous licence utilisé sans clé de licence. La lecture s'effectue à pleine vitesse avec une prise en charge complète de la symbologie et sans restrictions comportementales. Les options de vitesse et de précision de lecture fonctionnent de manière identique en mode d'essai et en mode licence. Les codes-barres générés en mode d'essai comportent un petit filigrane sur le bord de l'image ; Il ne masque pas le code-barres lui-même. Le comportement mesuré lors d'une évaluation Code-barres IronBarcode est celui qui est déployé en production.

Approche Spire.Barcode

Spire.Barcode ne possède pas de fonctionnalité native de lecture de fichiers PDF. Pour extraire des codes-barres d'un fichier PDF, un développeur doit installer le package Spire.PDF séparé, acheter une licence Spire.PDF distincte et écrire un code de parcours de page manuel et d'extraction d'image avant de pouvoir commencer à scanner les codes-barres :

// 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

Ce modèle nécessite deux packages NuGet , deux contrats de licence et du code de gestion de pages écrit par les développeurs. Si les codes-barres sont intégrés dans un contenu vectoriel plutôt que dans des images raster au sein du PDF, la méthode d'extraction d'images risque de ne pas les détecter du tout.

Approche IronBarcode

IronBarcode gère les fichiers PDF nativement, sans aucune dépendance supplémentaire. La lecture des codes-barres à partir des documents PDF est un appel de méthode unique utilisant la même API BarcodeReader.Read() utilisée pour les fichiers image. Les numéros de page sont inclus dans chaque objet de résultat :

// 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

Aucune extraction manuelle de pages, aucun paquetage secondaire et aucun achat de licence supplémentaire ne sont requis.

Approche Spire.Barcode

Le modèle de génération de Spire.Barcode est centré sur un objet de configuration BarcodeSettings mutable. Un développeur instancie les paramètres, assigne les propriétés individuellement, passe l'objet de paramètres à un BarCodeGenerator, puis appelle GenerateImage():

// 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)

L'objet de paramètres modifiable signifie que les configurations peuvent être partagées accidentellement entre les appels lorsqu'une seule instance est réutilisée dans plusieurs opérations de génération. La classe générateur ajoute une étape d'instanciation supplémentaire qui ne comporte aucune logique de configuration propre.

Approche IronBarcode

IronBarcode utilise une méthode de fabrique statique avec chaînage fluide optionnel. Il n'existe aucun objet de configuration ni aucune instance de générateur à gérer :

// Code-barres 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");

// Code-barres 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

' Code-barres IronBarcode generation
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

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

Les codes QR avec logos personnalisés sont disponibles pour tous les niveaux de licence IronBarcode :

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")

Traitement de documents de formats mixtes

Les équipes qui commencent avec un seul format de code-barres connu constatent souvent que la diversité des formats utilisés augmente avec le temps. Une application de gestion d'entrepôt initialement conçue avec des étiquettes Code128 peut recevoir des livraisons de fournisseurs utilisant des codes DataMatrix, GS1-128 ou des codes QR. Chaque nouveau format qui entre dans le flux de travail nécessite la mise à jour du tableau candidat dans la boucle de devinette de type, le test de la logique de détection et la confirmation qu'aucun format existant n'est déplacé par l'ordre d'itération. Lorsque la diversité des formats atteint un point où les frais de maintenance de cette boucle deviennent un coût de développement récurrent, les équipes évaluent si la détection automatique permettrait d'éliminer complètement ce fardeau.

Intégration PDF

Les applications qui manipulent beaucoup de documents rencontrent souvent un moment où il est nécessaire d'extraire les codes-barres de fichiers PDF plutôt que d'images autonomes. Dans un flux de travail Spire.Barcode, cette transition nécessite l'acquisition d'une licence Spire.PDF, l'intégration d'un deuxième package et la mise en place d'une infrastructure d'itération de page et d'extraction d'images avant toute lecture de code-barres. Les équipes qui n'avaient pas anticipé cette exigence lors de l'achat initial se retrouvent à gérer deux licences de produit et deux interfaces API pour une tâche qui relève conceptuellement de la lecture de codes-barres. Découvrir que la prise en charge des fichiers PDF nécessite un achat séparé est un élément déclencheur fréquent qui incite à réévaluer le choix du produit.

Limitations de l'évaluation gratuite

Les équipes qui ont évalué FreeSpire.Barcode puis acheté la licence commerciale signalent parfois que le produit commercial se comporte différemment de ce que leur évaluation laissait présager. Ceci est intentionnel : le niveau gratuit dégrade volontairement les performances de lecture et restreint l'ensemble de symbologie, ce qui signifie que les tests de performance et de couverture de format effectués lors de l'évaluation ne sont pas transposables au déploiement commercial. Lorsqu'une équipe découvre cette anomalie après l'achat, elle recherche souvent des alternatives dont le comportement à l'essai est représentatif du comportement en production.

Réduction du nombre de produits

Les organisations qui standardisent leur pile technologique identifient parfois Spire.Barcode comme un composant d'un inventaire croissant de produits E-iceblue, chacun ayant son propre coût de licence et son propre cycle de renouvellement. Si le principal moteur de Spire.Barcode est la lecture des codes-barres au sein d'un pipeline de traitement de documents — plutôt qu'une intégration profonde avec Spire.Doc ou Spire.XLS — les équipes évaluent si une bibliothèque de codes-barres unique et autonome permettrait de réduire à la fois la complexité des licences et la surface d'assistance.

Suppression du paramètre BarCodeType

Chaque appel scanner.Scan() dans une base de code Spire.Barcode transporte un argument BarCodeType. Remplacer ces appels par BarcodeReader.Read() supprime complètement le paramètre de type. Les boucles de supposition de type — les blocs foreach qui itèrent à travers les valeurs candidates BarCodeType — peuvent être supprimées en totalité; un seul appel BarcodeReader.Read() remplace toute la boucle.

Mise à jour du type de retour

L'Scan() de Spire.Barcode retourne string[]. Code-barres IronBarcode returns a BarcodeResults collection. Les sites d'appel qui assignent à string[] ou passent des résultats à des méthodes attendant ce type nécessitent une mise à jour. L'extraction de valeurs sous forme de tableau utilise .Select(r => r.Value).ToArray(); l'accès au premier résultat utilise .First()?.Value.

Suppression du package Spire.PDF

Si Spire.PDF a été installé uniquement pour prendre en charge l'extraction de codes-barres à partir de fichiers PDF, il peut être supprimé après la migration vers IronBarcode. Toutes les importations using Spire.Pdf; et les blocs de parcours de page manuels sont remplacés par un seul appel BarcodeReader.Read("file.pdf"). Si Spire.PDF est utilisé pour d'autres opérations de document au-delà de l'extraction de codes-barres, il doit être conservé et seuls les parcours de code liés aux codes-barres doivent être remplacés.

Modifications de l'espace de nommage

Remplacez using Spire.Barcode; par using IronBarCode;. L'énumération BarCodeType est remplacée par BarcodeEncoding pour la génération et ne nécessite pas d'équivalent pour la lecture. L'initialisation de la licence passe de Spire.License.LicenseProvider.SetLicenseKey() à une unique affectation de propriété IronBarCode.License.LicenseKey au démarrage de l'application.