Architecture de contrôle de génération uniquement

SfBarcode est un contrôle WinForms avec une API basée sur les propriétés : Text, Symbology, BarHeight, NarrowBarWidth, ShowText. L'affichage d'un code-barres sur un formulaire fonctionne comme prévu dans un concepteur WinForms. Générer un fichier de code-barres de manière programmatique nécessite le modèle DrawToBitmap, qui implique de préallouer un Bitmap des bonnes dimensions avant le rendu :

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

// Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "12345678";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;

barcode.Width = 400;
barcode.Height = 150;
using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("barcode.png", ImageFormat.Png);

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

// Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "12345678";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;

barcode.Width = 400;
barcode.Height = 150;
using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("barcode.png", ImageFormat.Png);

Imports Syncfusion.Windows.Forms.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

' Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

Dim barcode As New SfBarcode()
barcode.Text = "12345678"
barcode.Symbology = BarcodeSymbolType.Code128A
barcode.BarHeight = 100
barcode.NarrowBarWidth = 1
barcode.ShowText = True

barcode.Width = 400
barcode.Height = 150
Using bitmap As New Bitmap(barcode.Width, barcode.Height)
    barcode.DrawToBitmap(bitmap, barcode.ClientRectangle)
    bitmap.Save("barcode.png", ImageFormat.Png)
End Using

Ce modèle implique le chargement de l'environnement d'exécution Windows Forms dans chaque projet qui l'appelle, y compris les applications console, les services ASP.NET Core et les Azure Functions. La variante Blazor, SfBarcodeGenerator, est un composant Razor et n'a pas du tout de chemin de sortie de fichier côté serveur.

Comparaison détaillée des fonctionnalités

Approche de Syncfusion

SfBarcode est un contrôle WinForms. Son rôle est d'afficher un code-barres dans la mise en page visuelle d'un formulaire. Pour produire un fichier à partir de celui-ci, le développeur doit préallouer un Bitmap correspondant à la taille de sortie souhaitée, appeler DrawToBitmap, puis appeler Bitmap.Save. Chaque étape nécessite l'environnement d'exécution Windows Forms.

SfBarcodeGenerator pour Blazor est un composant Razor qui se rend dans le navigateur par le biais de la couche JavaScript Blazor de Syncfusion. Il n'y a pas d'API côté serveur sur SfBarcodeGenerator. La génération d'un code-barres téléchargeable à partir d'une application Blazor nécessite l'interopérabilité JavaScript et des déclencheurs de téléchargement du navigateur plutôt qu'un appel à l'API serveur.

Pour les applications MAUI, SfBarcodeGenerator rend les codes-barres dans le système de mise en page MAUI. La génération d'un code-barres sous forme de fichier pour transmission ou impression nécessite des étapes de traitement supplémentaires non prises en charge par le système de contrôle lui-même.

Approche IronBarcode

IronBarcode utilise une API statique et chaînable qui produit directement des fichiers de sortie. Le même modèle d'appel fonctionne dans n'importe quel modèle d'application .NET sans modification :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPng("barcode.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPng("barcode.png");

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPng("barcode.png")

La documentation relative à la génération de codes-barres 1D couvre toutes les symbologies et options de sortie prises en charge. Pas d'instanciation de contrôle, pas de Bitmap préalloué, et aucune dépendance de runtime Windows Forms.

Approche de Syncfusion

SfBarcode et SfBarcodeGenerator n'ont pas de capacité de lecture par conception. L'écosystème Syncfusion comble cette lacune grâce à Barcode Reader OPX, un produit commercial distinct disposant de sa propre licence et de son propre processus d'achat.

Le lecteur de codes-barres OPX utilise ZXing .NET en interne. ZXing .NET est une bibliothèque de lecture de codes-barres open source publiée sous la licence Apache 2.0. Apache 2.0 est une licence permissive qui autorise une utilisation commerciale sans restriction. Tout développeur peut installer ZXing .NET directement :

dotnet add package ZXing.Net

dotnet add package ZXing.Net

Le lecteur de code-barres OPX est licencié séparément des contrôles de code-barres Syncfusion. Un flux de travail de code-barres Syncfusion complet couvrant à la fois la génération et la lecture nécessite donc deux produits Syncfusion, deux accords de licence et deux surfaces API distinctes — avec le produit de lecture structuré sur un décodeur open-source disponible gratuitement.

Approche IronBarcode

La lecture des codes-barres est incluse dans le même package NuGet que leur génération. Aucun produit ou licence secondaire n'est requis :

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

