C# Generate BarCode from String : Tutoriel complet avec IronBarcode

Comment installer IronBarcode dans un projet .NET ?

L'installation IronBarcode ne prend que quelques secondes, que ce soit via l'interface de ligne de commande .NET ou le gestionnaire de packages NuGet intégré à Visual Studio.

Option 1 -- Interface de ligne de commande .NET (recommandée for .NET 10) :

dotnet add package Barcode

dotnet add package Barcode

Option 2 -- Console du gestionnaire de packages NuGet dans Visual Studio :

Install-Package BarCode

Vous pouvez également rechercher "IronBarcode" dans l'interface graphique du gestionnaire de packages NuGet et installer le package officiel. La bibliothèque cible .NET Framework 4.6.2+ et.NET 5 à .NET 10 , assurant ainsi la compatibilité avec les charges de travail .NET modernes.

Après l'installation, ajoutez une seule directive using en haut de chaque fichier qui génère ou lit des codes-barres :

using IronBarCode;

using IronBarCode;

Cette directive expose BarcodeWriter, BarcodeReader, BarcodeEncoding, et les autres types publics couverts dans ce guide.

Comment générer un code-barres simple à partir d'une chaîne de caractères en C# ?

La méthode BarcodeWriter.CreateBarcode est le point d'entrée pour la génération de codes-barres. Passez la chaîne que vous souhaitez encoder avec une valeur BarcodeEncoding et vous obtenez en retour un objet GeneratedBarcode prêt à être enregistré ou manipulé ultérieurement.

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

Quels sont les formats de codes-barres pris en charge par IronBarcode?

IronBarcode prend en charge plus de 20 types de codes-barres pour différents cas d'utilisation. Le choix du format approprié garantit une numérisation correcte et une capacité de données adéquate pour l'application.

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

Comment personnaliser et styliser les images de codes-barres en C# ?

Au-delà de la génération de codes-barres de base, IronBarcode propose une API de style fluide permettant d'ajuster les couleurs, d'ajouter des annotations et de redimensionner les images de codes-barres sans aucune bibliothèque de traitement d'images externe.

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

Comment générer plusieurs codes-barres à partir de données de base de données ?

Dans la pratique, les applications nécessitent fréquemment la génération de codes-barres pour des collections d'articles : catalogues de produits, réapprovisionnements de stock ou flux de travail d'expédition des commandes. IronBarcode gère le traitement par lots sans aucune configuration supplémentaire.

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

Comment enregistrer et exporter des codes-barres dans différents formats de fichiers ?

GeneratedBarcode propose une gamme de méthodes d'enregistrement couvrant les formats d'image les plus courants utilisés dans les applications professionnelles :

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(ImageFormat.Png).ToArray();

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(ImageFormat.Png).ToArray();

Le choix du format approprié dépend du consommateur final. Le format PNG convient parfaitement aux étiquettes et documents prêts à imprimer. Le format JPEG convient aux applications où la taille du stockage est une contrainte. Pour intégrer directement des codes-barres dans des documents PDF , IronBarcode s'intègre à IronPDF pour estampiller ou insérer des images de codes-barres par programmation.

La surcharge ToStream est particulièrement précieuse dans les API Web et les fonctions cloud où l'écriture sur disque n'est pas souhaitable. Le tableau d'octets peut être stocké dans une colonne BLOB d'une base de données, téléchargé sur un stockage cloud ou transmis directement à une réponse HTTP sans aucun fichier intermédiaire sur le système de fichiers.

Comment valider des données de type chaîne de caractères avant l'encodage ?

Toutes les chaînes de caractères ne sont pas valides pour tous les formats de code-barres. Le code UPC-A exige exactement 12 chiffres numériques, le code EAN-13 en exige 13, et certains formats 1D rejettent les caractères en dehors d'un sous-ensemble ASCII limité. La transmission de données invalides à CreateBarcode génère une erreur IronBarCodeEncodingException. Encadrer l'appel dans un bloc try/catch et valider les entrées au préalable permet d'éviter les exceptions non gérées en production :

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

Comment lire un code-barres à partir d'une valeur de type chaîne de caractères ?

La génération d'un code-barres ne représente que la moitié du processus dans de nombreux systèmes. L' API de lecture de codes-barres utilise BarcodeReader.Read pour décoder une image et retrouver la chaîne d'origine.

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Format detected: {result.BarcodeType}");
}

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Format detected: {result.BarcodeType}");
}

Cela simplifie la création de flux de travail aller-retour pour les codes-barres : générer un code-barres à partir d'une fiche produit, l'enregistrer sur disque ou dans la file d'attente d'une imprimante d'étiquettes, puis scanner ultérieurement l'étiquette physique et décoder la valeur pour retrouver la fiche. Pour la lecture des codes-barres à partir de fichiers PDF ou de flux vidéo en direct , IronBarcode propose des méthodes dédiées avec la même API simple d'utilisation.

Comment utiliser IronBarcode dans les API Web ASP.NET Core ?

IronBarcode fonctionne au sein des contrôleurs ASP.NET Core et des gestionnaires d'API minimaux. Le modèle le plus courant renvoie une image de code-barres sous forme de fichier ou d'URI de données encodées en base64 pour l'affichage dans le navigateur.

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(ImageFormat.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(ImageFormat.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

Ce point de terminaison génère un code-barres à la demande pour toute valeur transmise dans le chemin d'URL. Pour les déploiements en production, ajoutez une mise en cache afin que les requêtes répétées pour la même valeur de code-barres ne régénèrent pas l'image. Consultez le tutoriel complet sur la génération de codes-barres ASP.NET pour une présentation plus détaillée incluant l'injection de dépendances et la mise en cache des réponses.

Quelles sont vos prochaines étapes ?

Générer des codes-barres à partir de données de type chaîne en C# est simple avec IronBarcode. L'API fluide gère la complexité de l'encodage des codes-barres tout en offrant une flexibilité pour la personnalisation et le traitement par lots. Que l'objectif soit de simples codes-barres Code 128 pour l'inventaire ou des codes QR pour les applications mobiles, IronBarcode offre une fonctionnalité de code-barres fiable pour les applications .NET .

Pour aller plus loin :

Téléchargez IronBarcode et exécutez localement les exemples de code de ce guide.

• Achetez une licence pour le déploiement en production ; les licences incluent une période d'essai gratuite.
• Consultez la documentation pour obtenir des informations de référence sur l'API, la configuration avancée et les notes spécifiques à la plateforme.
• Découvrez des exemples de code couvrant la génération de codes QR, la lecture de codes-barres, l'intégration de fichiers PDF, et bien plus encore.
• Intégration des codes-barres dans ASP.NET : guide complet pour l'affichage des codes-barres dans les vues MVC et les pages Razor
• Intégration d'un lecteur de codes-barres : lecture des codes-barres à partir d'images, de PDF et de lecteurs USB en C#

Commencez avec IronBarcode maintenant.

Commencer gratuitement