API de génération Barcode4NET

Le flux de travail de génération complet dans Barcode4NETutilisait un modèle de définition de propriétés :

// Barcode4NET— manual DLL, .NET Frameworkonly
// Non Paquet NuGet— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

// Barcode4NET— manual DLL, .NET Frameworkonly
// Non Paquet NuGet— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

Ceci représente l'intégralité de l'interface de l'API Barcode4NET. La bibliothèque n'offrait aucun enchaînement fluide, aucune capacité de lecture, pas de support pour les codes QR, et pas d'options 2D avancées comme l'intégration de logo ou le contrôle de correction d'erreurs.

Comparaison détaillée des fonctionnalités

Approche Barcode4NET

Barcode4NET utilisait un modèle de définition de propriétés impératif. Les développeurs instancient un objet Barcode, assignent des propriétés individuelles, et appellent GenerateBarcode() pour recevoir un System.Drawing.Bitmap :

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

Le type de retour — System.Drawing.Bitmap — signifiait que le code appelant était responsable de sauvegarder, d'afficher ou de diffuser l'image. Cela était approprié pour les applications WinForms où un Bitmap pouvait être assigné directement à un PictureBox, mais nécessitait des étapes de conversion supplémentaires pour toute autre cible de sortie.

Approche IronBarcode

IronBarcode utilise une API statique fluide. Un simple appel de méthode lance la génération, et des méthodes chaînables configurent le résultat avant une méthode de sauvegarde ou de conversion terminale :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

L'enum BarcodeEncoding correspond directement à l'enum Symbology. .ResizeTo() remplace les assignations de propriétés Width et Height. Les méthodes terminales — .SaveAsPng(), .SaveAsJpeg(), .ToPngBinaryData() — remplacent les appels séparés de GenerateBarcode() et de sauvegarde bitmap. Pour des scénarios de génération plus avancés, consultez la documentation sur la génération de codes-barres IronBarcode .

Approche Barcode4NET

Barcode4NET ne disposait pas d'API de lecture. Les équipes qui devaient décoder les codes-barres à partir d'images ou de documents numérisés devaient intégrer une bibliothèque entièrement distincte : soit ZXing .NET, une alternative open source, soit un SDK de scanner commercial. Il en a résulté deux chaînes de dépendances distinctes : Barcode4NETpour la génération et une seconde bibliothèque pour la lecture.

Approche IronBarcode

IronBarcode fournit BarcodeReader.Read() comme méthode statique qui accepte les chemins de fichiers image, les objets flux, et les documents PDF :

using IronBarCode;

// Read from an image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

using IronBarCode;

// Read from an image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read all barcodes from a multi-page PDF — no extra PDF library required
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Imports IronBarCode

' Read from an image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Format: {result.Format}")
Next

' Read all barcodes from a multi-page PDF — no extra PDF library required
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Pour des scénarios d'images à haut volume ou bruyantes, la classe BarcodeReaderOptions offre un contrôle sur la vitesse de lecture et la détection multi-code-barres. Consultez la documentation relative à la lecture des codes-barres pour connaître les options de configuration.

Approche Barcode4NET

Barcode4NET a été compilé avec les assemblys du .NET Framework. Il fonctionnait sous Windows, dans les applications .NET Framework, dans les projets Web Forms et Windows Forms hébergés sur IIS. Il n'y avait pas de versions Linux, pas de versions .NET Core , ni de prise en charge du runtime cloud. Lorsque Microsoft a introduit .NET Core , puis a unifié la plateforme sous le nom de .NET 5+, Barcode4NETn'a bénéficié d'aucune mise à jour correspondante. Tout projet ciblant net5.0 ou plus tard ne pouvait pas référencer la bibliothèque du tout.

Le modèle de distribution des DLL a accentué la contrainte de la plateforme. Chaque environnement de compilation (poste de travail du développeur, agent de compilation, conteneur Docker) nécessitait que la DLL soit présente à un emplacement connu. Dans les déploiements basés sur des conteneurs, cela signifiait soit intégrer le DLL dans une image de base personnalisée, soit le copier lors de la construction du conteneur, ce qui n'est compatible avec aucun des flux de travail standard dotnet restore.

Approche IronBarcode

IronBarcode cible plusieurs frameworks à partir d'un seul package NuGet : .NET Framework4.6.2 à .NET 9, et toutes les versions actuelles de .NET sur Windows, Linux et macOS. Le déploiement sur des conteneurs Dockerutilise les images d'exécution .NET standard sans modification. Azure Functions, AWS Lambda et d'autres environnements d'exécution sans serveur sont pris en charge par le même package NuGet . La commande dotnet restore résout toutes les dépendances sans aucune gestion de DLL manuelle.

Approche Barcode4NET

Barcode4NET est effectivement en fin de vie. De nouvelles licences ne sont plus vendues via ComponentSource, bien que les clients existants puissent renouveler le Support et les Mises à jour logicielles via ComponentSource selon les termes du fournisseur. Si un nouveau développeur rejoint une équipe utilisant Barcode4NET, il n'y a aucun mécanisme pour acheter une place supplémentaire pour eux. La dernière version du code était la version 2.0 en 2007, donc tout défaut ou problème de sécurité découvert depuis cette version n'est pas traité par des correctifs.

Approche IronBarcode

