Le problème fondamental

La boucle d'estimation du type est le symptôme le plus visible de la contrainte BarCodeType obligatoire. Dans un code source Spire.Barcode traitant des documents provenant de sources multiples, ce schéma apparaît de manière répétée :

// Spire.Barcode: growing candidate loop with silent misses
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: growing candidate loop with silent misses
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

IronBarcode supprime entièrement la boucle. La détection du format est intégrée à la bibliothèque :

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

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

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

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

Imports IronBarcode

' IronBarcode: single call, all formats, type included in result
Dim results = BarcodeReader.Read("barcode.png")

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

Étape 1 : Remplacer le package NuGet

Supprimez le ou les packages Spire actuellement utilisés :

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

Si Spire.PDF est utilisé pour d'autres opérations documentaires au-delà de l'extraction de code-barres, conservez-le et retirez uniquement les chemins de code liés aux codes-barres.

Installer IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Étape 2 : Mise à jour des espaces de noms

Remplacez toutes les importations de namespace Spire par le namespace Code-barres IronBarcode :

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

Imports IronBarCode

Étape 3 : initialisation de la licence

Remplacez l'initialisation de la licence Spire par une simple attribution de propriété Code-barres IronBarcode au démarrage de l'application. Consultez la page relative aux licences IronBarcode pour connaître les formats de clés et les options de déploiement :

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key")

' Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key")

' Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Pour les environnements Docker et CI, la clé de licence peut être fournie à partir d'une variable d'environnement :

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

Imports System

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Lecture d'un code-barres de format connu

Une lecture à format unique dans Spire.Barcode passe le type explicitement et reçoit un string[].

Approche Spire.Barcode :

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

Imports Spire.Barcode

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

If results.Length > 0 Then
    ProcessShipment(results(0))
End If

Approche IronBarcode :

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

Imports IronBarCode

Dim results = BarcodeReader.Read("shipping-label.png")

If results.Any() Then
    ProcessShipment(results.First().Value)
End If

Le paramètre BarCodeType est supprimé. Si la logique en aval doit confirmer le format détecté, results.First().Format le fournit sans nécessiter de variable d'état distincte.

Réduction d'une boucle de type à format mixte

Lorsqu'un code source Spire.Barcode gère des documents pouvant contenir plusieurs formats, la boucle de devinette de type s'accumule au fil du temps à mesure que de nouveaux formats intègrent le flux de travail.

Approche Spire.Barcode :

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

Imports Spire.Barcode

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

Dim allValues As New List(Of String)()
For Each type As BarCodeType In candidates
    Dim found As String() = scanner.Scan("document-scan.png", type)
    allValues.AddRange(found)
Next

Approche IronBarcode :

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

Imports IronBarCode

' The entire loop is replaced by a single call
Dim results = BarcodeReader.Read("document-scan.png")
Dim allValues As List(Of String) = results.Select(Function(r) r.Value).ToList()

Le système de lecture d'images d'IronBarcode gère plus de 50 symbologies en une seule passe. Lorsque la vitesse de lecture doit être ajustée pour un traitement par lots à haut volume, BarcodeReaderOptions fournit ce contrôle sans ajouter de branches spécifiques au format :

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim results = BarcodeReader.Read("document-scan.png", options)

Pour des conseils sur le choix de la valeur appropriée ReadingSpeed, consultez la documentation des options de vitesse de lecture.

Générer un code-barres

La génération Spire.Barcode nécessite l'instanciation d'un objet BarcodeSettings, l'attribution de chaque propriété individuellement, le passage des paramètres à un BarCodeGenerator, puis l'appel de GenerateImage() avant que tout fichier ne soit écrit.

Approche Spire.Barcode :

using Spire.Barcode;

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

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

using Spire.Barcode;

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

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

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

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "SHIP-9842-XZ"
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("shipping-label.png", ImageFormat.Png)

Approche IronBarcode :

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

L'objet mutable BarcodeSettings et l'instance BarCodeGenerator distincte sont remplacés par un seul appel de fabrique statique avec une chaîne fluide. Il n'y a pas de risque que les paramètres soient partagés accidentellement entre les appels concurrents car chaque invocation CreateBarcode() est indépendante.

Lecture des codes-barres dans un document PDF

Spire.Barcode ne peut pas lire directement les fichiers PDF. L'approche basée sur Spire exige le package Spire.PDF distinct pour ouvrir le fichier, analyser ses pages, extraire des images raster de chaque page, et ensuite passer ces images une à une au scanner de codes-barres.

Approche Spire.Barcode :

using Spire.Pdf;
using Spire.Barcode;

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

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

using Spire.Pdf;
using Spire.Barcode;

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

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

Imports Spire.Pdf
Imports Spire.Barcode

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

Dim scanner As New BarcodeScanner()
Dim extractedValues As New List(Of String)()

For Each page As PdfPageBase In pdf.Pages
    Dim images() As Image = page.ExtractImages()
    For Each image As Image In images
        Dim found() As String = scanner.Scan(image, BarCodeType.QRCode)
        extractedValues.AddRange(found)
    Next
Next

Approche IronBarcode :

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

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

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

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

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")

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

IronBarcode lit directement les documents PDF sans nécessiter Spire.PDF ni aucune gestion manuelle des pages. Le numéro de page à partir duquel chaque code-barres a été extrait est disponible dans l'objet résultat. Une fois que le code de lecture PDF est remplacé, la référence au package Spire.PDF et toutes les importations using Spire.Pdf; peuvent être retirées du projet.

Problème 1 : Suppression du paramètre BarCodeType

