Comment générer des images de codes-barres dans les applications C# .NET

Comment installer une bibliothèque de génération de codes-barres en C# ?

L'installation d'IronBarcode ne prend que quelques secondes grâce au gestionnaire de packages NuGet. Vous pouvez l'installer directement via la console du gestionnaire de packages ou télécharger la DLL manuellement.

Install-Package BarCode

IronBarcode offre des fonctionnalités complètes de génération de codes-barres pour les développeurs .NET

Comment générer un code-barres simple en utilisant C# ?

La création de votre premier code-barres ne nécessite que deux lignes de code. L'exemple ci-dessous illustre la génération d'un code-barres Code128 standard et son enregistrement sous forme de fichier image.

using IronBarCode;

// Create a barcode with your desired content and encoding type
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
myBarcode.SaveAsPng("myBarcode.png");

// Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("myBarcode.png") { UseShellExecute = true });

using IronBarCode;

// Create a barcode with your desired content and encoding type
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
myBarcode.SaveAsPng("myBarcode.png");

// Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("myBarcode.png") { UseShellExecute = true });

Imports IronBarCode

' Create a barcode with your desired content and encoding type
Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Code128)

' Save the barcode as a PNG image file
myBarcode.SaveAsPng("myBarcode.png")

' Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(New System.Diagnostics.ProcessStartInfo("myBarcode.png") With {.UseShellExecute = True})

La méthode BarcodeWriter.CreateBarcode() est votre point d'entrée pour la génération de codes-barres. Il accepte deux paramètres : les données à encoder et le format du code-barres issu de l'énumération BarcodeWriterEncoding . IronBarcode prend en charge tous les principaux formats de codes-barres, notamment Code128, Code39, EAN13, UPC-A, PDF417, DataMatrix et les codes QR.

Une fois généré, l'objet GeneratedBarcode offre plusieurs options d'exportation. Vous pouvez l'enregistrer dans différents formats d'image (PNG, JPEG, GIF, TIFF), l'exporter au format PDF, ou même la récupérer en tant que System.Drawing.Bitmap pour un traitement ultérieur dans votre application.

A Code128 barcode generated with IronBarcode displaying a URL

Puis-je personnaliser l'apparence des codes-barres générés ?

IronBarcode offre de nombreuses options de personnalisation qui vont bien au-delà de la simple génération de codes-barres. Vous pouvez ajouter des annotations, ajuster les couleurs, définir les marges et contrôler chaque aspect de l'apparence de votre code-barres.

using IronBarCode;
using IronSoftware.Drawing;

// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode", 
    BarcodeWriterEncoding.QRCode
);

// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");

// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();

// Set consistent margins around the barcode
myBarCode.SetMargins(100);

// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);

// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");

using IronBarCode;
using IronSoftware.Drawing;

// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode", 
    BarcodeWriterEncoding.QRCode
);

// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");

// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();

// Set consistent margins around the barcode
myBarCode.SetMargins(100);

// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);

// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");

Imports IronBarCode
Imports IronSoftware.Drawing

' Create a QR code with advanced styling options
Private myBarCode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.QRCode)

' Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:")

' Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode()

' Set consistent margins around the barcode
myBarCode.SetMargins(100)

' Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple)

' Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html")

La classe GeneratedBarcode offre un large éventail de méthodes de personnalisation :

• Annotations : Utilisez AddAnnotationTextAboveBarcode() et AddAnnotationTextBelowBarcode() pour ajouter des étiquettes ou des instructions personnalisées autour de votre code-barres
• Affichage de la valeur : La méthode AddBarcodeValueTextBelowBarcode() affiche automatiquement les données encodées dans un format lisible par l'homme.
• Espacement : Contrôlez les espaces blancs avec SetMargins() pour garantir une lecture fluide et un rendu visuel optimal.
• Couleurs : Modifiez les couleurs de premier plan et d'arrière-plan à l'aide de ChangeBarCodeColor() et ChangeBackgroundColor()
• Options d'exportation : Enregistrer sous forme de fichiers image, de PDF ou de documents HTML autonomes

Un code QR stylisé avec une couleur personnalisée et du texte d'annotation

Pour des options de personnalisation détaillées, consultez la documentation de la classe GeneratedBarcode qui couvre toutes les méthodes et propriétés de style disponibles.

Comment créer et exporter un code-barres en une seule ligne de code ?

IronBarcode met en œuvre un modèle de conception d'API fluide qui permet l'enchaînement de méthodes pour un code plus concis et lisible. Cette approche est particulièrement utile lorsque vous appliquez plusieurs transformations à votre code-barres.

using IronBarCode;
using IronSoftware.Drawing;

// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";

// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
    .CreateBarcode(value, BarcodeWriterEncoding.PDF417)  // Create PDF417 barcode
    .ResizeTo(300, 200)                                  // Set specific dimensions
    .SetMargins(10)                                      // Add 10px margins
    .ToBitmap();                                         // Convert to bitmap

// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;

using IronBarCode;
using IronSoftware.Drawing;

// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";

// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
    .CreateBarcode(value, BarcodeWriterEncoding.PDF417)  // Create PDF417 barcode
    .ResizeTo(300, 200)                                  // Set specific dimensions
    .SetMargins(10)                                      // Add 10px margins
    .ToBitmap();                                         // Convert to bitmap

// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;

Imports IronBarCode
Imports IronSoftware.Drawing

' Generate, style, and convert a barcode in a single statement
Private value As String = "https://ironsoftware.com/csharp/barcode"

' Create PDF417 barcode with chained operations
Private barcodeBitmap As AnyBitmap = BarcodeWriter.CreateBarcode(value, BarcodeWriterEncoding.PDF417).ResizeTo(300, 200).SetMargins(10).ToBitmap() ' Convert to bitmap

' Convert to System.Drawing.Bitmap for legacy compatibility
Private legacyBitmap As System.Drawing.Bitmap = barcodeBitmap

Le modèle d'API fluide offre plusieurs avantages :

• Lisibilité : Enchaîner les opérations dans une séquence logique qui se lit comme du langage naturel
• Efficacité : Réduire les déclarations de variables et les étapes intermédiaires
• Flexibilité : Ajoutez ou supprimez facilement des opérations sans restructurer votre code.

Les opérations courantes de fluidité comprennent :

• ResizeTo() : Contrôle les dimensions exactes du code-barres
• SetMargins(): Ajouter un espacement cohérent
• ChangeBarCodeColor() : Modifier l'apparence
• AddAnnotationTextAboveBarcode() : Inclure un texte descriptif
• ToBitmap() , SaveAsPng() , SaveAsPdf() : Exportation dans différents formats

A PDF417 barcode generated using fluent method chaining

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

IronBarcode prend en charge la génération complète de formats de codes-barres via l'énumération BarcodeWriterEncoding . Les formats pris en charge incluent :

Codes-barres 1D : Code128, Code39, Code93, Codabar, ITF, MSI, Plessey, UPCA, UPCE, EAN8, EAN13 Codes-barres 2D : QR Code, DataMatrix, PDF417, Aztec, MaxiCode Formats spécialisés : IntelligentMail, DataBar, DataBarExpanded et diverses normes GS1

Chaque format possède des caractéristiques et des cas d'utilisation spécifiques. Par exemple, les codes QR excellent dans le stockage d'URL et de grandes quantités de données, tandis que le format EAN13 est la norme pour les produits de détail. Apprenez-en davantage sur le choix du format de code-barres adapté à votre application.

Comment puis-je vérifier que mon code-barres généré est lisible ?

L'assurance qualité est essentielle pour la mise en œuvre des codes-barres. IronBarcode intègre une vérification pour garantir que vos codes-barres générés restent scannables :

// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
    .CreateBarcode("TEST123", BarcodeWriterEncoding.Code128)
    .ResizeTo(200, 100)
    .ChangeBarCodeColor(Color.DarkBlue);

// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");

// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
    .CreateBarcode("TEST123", BarcodeWriterEncoding.Code128)
    .ResizeTo(200, 100)
    .ChangeBarCodeColor(Color.DarkBlue);

// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");

' Generate and verify a barcode
Dim myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("TEST123", BarcodeWriterEncoding.Code128).ResizeTo(200, 100).ChangeBarCodeColor(Color.DarkBlue)

' Verify the barcode is still readable after modifications
Dim isReadable As Boolean = myBarcode.Verify()
Console.WriteLine($"Barcode verification: {(If(isReadable, "PASS", "FAIL"))}")

La méthode Verify() vérifie si votre code-barres reste lisible par machine après application de transformations telles que le redimensionnement ou le changement de couleur. Ceci est particulièrement important lorsqu'on utilise des couleurs non standard ou des tailles très petites.

Où puis-je trouver d'autres exemples de génération de codes-barres ?

Pour étendre vos capacités de génération de codes-barres, explorez ces ressources supplémentaires :

Prêt à générer des codes-barres professionnels dans votre application ?

IronBarcode simplifie la génération de codes-barres tout en offrant la flexibilité nécessaire aux applications professionnelles. Que vous ayez besoin de codes produits simples ou de codes-barres 2D complexes avec un style personnalisé, IronBarcode gère tout cela avec un minimum de code.

Téléchargez IronBarcode dès aujourd'hui et commencez à générer des codes-barres en quelques minutes. Besoin d'aide pour choisir la bonne licence ? Consultez nos options de licence ou demandez une clé d'essai gratuite pour tester IronBarcode dans votre environnement de production.