Comment valider les checksums de codes-barres et utiliser la lecture sensible au format en C#

Comment valider les checksums de codes-barres ?

IronBarcode valide les checksums au moment du décodage dans le cadre de la spécification de chaque symbologie. Lorsque la bibliothèque lit un code-barres EAN-13, le chiffre de contrôle Mod10 est calculé à partir des 12 premiers chiffres et comparé au 13e. Un désaccord entraîne le rejet silencieux du code-barres — il n'apparaît jamais dans la collection BarcodeResults. Le même principe s'applique à chaque format ayant un chiffre de contrôle obligatoire : UPC-A, UPC-E, EAN-8, Code128, ITF, et autres.

Ce modèle implicite diffère des bibliothèques qui exposent un basculement explicite. Le tableau ci-dessous compare les deux approches :

La conséquence pratique : le code appelant qui reçoit un BarcodeResult de IronBarcode peut être sûr que le chiffre de contrôle est valide pour tout format ayant un checksum obligatoire. Il n'y a pas d'étape de configuration à oublier ni de drapeau à laisser accidentellement dans un état incorrect.

Pour les symbologies où les checksums sont optionnels — Code39 étant l'exemple principal — la bibliothèque repose sur le score de confiance et le mécanisme RemoveFalsePositive plutôt qu'un basculement explicite de checksum. La propriété Confidence sur chaque BarcodeResult indique à quel point le code-barres a été décodé de manière fiable, et le ConfidenceThreshold sur BarcodeReaderOptions (défaut 0.7) fixe le seuil de détection ML.

//:path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/checksum-confidence.cs
using IronBarCode;

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
    RemoveFalsePositive = true,
    ConfidenceThreshold = 0.85,
    Speed = ReadingSpeed.Detailed
};

BarcodeResults results = BarcodeReader.Read("warehouse-rack.png", options);

foreach (BarcodeResult result in results)
{
    // Every result here has passed checksum validation (mandatory formats)
    // and exceeded the 85% confidence threshold (all formats)
    Console.WriteLine($"[{result.BarcodeType}] {result.Valeur} — Confidence: {result.Confidence}%");
}

if (results.Count == 0)
{
    Console.Error.WriteLine("No valid barcodes found. Possible causes:");
    Console.Error.WriteLine("  - Check digit mismatch (barcode silently rejected)");
    Console.Error.WriteLine("  - Confidence below 85% threshold");
    Console.Error.WriteLine("  - Format not in ExpectBarcodeTypes");
}

//:path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/checksum-confidence.cs
using IronBarCode;

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
    RemoveFalsePositive = true,
    ConfidenceThreshold = 0.85,
    Speed = ReadingSpeed.Detailed
};

BarcodeResults results = BarcodeReader.Read("warehouse-rack.png", options);

foreach (BarcodeResult result in results)
{
    // Every result here has passed checksum validation (mandatory formats)
    // and exceeded the 85% confidence threshold (all formats)
    Console.WriteLine($"[{result.BarcodeType}] {result.Valeur} — Confidence: {result.Confidence}%");
}

if (results.Count == 0)
{
    Console.Error.WriteLine("No valid barcodes found. Possible causes:");
    Console.Error.WriteLine("  - Check digit mismatch (barcode silently rejected)");
    Console.Error.WriteLine("  - Confidence below 85% threshold");
    Console.Error.WriteLine("  - Format not in ExpectBarcodeTypes");
}

Élever ConfidenceThreshold au-dessus du défaut 0.7 est l'équivalent le plus proche d'une "application stricte du checksum" pour les symbologies à checksum optionnel. Les codes-barres qui sont décodés mais en dessous du seuil sont exclus des résultats, fournissant une porte de qualité réglable qui complète la vérification fixe du checksum.

Comment utiliser la lecture de codes-barres sensible au format ?

L'énumération BarcodeEncoding est de type flags — plusieurs formats peuvent être combinés avec l'opérateur OR bit à bit. Définir ExpectBarcodeTypes restreint le lecteur à ces formats, ignorant les routines de détection pour tous les autres.

Spécifier le format attendu offre deux avantages : le lecteur saute les routines de détection pour les symbologies non pertinentes (amélioration de la vitesse de numérisation), et les codes-barres de types inattendus sont exclus des résultats même s'ils sont physiquement présents dans l'image. Cette seconde propriété est la validation de sensibilisation au format — le lecteur ne renvoie que ce que le pipeline attend.

//:path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/format-constrained.cs
using IronBarCode;

// Scenario: shipping labels contain only Code128 barcodes
var constrainedOptions = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Faster,
    ExpectMultipleBarcodes = false
};

