L'intégration de la génération de BarCodes dans une application web ASP.NET ouvre de puissantes possibilités pour la gestion des stocks, le suivi des produits et l'automatisation des documents. Ce tutoriel démontre comment générer des codes-barres dans un projet .NET Core en utilisant IronBarcode — une bibliothèque de codes-barres qui prend en charge plus de 30 formats, dont le code QR, Data Matrix, Code 128, et UPC A.
L'exemple rapide suivant montre comment créer un code-barres Code 128 et le renvoyer sous forme d'image PNG à partir d'une action de contrôleur MVC :
using IronBarCode;
using Microsoft.AspNetCore.Mvc;
public IActionResult GenerateBarcode(string data)
{
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
barcode.ResizeTo(400, 120);
barcode.AddBarcodeValueTextBelowBarcode();
byte[] barcodeBytes = barcode.ToPngBinaryData();
return File(barcodeBytes, "image/png");
}Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc
Public Function GenerateBarcode(data As String) As IActionResult
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128)
barcode.ResizeTo(400, 120)
barcode.AddBarcodeValueTextBelowBarcode()
Dim barcodeBytes As Byte() = barcode.ToPngBinaryData()
Return File(barcodeBytes, "image/png")
End FunctionDémarrez votre essai gratuit pour suivre le tutoriel complet avec les exemples de code ci-dessous.
L'ajout de capacités de génération de codes-barres à une application web ASP.NET Core nécessite l'installation du package NuGet IronBarcode. Ouvrez Visual Studio et utilisez la console du Package Manager pour installer les dépendances :
Ce package est compatible avec .NET Core 6, 7, 8, 10 et versions ultérieures, ainsi qu'avec .NET Framework 4.6.2 et versions ultérieures. La bibliothèque gère automatiquement toutes les dépendances, ne nécessitant aucune police de codes-barres supplémentaire ni configuration système. Une fois installé, ajoutez la référence d'espace de noms au fichier du contrôleur ou du service :
using IronBarCode;Imports IronBarCodeIronBarcode cible tous les environnements d'exécution modernes .NET :
Aucune bibliothèque GD externe, aucun codec natif ni aucune installation de police de codes-barres n'est requis. La bibliothèque est entièrement autonome et gère toute la logique d'encodage en interne.
Après avoir installé le package NuGet, référez-vous au namespace IronBarCode en haut de tout contrôleur, service ou modèle de page Razor où la génération de codes-barres est nécessaire :
using IronBarCode;
using Microsoft.AspNetCore.Mvc;Imports IronBarCode
Imports Microsoft.AspNetCore.MvcCette directive using unique donne accès à BarcodeWriter, QRCodeWriter, BarcodeReader, et tous les types de support pour à la fois générer et lire des codes-barres.
Créer des codes-barres dans un contrôleur MVC implique la classe BarcodeWriter de IronBarcode. L'exemple suivant illustre une action de contrôleur complète qui crée un code-barres Code 128 à partir d'une URL ou d'un texte fourni par un utilisateur :
using IronBarCode;
using Microsoft.AspNetCore.Mvc;
public class BarcodeController : Controller
{
public IActionResult GenerateBarcode(string data)
{
// Generate barcode from input data
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
data,
BarcodeWriterEncoding.Code128);
barcode.ResizeTo(400, 120);
barcode.AddBarcodeValueTextBelowBarcode();
// Return as image for display in browser
byte[] barcodeBytes = barcode.ToPngBinaryData();
return File(barcodeBytes, "image/png");
}
}Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc
Public Class BarcodeController
Inherits Controller
Public Function GenerateBarcode(data As String) As IActionResult
' Generate barcode from input data
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128)
barcode.ResizeTo(400, 120)
barcode.AddBarcodeValueTextBelowBarcode()
' Return as image for display in browser
Dim barcodeBytes As Byte() = barcode.ToPngBinaryData()
Return File(barcodeBytes, "image/png")
End Function
End Class
La méthode BarcodeWriter.CreateBarcode() accepte les données du code-barres comme premier paramètre et le format de codage en deuxième. Cette approche crée des codes-barres dynamiquement en fonction des données saisies par l'utilisateur ou des valeurs de la base de données.
Pour enregistrer les images de codes-barres dans un dossier de projet, utilisez la méthode SaveAsImage() :
barcode.SaveAsImage("wwwroot/images/generated-barcode.png");barcode.SaveAsImage("wwwroot/images/generated-barcode.png")La bibliothèque prend en charge plusieurs formats de sortie, notamment PNG, GIF, BMP, SVG et JPEG. Vous pouvez également exporter les codes-barres au format HTML pour les intégrer directement dans des pages web.
Pour retourner le code-barres comme un fichier téléchargeable plutôt qu'une image en ligne, définissez l'en-tête Content-Disposition dans la réponse :
public IActionResult DownloadBarcode(string data)
{
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
barcode.ResizeTo(400, 120);
byte[] pdfBytes = barcode.ToPdfBinaryData();
return File(pdfBytes, "application/pdf", "barcode.pdf");
}Public Function DownloadBarcode(data As String) As IActionResult
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128)
barcode.ResizeTo(400, 120)
Dim pdfBytes As Byte() = barcode.ToPdfBinaryData()
Return File(pdfBytes, "application/pdf", "barcode.pdf")
End FunctionCe modèle est utile pour la génération d'étiquettes d'expédition, les flux de travail d'étiquetage des produits et tout scénario où l'utilisateur final a besoin d'enregistrer ou d'imprimer directement un document de code-barres.
IronBarcode prend en charge plus de 30 formats. Voici les détails de la création des types les plus couramment utilisés :
// Create QR Code with custom size
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode(
"https://example.com/product/12345",
500,
QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("product-qr.png");' Create QR Code with custom size
Dim qrCode As GeneratedBarcode = QRCodeWriter.CreateQrCode( _
"https://example.com/product/12345", _
500, _
QRCodeWriter.QrErrorCorrectionLevel.Medium)
qrCode.SaveAsPng("product-qr.png")
La génération de codes QR prend en charge les niveaux de correction d'erreur qui déterminent dans quelle mesure le code peut être endommagé tout en restant lisible. Utilisez le niveau moyen ou élevé pour les applications de code QR imprimées où l'on s'attend à une usure physique. Découvrez plus d'informations sur les options de personnalisation des codes QR .
// Create Data Matrix barcode
GeneratedBarcode dataMatrix = BarcodeWriter.CreateBarcode(
"DMX-2024-001",
BarcodeWriterEncoding.DataMatrix);
dataMatrix.SaveAsGif("datamatrix.gif");' Create Data Matrix barcode
Dim dataMatrix As GeneratedBarcode = BarcodeWriter.CreateBarcode( _
"DMX-2024-001", _
BarcodeWriterEncoding.DataMatrix)
dataMatrix.SaveAsGif("datamatrix.gif")
Les codes-barres Data Matrix excellent dans les scénarios nécessitant un encodage compact et à haute densité. La bibliothèque génère également les formats PDF417, Aztec et MaxiCode . Ces types de BarCode 2D stockent beaucoup plus de données que les formats linéaires tout en conservant une précision de lecture fiable.
// Create UPC-A barcode for retail products
GeneratedBarcode upcBarcode = BarcodeWriter.CreateBarcode(
"012345678905",
BarcodeWriterEncoding.UPCA);
upcBarcode.SaveAsPng("upc-barcode.png");IRON VB CONVERTER ERROR developers@ironsoftware.com
Les codes-barres UPC A et EAN incluent une validation automatique de la somme de contrôle, empêchant les erreurs d'encodage lors du processus de génération du code-barres. Pour obtenir la liste complète des formats pris en charge, consultez le guide des formats de codes-barres .
La mise en forme des codes-barres pour une application web implique le réglage des couleurs, des polices, des marges et des annotations. L'API fluide facilite la personnalisation :
GeneratedBarcode styledBarcode = BarcodeWriter.CreateBarcode(
"STYLED-2024",
BarcodeWriterEncoding.Code128);
// Apply styling
styledBarcode.ResizeTo(450, 150);
styledBarcode.SetMargins(20);
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:");
styledBarcode.AddBarcodeValueTextBelowBarcode();
// Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png");
styledBarcode.SaveAsPdf("styled-barcode.pdf");Dim styledBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("STYLED-2024", BarcodeWriterEncoding.Code128)
' Apply styling
styledBarcode.ResizeTo(450, 150)
styledBarcode.SetMargins(20)
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue)
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:")
styledBarcode.AddBarcodeValueTextBelowBarcode()
' Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png")
styledBarcode.SaveAsPdf("styled-barcode.pdf")
La méthode SetMargins() ajoute des espaces blancs autour du code-barres pour une meilleure lisibilité par le scanner. Vous pouvez ajuster les paramètres de police du texte d'annotation, modifier la famille et la taille des polices, et personnaliser en profondeur le style des codes-barres . La bibliothèque affiche le texte à l'aide des polices système sans nécessiter de polices de codes-barres externes.
Pour les vues ASP.NET MVC, générez des codes-barres sous forme de chaînes Base64 pour une intégration HTML directe sans enregistrer de fichiers sur le disque :
public IActionResult DisplayBarcode()
{
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
"INV-2024-0042",
BarcodeWriterEncoding.Code128);
string base64Image = barcode.ToDataUrl();
ViewBag.BarcodeImage = base64Image;
return View();
}Public Function DisplayBarcode() As IActionResult
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("INV-2024-0042", BarcodeWriterEncoding.Code128)
Dim base64Image As String = barcode.ToDataUrl()
ViewBag.BarcodeImage = base64Image
Return View()
End Function
Dans la vue Razor, affichez-le dans un élément <div> :
<div class="barcode-container">
<img src="@ViewBag.BarcodeImage" alt="Generated Barcode" />
</div>
<div class="print-actions">
<button onclick="window.print()">Print Barcode</button>
</div>Cette approche élimine la nécessité d'enregistrer les images de codes-barres sur le système de fichiers, ce qui permet de conserver un service Web sans état. La documentation de référence complète de l'API recense toutes les méthodes et propriétés disponibles.
La lecture des codes-barres à partir d'images téléchargées ou de flux de fichiers est gérée par la classe BarcodeReader. Ceci est utile pour les flux de réception, le traitement des retours et tout scénario où un code-barres scanné doit être décodé côté serveur :
using IronBarCode;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
public class BarcodeScanController : Controller
{
public IActionResult ScanBarcode(IFormFile uploadedImage)
{
using var stream = uploadedImage.OpenReadStream();
var results = BarcodeReader.Read(stream);
if (results.Count > 0)
{
string decodedValue = results[0].Value;
return Ok(new { barcode = decodedValue });
}
return BadRequest("No barcode detected in image.");
}
}Imports IronBarCode
Imports Microsoft.AspNetCore.Http
Imports Microsoft.AspNetCore.Mvc
Public Class BarcodeScanController
Inherits Controller
Public Function ScanBarcode(uploadedImage As IFormFile) As IActionResult
Using stream = uploadedImage.OpenReadStream()
Dim results = BarcodeReader.Read(stream)
If results.Count > 0 Then
Dim decodedValue As String = results(0).Value
Return Ok(New With {.barcode = decodedValue})
End If
Return BadRequest("No barcode detected in image.")
End Using
End Function
End ClassLa méthode BarcodeReader.Read() accepte les chemins de fichiers, les flux, et les objets System.Drawing.Bitmap. Il détecte automatiquement le format du code-barres et renvoie une collection d'objets BarcodeResult, chacun contenant la valeur décodée, le type de format, et la position dans l'image. Lorsque plusieurs codes-barres apparaissent dans une même image (par exemple, sur la photo d'une étagère d'entrepôt), le lecteur renvoie toutes les valeurs détectées dans la collection, et non pas seulement la première.
Les performances sont également un facteur important à prendre en compte pour les applications ASP.NET à haut débit. Le lecteur prend en charge la numérisation de zones d'intérêt, qui recadre l'image à un rectangle de pixels spécifique avant l'analyse. Cela réduit considérablement le temps de traitement, car les codes-barres apparaissent toujours dans une zone connue de l'image.
Pour les scénarios avancés tels que le réglage du contraste pour les images de faible qualité ou le réglage de la sensibilité de détection, reportez-vous à la documentation sur la lecture des codes-barres .
L'intégration directe de codes-barres dans les documents PDF est une exigence courante pour les étiquettes d'expédition, les étiquettes d'entrepôt et les documents de conformité. IronBarcode prend en charge l'enregistrement directement au format PDF :
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
"SHIP-2024-99471",
BarcodeWriterEncoding.Code128);
barcode.ResizeTo(500, 150);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.SaveAsPdf("shipping-label.pdf");Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode( _
"SHIP-2024-99471", _
BarcodeWriterEncoding.Code128)
barcode.ResizeTo(500, 150)
barcode.AddAnnotationTextAboveBarcode("Shipping Label")
barcode.AddBarcodeValueTextBelowBarcode()
barcode.SaveAsPdf("shipping-label.pdf")Pour les documents PDF à codes-barres multiples (par exemple, une page d'étiquettes de produits), générez chaque code-barres séparément et combinez-les à l'aide d'une bibliothèque PDF. Le guide d'intégration IronPDF explique comment tamponner des codes-barres sur des modèles PDF existants, ce qui est utile pour ajouter des codes-barres à des mises en page d'étiquettes pré-conçues.
La méthode SaveAsPdf() accepte également les dimensions de sortie afin que la page PDF rendue corresponde à la taille physique de l'étiquette requise par les imprimantes d'étiquettes.
Les règles d'encodage des codes-barres varient selon le format. Par exemple, le code UPC-A exige exactement 11 ou 12 chiffres, le code EAN-13 en exige exactement 12 ou 13, et le code 128 a une limite pratique de 48 caractères pour une sortie lisible aux tailles standard. Passer des données non valides déclenche une IronBarCodeEncoderException.
Gérez explicitement les erreurs d'encodage dans les actions du contrôleur :
public IActionResult SafeGenerate(string data, string format)
{
try
{
var encoding = Enum.Parse<BarcodeWriterEncoding>(format, true);
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, encoding);
return File(barcode.ToPngBinaryData(), "image/png");
}
catch (IronBarCodeEncoderException ex)
{
return BadRequest($"Encoding error: {ex.Message}");
}
catch (ArgumentException ex)
{
return BadRequest($"Unknown format: {ex.Message}");
}
}Imports System
Public Function SafeGenerate(data As String, format As String) As IActionResult
Try
Dim encoding = [Enum].Parse(Of BarcodeWriterEncoding)(format, True)
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, encoding)
Return File(barcode.ToPngBinaryData(), "image/png")
Catch ex As IronBarCodeEncoderException
Return BadRequest($"Encoding error: {ex.Message}")
Catch ex As ArgumentException
Return BadRequest($"Unknown format: {ex.Message}")
End Try
End FunctionPour une utilisation en production, validez la longueur des données d'entrée et le jeu de caractères avant d'appeler CreateBarcode(). La documentation IronBarcode fournit des contraintes d'encodage spécifiques au format pour chaque type de code-barres pris en charge.
Construire un générateur de code-barres ASP.NET avec IronBarcode offre une solution fiable pour créer, styliser et exporter des images de codes-barres dans les applications Web .NET Core. La bibliothèque gère automatiquement les normes d'encodage complexes tout en offrant une personnalisation étendue grâce à une API conviviale pour les développeurs. Que ce soit pour générer des codes QR pour le balayage mobile, des codes-barres Data Matrix pour des applications industrielles, ou des codes UPC pour la vente au détail, IronBarcode s'intègre directement avec les contrôleurs ASP.NET MVC et les pages Razor.
Explorez ces ressources pour aller plus loin :
Vous pouvez tester l'ensemble des fonctionnalités pendant la période d'évaluation gratuite. Pour le déploiement en production et l'utilisation commerciale, consultez les options de licence afin de sélectionner la licence appropriée aux exigences de votre projet. La bibliothèque prend en charge les exportations bitmap et vectorielles, chaque version assurant la compatibilité avec les plateformes de déploiement Windows, Linux, Android et iOS.
Pour des questions, des benchmarks par rapport à d'autres bibliothèques de codes-barres pour .NET, ou le soutien d'intégration d'entreprise, visitez le portail de support IronBarcode.
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronBarcode fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin de lire, écrire, et styliser des Codes-barres, rapidement.
