NetBarcode vs IronBarcode : Comparaison de la bibliothèque de codes-barres C#

Limite de conception de l'énumération de type

L'énumération Type est la liste officielle de ce que Code-barres net peut générer. Son examen révèle l'étendue de la bibliothèque :

// Code-barres net Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// Code-barres net Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

' Code-barres net Type enum — complete list as of v1.8
Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

Il ne s'agit pas d'une fonctionnalité manquante en attente d'une demande de fusion. L'énumération comporte quatorze entrées, toutes unidimensionnelles, ce qui correspond à la portée prévue de la bibliothèque. Toute application nécessitant des codes QR, DataMatrix, PDF417ou Aztèque doit se procurer un package distinct pour fournir ces formats.

Comparaison détaillée des fonctionnalités

Approche NetBarcode

NetBarcode fournit 14 formats de codes-barres linéaires par le biais de l'enum Type. Dans ce contexte, la sélection du format est simple : il suffit de passer le membre d'énumération approprié au constructeur. La limite est tout aussi claire : toute tentative d'utilisation d'un format extérieur à l'énumération produit une erreur de compilation.

// Code-barres net — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// Code-barres net — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// Code-barres net — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// Code-barres net — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' Code-barres net — formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

Les secteurs où cette limite devient une contrainte comprennent le suivi pharmaceutique (DataMatrix requis par les mandats de la FDA sur les codes-barres 2D), les cartes d'embarquement des compagnies aériennes (Aztec), les manifestes logistiques (PDF417) et le marketing mobile (code QR). Chacune de ces exigences élimine Code-barres net en tant que solution autonome.

Approche IronBarcode

IronBarcode expose tous les formats pris en charge par le biais de la même méthode BarcodeWriter.CreateBarcode. La surface de l'API ne change pas lorsque l'on passe d'un format 1D à un format 2D - seule la constante BarcodeEncoding diffère.

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

La liste complète des constantes prises en charge est disponible dans le guide des formats de codes-barres pris en charge , couvrant tous les formats de génération de codes-barres 2D ainsi que l'ensemble complet des codes-barres 1D.

Approche NetBarcode

Le modèle de génération de Code-barres net est basé sur des constructeurs. Un objet Barcode est instancié avec la chaîne de données et une valeur Type enum. Le résultat est soit enregistré directement avec SaveImageFile(), soit récupéré en tant que Image<Rgba32> via GetImage(). Depuis la version 1.8, le type de retour de GetImage() est le type SixLabors.ImageSharp, ce qui signifie que tout code qui stocke ou traite la valeur de retour doit importer et travailler dans l'API ImageSharp.

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

Le type de retour de la méthode GetImage() relie le code en aval à la bibliothèque ImageSharp. Toute méthode qui accepte ou stocke le résultat doit le déclarer comme Image<Rgba32>, ce qui introduit une dépendance transitive dans le code appelant.

Approche IronBarcode

IronBarcode utilise une chaîne fluide. BarcodeWriter.CreateBarcode renvoie un objet GeneratedBarcode qui comporte plusieurs méthodes de sortie. Le traitement des images est interne — aucun type ImageSharp n'est exposé au code appelant.

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

Les options détaillées de génération de codes-barres 1D, notamment la largeur, la hauteur et la configuration des étiquettes, sont décrites dans la documentation Code-barres IronBarcode .

Approche NetBarcode

NetBarcode ne possède pas d'API de lecture. Il n'existe aucune méthode, classe ou configuration permettant de décoder une image de code-barres pour retrouver sa chaîne de données. Il s'agit d'une délimitation délibérée du périmètre, et non d'une omission en attendant une version. Un projet qui génère des codes-barres avec Code-barres net et qui doit ensuite les lire (pour valider une étiquette imprimée, scanner un envoi de retour ou extraire des valeurs d'une facture fournisseur) doit introduire une bibliothèque distincte à cet effet.

// Code-barres net — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// Code-barres net — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

' Code-barres net — no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

La bibliothèque ZXing .NET est l'ajout le plus courant pour la lecture en parallèle de NetBarcode, apportant une troisième surface d'API et un troisième package à gérer en version aux côtés de Code-barres net et de toute bibliothèque 2D déjà ajoutée pour les codes QR.

Approche IronBarcode

IronBarcode inclut BarcodeReader dans le même paquet que BarcodeWriter. L'API de lecture accepte les fichiers image et les documents PDF et renvoie une collection de résultats décodés, chacun contenant la valeur du code-barres, le type de format et le numéro de page s'il s'agit d'un PDF.

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

Le guide de lecture des codes-barres à partir d'images aborde le réglage de la vitesse, la détection de plusieurs codes-barres et les options de correction d'image disponibles dans l'API de lecture.

Code-barres net et ImageSharp

NetBarcode est distribué sous licence MIT. La bibliothèque SixLabors.ImageSharp dont elle dépend utilise un modèle différent : gratuite pour les projets open-source et pour les entreprises dont le chiffre d'affaires annuel brut est inférieur à un seuil défini, mais une licence commerciale est requise au-delà de ce seuil. Cette répartition s'applique indépendamment du fait qu'ImageSharp soit listé explicitement dans le .csproj d'un projet ou qu'il arrive transitoirement par NetBarcode.

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

Pour une entreprise de vente au détail ou de logistique traitant des codes-barres à grande échelle — le principal cas d'utilisation ciblé par Code-barres net — le chiffre d'affaires annuel est souvent supérieur au seuil auquel s'applique la licence commerciale ImageSharp. Un audit de conformité peut révéler cette obligation dissimulée dans l'arborescence du package.