// Scenario: auto-detect all formats (default behavior)
var broadOptions = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.All,
    Speed = ReadingSpeed.Detailed,
    ExpectMultipleBarcodes = true
};

string imagePath = "shipping-label.png";

// Constrained read — faster, only returns Code128 results
BarcodeResults constrained = BarcodeReader.Read(imagePath, constrainedOptions);
Console.WriteLine($"Constrained: {constrained.Count} Code128 barcode(s) found");

// Broad read — slower, returns all detected formats
BarcodeResults broad = BarcodeReader.Read(imagePath, broadOptions);
Console.WriteLine($"Broad: {broad.Count} barcode(s) found across all formats");

foreach (BarcodeResult result in broad)
{
    Console.WriteLine($"  [{result.BarcodeType}] {result.Valeur}");
}

//:path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/format-constrained.cs
using IronBarCode;

// Scenario: shipping labels contain only Code128 barcodes
var constrainedOptions = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Faster,
    ExpectMultipleBarcodes = false
};

// Scenario: auto-detect all formats (default behavior)
var broadOptions = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.All,
    Speed = ReadingSpeed.Detailed,
    ExpectMultipleBarcodes = true
};

string imagePath = "shipping-label.png";

// Constrained read — faster, only returns Code128 results
BarcodeResults constrained = BarcodeReader.Read(imagePath, constrainedOptions);
Console.WriteLine($"Constrained: {constrained.Count} Code128 barcode(s) found");

// Broad read — slower, returns all detected formats
BarcodeResults broad = BarcodeReader.Read(imagePath, broadOptions);
Console.WriteLine($"Broad: {broad.Count} barcode(s) found across all formats");

foreach (BarcodeResult result in broad)
{
    Console.WriteLine($"  [{result.BarcodeType}] {result.Valeur}");
}

Lorsque l'image contient un code-barres dans un format inattendu — un code QR sur une étiquette de livraison qui devrait seulement porter Code128 — le lecteur contraint retourne zéro résultats plutôt que de lever une exception. C'est volontaire : une incompatibilité de format est une préoccupation au niveau des données, pas une condition d'erreur. Le code appelant devrait traiter les résultats vides d'une lecture contrainte au format comme un signal de validation et enregistrer la divergence pour enquête.

Pour les pipelines traitant des images avec plusieurs types de codes-barres (par exemple, un bordereau avec à la fois un code produit EAN-13 et un numéro de suivi Code128), combinez les formats attendus :

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true
};

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true
};

Le lecteur trouvera et renverra les codes-barres des deux types tout en ignorant toute autre symbologie présente dans l'image. Chaque BarcodeResult.BarcodeType renvoyé identifie quel format a été décodé, permettant la logique de routage en aval.

Comment combiner les checksums avec les contraintes de format ?

Le modèle prêt à l'emploi configure ExpectBarcodeTypes, RemoveFalsePositive, ConfidenceThreshold, et Speed dans un seul objet BarcodeReaderOptions. Ensemble, ces propriétés forment une porte de validation en couches : la contrainte de format rétrécit l'espace de recherche, la validation des checksums (implicite) garantit l'intégrité des données, le seuil de confiance filtre les décodages marginaux, et la suppression des faux positifs ajoute un passage de vérification secondaire.

//:path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/combined-validation.cs
using IronBarCode;

// Production configuration: retail POS scanning with EAN-13 and UPC-A
var options = new BarcodeReaderOptions
{
    // Layer 1: Format constraint — only retail symbologies
    ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.UPCA | BarcodeEncoding.UPCE,

    // Layer 2: Confidence threshold — reject marginal decodes
    ConfidenceThreshold = 0.8,

    // Layer 3: False-positive removal — double-scan verification
    RemoveFalsePositive = true,

    // Performance tuning
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = false,
    MinScanLines = 3
};

string[] scanFiles = Directory.GetFiles("pos-scans/", "*.png");

foreach (string file in scanFiles)
{
    BarcodeResults results = BarcodeReader.Read(file, options);

    if (results.Count == 0)
    {
        // No barcode passed all validation layers
        Console.Error.WriteLine($"REJECT {Path.GetFileName(file)}: "
            + "no valid EAN-13/UPC barcode (checksum, confidence, or format mismatch)");
        continue;
    }

    BarcodeResult primary = results.First();

    // Post-read assertion: verify the decoded format matches expectations
    if (primary.BarcodeType != BarcodeEncoding.EAN13
        && primary.BarcodeType != BarcodeEncoding.UPCA
        && primary.BarcodeType != BarcodeEncoding.UPCE)
    {
        Console.Error.WriteLine($"UNEXPECTED FORMAT {Path.GetFileName(file)}: "
            + $"got {primary.BarcodeType}, expected EAN-13/UPC");
        continue;
    }

    Console.WriteLine($"OK {Path.GetFileName(file)}: "
        + $"[{primary.BarcodeType}] {primary.Valeur} — {primary.Confidence}%");
}