IronBarcode est un produit commercial activement maintenu avec une licence perpétuelle. Les niveaux commencent à 749 $ pour une licence Lite mono-développeur, avec les niveaux Plus (1 499 $, 3 développeurs), Professional (2 999 $, 10 développeurs) et Illimité (5 999 $) disponibles. Tous les niveaux incluent un déploiement sans redevance. Les correctifs de sécurité, les corrections de bogues et les mises à jour de compatibilité avec les versions .NET sont déployés à un rythme de publication régulier. Un essai gratuit de 30 jours est disponible pour évaluation sans clé de licence.

Mise à niveau .NET bloquée

L'événement déclencheur le plus courant est un projet de modernisation .NET . Une équipe cible net8.0 dans leur .csproj, exécute la compilation, et rencontre un échec de chargement car Barcode4NETa été construit pour .NET Framework1.1 / 2.0 / 3.x et ne peut pas être référencé à partir d'une cible .NET moderne. À ce stade, l'équipe est confrontée à un choix binaire : revenir sur la modification du framework cible et rester sur .NET Framework, ou remplacer Barcode4NET. La migration ne peut être reportée sans bloquer l'effort de modernisation plus large.

Échecs des pipelines CI/CD suite à des modifications d'infrastructure

Le modèle de distribution de DLL de Barcode4NETcrée une fragilité latente dans les pipelines de compilation. Lorsqu'un agent de construction est reconfiguré, qu'une image de conteneur est mise à jour ou qu'un nouvel environnement CI est configuré, la DLL Barcode4NETdoit être placée manuellement à l'emplacement attendu par le fichier projet. Les équipes qui n'ont pas soigneusement documenté cette étape ne découvrent le problème que lorsque le processus échoue. Passer à Code-barres IronBarcode signifie dotnet restore gère tout — le problème de l'emplacement du DLL cesse d'exister.

Les nouveaux membres de l'équipe ne peuvent pas obtenir de licence.

Lorsqu'un sous-traitant rejoint le projet ou qu'un deuxième développeur doit travailler sur les fonctionnalités des codes-barres, aucune licence n'est à acheter. L'équipe doit contourner cette contrainte : soit le nouveau développeur évite complètement le code-barres, soit quelqu'un transfère une licence qui pourrait ne pas être légalement transférable selon les termes originaux. Aucune de ces situations n'est viable pour une équipe qui développe activement le produit.

Audits de sécurité et de conformité

Les organisations qui effectuent la génération de nomenclatures logicielles ou vérifient les dépendances par rapport aux bases de données en fin de vie découvrent Barcode4NET. C'est un produit commercial sans version de code depuis 2007 et sans suivi CVE ni flux de correctifs. Les auditeurs de sécurité traitent généralement les dépendances dans cet état différemment des bibliothèques activement maintenues, et la découverte devient souvent un élément de remédiation formel plutôt qu'un risque différé.

Ajout d'une fonctionnalité de lecture à un flux de travail existant

Les équipes qui utilisaient initialement Barcode4NETpour des flux de travail de génération uniquement découvrent par la suite qu'elles doivent vérifier les codes-barres des documents numérisés, traiter les images téléchargées par les utilisateurs ou extraire des données des factures PDF. Avec Barcode4NET, cela nécessite l'intégration d'une seconde bibliothèque. Le BarcodeReader.Read() d'IronBarcode gère à la fois les images et les PDFs nativement, consolidant la dépendance en un seul paquet maintenu.

Suppression de la référence DLL

Barcode4NET n'a jamais été distribué en tant que package NuGet, donc il n'y a pas de commande dotnet remove package. Chaque fichier .csproj qui référence la bibliothèque contient un élément <Reference Include="Barcode4NET"> avec un <HintPath> pointant vers le DLL sur le disque. Chacun de ces éléments doit être trouvé et supprimé manuellement. Une recherche grep sur la solution permet de les localiser :

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

Le répertoire DLL dans le contrôle de version — normalement ThirdParty/Barcode4NET/ ou lib/ — doit également être préparé pour suppression avec git rm.

Changement du type de retour : de Bitmap à tableau d'octets

Le GenerateBarcode() de Barcode4NETretourne un System.Drawing.Bitmap. La chaîne fluide d'IronBarcode se termine par .ToPngBinaryData() retournant byte[], ou .SaveAsPng() écrivant directement sur le disque. Le code qui assigne la valeur de retour à une variable de type Bitmap ou la passe à une méthode qui attend un Bitmap — tel qu'un PictureBox WinForms — nécessite une correction en une ligne au site d'appel : envelopper le tableau d'octets dans un MemoryStream et appeler Image.FromStream().

Symbologie Enum Renommer

L'enum Symbology dans Barcode4NETs'aligne directement avec l'enum BarcodeEncoding dans IronBarcode. Toutes les valeurs communes — Code128, Code39, EAN13, UPCA, QRCode — conservent leurs noms. Un remplacement solution-wide de Symbology. avec BarcodeEncoding. couvre la plupart des cas, même si chaque remplacement devrait être revu pour confirmer le contexte.

Nettoyage du script de compilation

Les scripts de compilation et les fichiers de configuration CI/CD qui copient la DLL Barcode4NETdans les répertoires de sortie ou les agents de compilation doivent être mis à jour. Ces étapes n'ont pas d'équivalent après la migration NuGet — dotnet restore remplace toute gestion manuelle de DLL. Laisser en place des étapes de copie de DLL obsolètes après la migration n'entraînera pas d'échecs de compilation, mais elles représentent une configuration morte qui crée de la confusion pour les futurs responsables de la maintenance.