La version v1.8 a introduit une conséquence supplémentaire de la dépendance d'ImageSharp : le type de retour de GetImage() est passé d'une représentation interne à SixLabors.ImageSharp.Image<Rgba32>. Le code existant qui appelait GetImage() sans typage explicite se cassait à la compilation, et de nouvelles directives using pour SixLabors.ImageSharp et SixLabors.ImageSharp.PixelFormats devenaient nécessaires. Lorsque l'API d'ImageSharp évolue dans les versions futures, l'interface API publique de Code-barres net est elle aussi affectée.

IronBarcode

IronBarcode ne dépend pas de SixLabors.ImageSharp. Ses conditions de licence sont énoncées directement sur la page de licence Code-barres IronBarcode , sans seuil de séparation ni obligation commerciale transitive. Une clé d'essai est disponible pour évaluation ; L'achat d'une licence permet de supprimer le filigrane d'essai des fichiers générés.

Exigences relatives aux codes QR et aux formats 2D

Le déclencheur le plus fréquent de l'évaluation d'une alternative à Code-barres net est une nouvelle exigence concernant les codes QR. Les applications qui commencent par la génération de codes-barres 1D pour les étiquettes de vente au détail ou les manifestes d'expédition reçoivent généralement une exigence ultérieure pour les codes QR — liens sans contact, liens profonds d'applications mobiles, campagnes marketing. L'enum Type n'ayant pas d'entrée QR, cette exigence ne peut pas être satisfaite par NetBarcode. Les équipes qui ajoutent une bibliothèque QR distincte pour combler cette lacune doivent ensuite faire l'objet d'une seconde évaluation lorsque Matrice de données est requis pour une intégration pharmaceutique, ou PDF417pour un transporteur logistique qui l'impose sur les étiquettes d'expédition.

La lecture des codes-barres devient nécessaire

Certains projets commencent par une simple génération et ajoutent ultérieurement une exigence de validation ou de traitement de documents : confirmer qu'un code-barres imprimé correspond à ses données sources, extraire les valeurs des codes-barres des factures fournisseurs entrantes ou scanner les étiquettes de retour des expéditions. Code-barres net ne propose aucune solution pour cela. L'ajout de ZXing .NET ou d'une bibliothèque de lecture comparable introduit une troisième API à apprendre et à maintenir dans la même base de code qui contient déjà Code-barres net et une bibliothèque QR. Les projets qui anticipent des besoins en lecture, même dans une phase ultérieure, trouvent souvent plus efficace de choisir une bibliothèque qui prend en compte ces deux aspects dès le départ.

Audit de la licence commerciale d'ImageSharp

Les analyses juridiques et de conformité des dépendances tierces font parfois apparaître la condition de licence commerciale SixLabors.ImageSharp intégrée dans l'arborescence du package NetBarcode. Pour les entreprises dont le chiffre d'affaires annuel brut dépasse le seuil, l'obligation s'applique que ImageSharp ait été choisi délibérément ou qu'il ait été acquis par transitivité via NetBarcode. Les équipes qui découvrent ce problème lors d'un audit — plutôt qu'avant l'adoption — doivent procéder à une correction rétroactive plutôt qu'à une migration planifiée. Évaluer la licence de dépendance avant de démarrer un projet est la solution la plus propre.

Réduction de la complexité des bibliothèques multiples

Les équipes qui ont accumulé Code-barres net pour la génération 1D, une bibliothèque spécifique QR pour la sortie 2D et ZXing .NET pour la lecture se retrouvent à devoir maintenir la compatibilité des versions entre trois packages distincts. Chaque cycle de mise à niveau nécessite de vérifier si les trois bibliothèques s'accordent sur leur version partagée d'ImageSharp. Chaque nouveau développeur travaillant sur le projet rencontre trois API différentes pour ce qui, conceptuellement, ne représente qu'un seul problème. La consolidation dans une bibliothèque de codes-barres unique simplifie l'intégration, réduit les risques de conflits de versions et concentre la maintenance sur un seul cycle de publication.

Échange de paquets et nettoyage des dépendances transitives

La première étape consiste à supprimer le Code-barres net avec dotnet remove package NetBarcode. Le paquet SixLabors.ImageSharp peut réapparaître dans l'arbre des dépendances si d'autres paquets du projet l'intègrent également de manière transitoire. Après la suppression, inspectez la liste de paquets restaurée avec dotnet list package --include-transitive pour confirmer si ImageSharp est toujours présent et si la condition de licence commerciale s'applique toujours.

Remplacement du type de retour de GetImage()

Tout code qui a stocké le résultat de GetImage() en tant que Image<Rgba32> doit être mis à jour. Le type ImageSharp n'a pas d'équivalent direct dans IronBarcode; Le remplacement dépend de l'utilisation ultérieure de l'image. Le code qui enregistre l'image dans un flux peut être remplacé par .SaveAsPng(stream) directement sur l'objet GeneratedBarcode. Le code qui récupère des octets bruts peut utiliser .ToPngBinaryData(). Le code qui effectue des manipulations ImageSharp supplémentaires sur l'image renvoyée devra évaluer ces opérations individuellement.

Mise à jour de l'espace de noms

Les fichiers qui ont importé using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats;, ou using SixLabors.Fonts; doivent être remplacés par using IronBarCode;. Une recherche à l'échelle du projet de ces instructions " using " permet d'identifier chaque fichier nécessitant une attention particulière avant la tentative de compilation.