Spire.Barcode : scanner.Scan(path, BarCodeType.Code128) — le type d'argument est requis par la signature de la méthode. Sa suppression provoque une erreur de compilation.

Solution : Remplacez l'appel entier par BarcodeReader.Read(path). Recherchez dans le code source BarCodeType. pour localiser chaque occurrence. Les boucles d'estimation de type (blocs foreach itérant sur un tableau de candidats BarCodeType[]) peuvent être supprimées dans leur intégralité ; un seul appel BarcodeReader.Read() remplace la boucle.

Problème 2 : Type de retour string[]

Spire.Barcode: Scan() returns string[]. Le code en aval qui assigne cela à une variable string[] ou le passe à une méthode attendant string[] échouera à la compilation après la migration.

Solution : Mettez à jour les sites d'appel pour travailler avec BarcodeResults. Pour obtenir un tableau de chaînes de caractères simple, utilisez .Select(r => r.Value).ToArray(). Pour accéder au premier résultat, utilisez .First()?.Value. Si le format détecté est nécessaire en aval, il est disponible sur l'objet résultat via .Format — aucune variable d'état distincte n'est requise.

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

Imports System.Linq

' If a plain string array is needed:
Dim texts As String() = BarcodeReader.Read("barcode.png") _
    .Select(Function(r) r.Value) _
    .ToArray()

' If only the first value is needed:
Dim first As String = BarcodeReader.Read("barcode.png").FirstOrDefault()?.Value

Problème n° 3 : Nettoyage du package Spire.PDF

Spire.Barcode : Les workflows de lecture de PDF dépendent de Spire.PDF pour l'accès aux pages et l'extraction d'images. Le projet référence le package et contient des importations using Spire.Pdf; et l'utilisation de PdfDocument / PdfPageBase répartis sur plusieurs fichiers.

Solution : Après avoir remplacé tout le code d'extraction de codes-barres PDF par BarcodeReader.Read("file.pdf"), effectuez un audit grep pour confirmer qu'il n'y a plus de références Spire.Pdf avant de supprimer le package :

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

Ne supprimez le paquet que lorsque toutes les références sont effacées :

dotnet remove package Spire.PDF

dotnet remove package Spire.PDF

Problème n° 4 : Modifications des espaces de noms

Spire.Barcode : L'espace de noms Spire.Barcode contient BarcodeScanner, BarcodeSettings, BarCodeGenerator, et BarCodeType. L'espace de noms IronBarCode contient BarcodeReader, BarcodeWriter, BarcodeEncoding, et BarcodeReaderOptions.

Solution : Remplacez using Spire.Barcode; par using IronBarCode; globalement. L'énum BarCodeType utilisé dans la génération est remplacé par BarcodeEncoding. L'énum BarCodeType utilisé dans la lecture n'a pas d'équivalent Code-barres IronBarcode — il est simplement supprimé, car la détection de format est automatique.

Tâches préalables à la migration

Avant d'apporter des modifications, auditez le code source afin d'identifier toutes les utilisations de Spire.Barcode :

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

• Documentez tous les fichiers contenant des tableaux de candidats BarCodeType (boucles d'estimation de type à supprimer)
• Identifiez toutes les variables string[] qui reçoivent des résultats de Scan() et nécessiteront des mises à jour de type
• Confirmez si Spire.PDF est utilisé pour des opérations autres que l'extraction de codes-barres

Tâches de mise à jour du code

1. Supprimez le package NuGet FreeSpire.Barcode ou Spire.Barcode
2. Supprimez le package NuGet Spire.PDF si l'extraction de codes-barres était son seul usage
3. Installez le package NuGet IronBarcode
4. Remplacez tout using Spire.Barcode; par using IronBarCode;
5. Supprimez toutes les importations using Spire.Pdf; là où elles ne sont plus nécessaires
6. Remplacez l'initialisation de la licence : ApplyKey() ou SetLicenseKey() par IronBarCode.License.LicenseKey = "key"
7. Supprimez toutes les instanciations new BarcodeScanner()
8. Remplacez tous les appels scanner.Scan(path, BarCodeType.X) par BarcodeReader.Read(path)
9. Supprimez les boucles foreach qui devinent le type ; remplacez chacun par un seul appel BarcodeReader.Read()
10. Supprimer les blocs d'itération de page PDF et d'extraction d'images ; remplacez par BarcodeReader.Read("file.pdf")
11. Mettez à jour les affectations de résultat string[] pour utiliser .Value ou .Select(r => r.Value).ToArray()
12. Remplacez les blocs new BarcodeSettings() par des chaînes BarcodeWriter.CreateBarcode(data, encoding)
13. Supprimez les instanciations new BarCodeGenerator(settings)
14. Remplacez .GenerateImage() + image.Save() par .SaveAsPng() ou .SaveAsJpeg()
15. Remplacez les valeurs d'énumération BarCodeType.X dans la génération par BarcodeEncoding.X

Test de post-migration

• Confirmez que tous les formats précédemment analysés via la boucle de candidats sont détectés correctement par BarcodeReader.Read()
• Mesurer le débit du traitement par lots et confirmer qu'il répond aux exigences de production
• Vérifier que l'extraction des codes-barres PDF produit des valeurs et des numéros de page corrects.
• Vérifier la qualité et la lisibilité des codes-barres générés à l'aide d'un scanner physique ou logiciel.
• Vérifiez que la clé de licence est correctement chargée dans tous les environnements de déploiement (local, préproduction, production, CI/CD).
• Exécutez les commandes d'audit grep des tâches de pré-migration pour confirmer qu'il ne reste aucune référence à Spire.