//:path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/combined-validation.cs
using IronBarCode;

// Production configuration: retail POS scanning with EAN-13 and UPC-A
var options = new BarcodeReaderOptions
{
    // Layer 1: Format constraint — only retail symbologies
    ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.UPCA | BarcodeEncoding.UPCE,

    // Layer 2: Confidence threshold — reject marginal decodes
    ConfidenceThreshold = 0.8,

    // Layer 3: False-positive removal — double-scan verification
    RemoveFalsePositive = true,

    // Performance tuning
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = false,
    MinScanLines = 3
};

string[] scanFiles = Directory.GetFiles("pos-scans/", "*.png");

foreach (string file in scanFiles)
{
    BarcodeResults results = BarcodeReader.Read(file, options);

    if (results.Count == 0)
    {
        // No barcode passed all validation layers
        Console.Error.WriteLine($"REJECT {Path.GetFileName(file)}: "
            + "no valid EAN-13/UPC barcode (checksum, confidence, or format mismatch)");
        continue;
    }

    BarcodeResult primary = results.First();

    // Post-read assertion: verify the decoded format matches expectations
    if (primary.BarcodeType != BarcodeEncoding.EAN13
        && primary.BarcodeType != BarcodeEncoding.UPCA
        && primary.BarcodeType != BarcodeEncoding.UPCE)
    {
        Console.Error.WriteLine($"UNEXPECTED FORMAT {Path.GetFileName(file)}: "
            + $"got {primary.BarcodeType}, expected EAN-13/UPC");
        continue;
    }

    Console.WriteLine($"OK {Path.GetFileName(file)}: "
        + $"[{primary.BarcodeType}] {primary.Valeur} — {primary.Confidence}%");
}

Le paramètre MinScanLines = 3 augmente le nombre minimum de lignes de balayage concordantes pour qu'un code-barres 1D soit considéré comme valide - le défaut est 2. Augmenter cette valeur réduit la probabilité qu'une ligne de balayage bruyante produise une lecture fantôme, au prix de passer potentiellement à côté de codes-barres fins ou partiellement endommagés. Pour un environnement de point de vente de détail avec des étiquettes imprimées propres, 3 est un choix conservateur qui resserre la porte de validation sans affecter le débit.

L'assertion post-lecture BarcodeType est un modèle de défense en profondeur. Bien que ExpectBarcodeTypes contraigne déjà le lecteur, la vérification explicite documente l'intention et attrape les cas extrêmes dans les futures versions de la bibliothèque ou dérives de configuration. Cette assertion ne coûte rien à l'exécution et fournit un message diagnostique clair en cas de violation.

Pour un réglage plus poussé, la propriété Speed contrôle combien d'efforts de calcul le lecteur applique. ReadingSpeed.Faster saute certains étapes de prétraitement d'image et convient aux étiquettes imprimées à la machine propres. ReadingSpeed.Detailed ou ReadingSpeed.ExtremeDetail applique progressivement plus de filtres d'image et de tentatives de rotation, ce qui peut récupérer des codes-barres à partir d'images endommagées ou mal éclairées au prix de temps de numérisation plus longs.

Quelles sont mes prochaines étapes ?

Cet article a couvert le modèle de validation de checksum implicite de IronBarcode, l'énumération BarcodeEncoding pour des lectures contraintes au format, et un modèle de validation combiné utilisant ExpectBarcodeTypes, ConfidenceThreshold, RemoveFalsePositive, et MinScanLines comme portes de qualité superposées.

Pour approfondir la lecture, explorez ces ressources :

• Tutoriels IronBarcode — Lecture de codes-barres pour des parcours de lecture de bout en bout.
• Prévention des faux positifs pour un détail du mécanisme RemoveFalsePositive.
• Exemples de seuil de confiance pour ajuster la détection basée sur ML.
• Formats de données de sortie pour une référence de la propriété BarcodeResult.
• Correction d'image Mode d'emploi pour les filtres qui améliorent la précision du décodage.
• Référence API BarcodeReaderOptions pour la documentation de configuration complète.
• Référence API BarcodeEncoding pour la liste complète des symbologies prises en charge.

Obtenez une licence d'essai gratuite pour tester chaque fonctionnalité dans un environnement en direct, ou voir les options de licence lorsque le pipeline est prêt pour la production.