La documentation sur la lecture des codes-barres couvre la détection de plusieurs codes-barres, le calcul du score de confiance, la lecture à partir de tableaux d'octets et le réglage du rapport vitesse/précision. La lecture des documents PDF est également native, sans nécessiter de bibliothèque PDF séparée.

Approche de Syncfusion

La licence communautaire Syncfusion offre un accès gratuit, mais impose quatre conditions d'éligibilité simultanées : un chiffre d'affaires annuel brut inférieur à 1 000 000 $, cinq développeurs ou moins, dix employés ou moins et un capital extérieur total inférieur à 3 000 000 $. Ces quatre conditions doivent être remplies en permanence. Les organisations gouvernementales financées par l'impôt ne sont pas éligibles. Franchir une condition crée une obligation immédiate de licence commerciale, et la transition de la Licence Communautaire à une licence commerciale passe de 0 $ à un abonnement annuel par développeur Essential Studio dont le montant est donné par les ventes de Syncfusion sur devis.

Au-delà des critères d'éligibilité, les clés de licence Syncfusion sont spécifiques à chaque version. Une clé émise pour Essential Studio 24.x n'est plus valide après la mise à niveau vers la version 25.x. Chaque mise à jour majeure de NuGet nécessite l'obtention d'une nouvelle clé depuis le portail de compte, la mise à jour des secrets d'environnement et un redéploiement afin d'éviter l'apparition de filigranes d'essai dans les résultats de production.

L'inscription à la plateforme ajoute des étapes supplémentaires. Une application Blazor nécessite trois entrées de configuration distinctes :

// Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

// Step 2: Service registration in Program.cs
builder.Services.AddSyncfusionBlazor();

// Step 3: Namespace imports in _Imports.razor
// @using Syncfusion.Blazor
// @using Syncfusion.Blazor.BarcodeGenerator

// Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

// Step 2: Service registration in Program.cs
builder.Services.AddSyncfusionBlazor();

// Step 3: Namespace imports in _Imports.razor
// @using Syncfusion.Blazor
// @using Syncfusion.Blazor.BarcodeGenerator

' Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

' Step 2: Service registration in Program.vb
builder.Services.AddSyncfusionBlazor()

' Step 3: Namespace imports in _Imports.razor
' @Imports Syncfusion.Blazor
' @Imports Syncfusion.Blazor.BarcodeGenerator

Les applications MAUI nécessitent une quatrième étape : builder.ConfigureSyncfusionCore().

Approche IronBarcode

L'activation de la licence Code-barres IronBarcode est une attribution unique, identique sur toutes les plateformes et tous les modèles d'application :

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

La page relative aux licences IronBarcode décrit le modèle de licence perpétuelle. Le guide de configuration des clés de licence couvre les modèles de variables d'environnement pour les déploiements CI/CD et Docker. La clé ne change pas entre les mises à jour mineures et les correctifs au sein d'une même version majeure, et aucun enregistrement de service spécifique à la plateforme n'est requis.

Approche de Syncfusion

Les commandes de codes-barres Syncfusion ne peuvent pas générer de sortie PDF. Intégrer un code-barres dans un document PDF en utilisant les outils Syncfusion nécessite de combiner le package de contrôle de code-barres avec Syncfusion.Pdf, de générer le code-barres sous forme de Bitmap via DrawToBitmap, puis d'insérer cette image en tant qu'élément d'image dans le modèle d'objet document PDF. Ce flux de travail implique deux produits Syncfusion distincts, deux packages NuGet et un pipeline de rendu en plusieurs étapes.

La lecture des codes-barres à partir de documents PDF existants n'est prise en charge ni par le contrôle des codes-barres ni par Barcode Reader OPX.

Approche IronBarcode

Le format PDF est un format de sortie de premier ordre dans IronBarcode. Aucune bibliothèque secondaire n'est requise :

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("barcode.pdf");

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("barcode.pdf");

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPdf("barcode.pdf")

La bibliothèque lit également les codes-barres directement à partir des documents PDF :

var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Dim pdfResults = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Le guide de génération de PDF avec codes-barres traite des sorties multipages et de l'intégration de codes-barres au sein d'autres contenus PDF.

Exigences de lecture des codes-barres

Une équipe travaillant entièrement avec WinForms ou Blazor peut commencer avec SfBarcode ou SfBarcodeGenerator à des fins d'affichage et recevoir ensuite la demande de scanner les codes-barres entrants provenant d'images téléchargées, de pièces jointes d'e-mails ou de captures caméra. À ce stade, la surface de contrôle Syncfusion n'offre aucune possibilité d'aller plus loin. La documentation de Syncfusion oriente les équipes vers Barcode Reader OPX, un achat commercial distinct qui encapsule ZXing .NET — une bibliothèque disponible gratuitement sous la licence Apache 2.0. Les équipes qui atteignent ce point souvent pèsent si ajouter un deuxième produit commercial ou regrouper la génération et la lecture dans une seule bibliothèque.

Génération côté serveur et côté serveur

Les applications qui débutent comme des outils de bureau WinForms ou WPF évoluent parfois pour inclure une couche API Web, un service de traitement en arrière-plan ou une fonction cloud qui doit générer des fichiers de codes-barres. SfBarcode implique une dépendance au runtime Windows Forms qui ne se traduit pas clairement par les services ASP.NET Core, les fonctions Azure ou les conteneurs Docker Linux. L'implémentation du motif DrawToBitmap nécessite une surface de rendu WinForms qui peut ne pas exister dans un environnement sans affichage. Les équipes qui atteignent ce niveau ont généralement besoin d'une bibliothèque dont le modèle de génération est découplé dès le départ de la pile de rendu de l'interface utilisateur.

Changements d'admissibilité aux licences communautaires

La licence communautaire de Syncfusion est particulièrement intéressante pour les jeunes équipes, précisément au moment où elles connaissent leur croissance la plus rapide. Les quatre conditions d'éligibilité simultanées — chiffre d'affaires, effectifs, nombre d'employés et capitaux levés — créent un obstacle à l'obtention de licences qui peut survenir soudainement. Un tour de table de série A permet généralement à une startup de franchir le seuil de capital de 3 000 000 $ le jour de sa clôture, déclenchant une obligation de licence commerciale quel que soit le nombre de développeurs ou les revenus. Les équipes qui ont construit leurs flux de production autour de la licence communautaire doivent tenir compte du coût et du calendrier de cette transition, en particulier lorsque la licence commerciale couvre la Suite Essential Studio complète et non seulement le composant de code-barres.

Réduction des coûts de configuration spécifiques à chaque version

Les équipes d'exploitation qui assurent la maintenance des applications Syncfusion dans les pipelines CI/CD sont confrontées à la rotation des clés de licence comme tâche récurrente liée aux mises à jour des versions de NuGet . Une clé valide pour Essential Studio 24.x cesse de fonctionner après la mise à niveau vers la version 25.x, ce qui implique la mise à jour des secrets dans chaque environnement de déploiement et la vérification que les filigranes d'essai n'apparaissent pas dans les résultats de production. Les équipes ayant des cadences de publication fréquentes ou plusieurs cibles de déploiement trouvent que cette surcharge de rotation est disproportionnée par rapport au bénéfice apporté, en particulier lorsque le cas d'utilisation sous-jacent consiste à générer une image de code-barres plutôt qu'à consommer une Suite complète de composants d'interface utilisateur.

Suppression de l'enregistrement du fournisseur de licences Syncfusion

L'appel de licence Syncfusion — SyncfusionLicenseProvider.RegisterLicense("KEY") — apparaît généralement dans Program.cs, App.xaml.cs, ou une méthode de démarrage d'application. Il doit être supprimé et remplacé par IronBarCode.License.LicenseKey = "KEY" au même point dans la séquence de démarrage. Les appels d'enregistrement de services associés (AddSyncfusionBlazor, ConfigureSyncfusionCore) et les importations de namespace dans _Imports.razor doivent également être supprimés si aucun autre composant Syncfusion n'est maintenu dans le projet.

Modèle SfBarcode vers BarcodeWriter

Le flux de travail SfBarcode implique l'instanciation de contrôle, l'attribution de propriétés, la spécification des dimensions et le rendu DrawToBitmap. L'équivalent Code-barres IronBarcode est un seul appel chaîné : BarcodeWriter.CreateBarcode(value, encoding).ResizeTo(w, h).SaveAsPng(path). Les valeurs de l'énumération BarcodeSymbolType se mettent en correspondance directement avec les valeurs BarcodeEncoding — Code128A se met en correspondance avec Code128, QRBarcode se met en correspondance avec QRCodeWriter.CreateQrCode.

Modèle de composant Blazor vers point de terminaison d'API

SfBarcodeGenerator est un composant Razor ; Le remplacer par Code-barres IronBarcode constitue un changement structurel plutôt qu'une substitution ligne par ligne. Le modèle Code-barres IronBarcode pour Blazor est un point final d'API minimal qui retourne une image de code-barres sous forme d'octets, référencée à partir du composant Razor via une balise <img src="..."> standard. Cette approche produit un point de terminaison côté serveur qui peut être testé indépendamment et réutilisé par différents clients, plutôt qu'un composant rendu par navigateur lié à la couche JavaScript Syncfusion Blazor .