Comment créer des images de codes-barres en C# ; avec IronBarcode
IronBarcode permet aux développeurs .NET de générer des images de codes-barres et de codes QR en C# avec une seule ligne de code, en prenant en charge plusieurs formats et types d'images. Créez des systèmes de gestion des stocks, des applications de vente au détail ou des solutions de traitement des documents grâce à une API robuste qui crée des codes-barres de qualité professionnelle pour une lecture fiable sur tous les principaux lecteurs.
Démarrage rapide: Créez et enregistrez un code-barres Code128 en une ligneUtilisez l'API à une seule ligne d'IronBarcode pour créer un code-barres Code128 à partir d'une chaîne et l'enregistrer sous forme d'image PNG. Commencez immédiatement : fournissez les données, choisissez l'encodage et la taille, et écrivez votre fichier image.
-
1Install IronBarcode with NuGet Package Manager
-
2Copiez et exécutez cet extrait de code.
IronBarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png");C# -
3Déployez pour tester sur votre environnement de production.
Commencez à utiliser IronBarcode dans votre projet dès aujourd'hui avec un essai gratuit
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque IronBarcode C#
- Générer des codes-barres et les enregistrer sous forme de fichiers image
- Générez des codes QR et enregistrez-les sous forme de fichiers image.
Comment générer des BarCodes et les enregistrer en tant que fichiers images?
Outre la lecture de codes-barres, IronBarcode permet aux utilisateurs d'écrire des codes-barres avec un minimum de codage. Appelez la méthode CreateBarcode() de la classe BarcodeWriter, en spécifiant la valeur, le type, la largeur et la hauteur du code-barres dans les paramètres de la méthode. Cela génère un objet GeneratedBarcode, qui peut être enregistré sous forme de fichier d'image en utilisant la méthode SaveAs().
Quels types de données puis-je utiliser pour les valeurs des BarCodes?
La méthode BarcodeWriter.CreateBarcode() accepte plusieurs types de données pour les valeurs de code-barres : byte[] array, MemoryStream, et string. La longueur des chaînes et les caractères acceptés varient selon le type de BarCode-voir notre documentation API pour plus de détails. Code128 prend en charge l'ensemble complet des caractères ASCII, tandis que UPC-A nécessite exactement 12 chiffres numériques. Pour les données binaires, utilisez byte[] array pour encoder des structures de données complexes.
Quels sont les types d'encodage de BarCode pris en charge?
IronBarcode prend en charge de nombreux formats de codes-barres - consultez notre article Formats de codes-barres pris en charge pour obtenir la liste complète. Les formats les plus courants sont les suivants :
- Codes-barres linéaires/1D :
Code128,Code39,UPC-A,UPC-E,EAN-8,EAN-13 - Codes-barres 2D :
QR Code,Data Matrix,PDF417,Aztec - Formats spécialisés :
MaxiCodepour l'expédition,Databarpour le commerce de détail
Chaque format répond à des besoins spécifiques. Code128 gère bien les données alphanumériques générales, tandis que les QR codes offrent une correction d'erreurs supérieure pour le balayage mobile.
Comment les paramètres de largeur et de hauteur affectent-ils mon BarCode?
Définissez les dimensions de l'image du code-barres de sortie en pixels. Les mesures par défaut sont 250 px pour les deux. Certains types de codes-barres (QR, PDF417) exigent des dimensions spécifiques pour la conformité. Lorsque les dimensions d'entrée ne correspondent pas aux exigences, le BarCode génère aux dimensions conformes, les espaces blancs remplissant l'espace restant. Les dimensions trop petites constituent une exception.
Pour une numérisation optimale :
- Codes-barres linéaires : Maintenir une largeur sensiblement supérieure à la hauteur
- Codes-barres 2D : Utiliser des dimensions carrées pour les codes QR (par exemple, 250x250)
- Qualité d'impression : des dimensions de pixels plus élevées améliorent la qualité d'impression à des tailles physiques plus importantes
Dans quels formats d'image puis-je exporter des BarCodes?
L'objet GeneratedBarcode à partir de BarcodeWriter.CreateBarcode() enregistre dans divers formats d'image en utilisant des méthodes spécifiques SaveAs() :
SaveAsGif(): Enregistre en tant que fichier d'image GIFSaveAsJpeg(): Enregistre en tant que fichier d'image JPEGSaveAsPng(): Enregistre en tant que fichier d'image PNG (recommandé pour le web)SaveAsTiff(): Enregistre en tant que fichier d'image TIFF (idéal pour archivage/impression)SaveAsWindowsBitmap(): Enregistre en tant que fichier d'image BMPSaveAsImage(): Méthode générale—spécifiez l'extension de format dans le chemin de fichier
En outre, exporter des codes-barres sous forme de flux pour le traitement en mémoire ou créer des codes-barres sous forme de documents PDF pour l'intégration de documents.
Comment générer un BarCode et l'enregistrer en tant que fichier image?
Utilisez BarcodeWriter.CreateBarcode() pour créer un code-barres Code128 et l'enregistrer sous forme d'image JPEG :
using IronBarCode;
// Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");
// Create a barcode with custom options
var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150);
// Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SetMargins(10);
// Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg");
myBarcode.SaveAsPng("product-barcode.png");Imports IronBarCode
' Create a basic barcode
BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")
' Create a barcode with custom options
Dim myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128, 300, 150)
' Apply styling
myBarcode.AddBarcodeValueTextBelowBarcode()
myBarcode.SetMargins(10)
' Save in multiple formats
myBarcode.SaveAsJpeg("product-barcode.jpg")
myBarcode.SaveAsPng("product-barcode.png")
Pour des options de style avancées, consultez notre guide sur la personnalisation des styles de codes-barres.
Comment générer des codes QR et les enregistrer en tant que fichiers image ?
Les codes QR, classés parmi les codes-barres bidimensionnels, sont entièrement pris en charge par IronBarcode. Leur polyvalence, leur attrait esthétique et leurs fonctions personnalisables ont conduit à leur adoption généralisée, des menus de restaurants aux systèmes de paiement.
La création de codes QR nécessite différentes méthodes en raison de leur complexité. Appelez la méthode CreateQrCode() de la classe QRCodeWriter, qui accepte 4 arguments : la valeur du code-barres, la taille de sortie du QR code, le champ Enum QRCodeWriter.QrErrorCorrectionLevel, et QRVersion.
Quels types de données puis-je utiliser pour les valeurs du code QR ?
QRCodeWriter.CreateQrCode() accepte des valeurs numériques, alphabétiques ou alphanumériques comme types byte[] array, MemoryStream, ou System.String. Les QR codes excellent à stocker :
- URLs : Rediriger les utilisateurs vers des sites web ou des pages de destination
- Texte : Stocker jusqu'à 4 296 caractères alphanumériques
- Données binaires : Encoder des fichiers ou des structures de données complexes
- Données structurées : vCards, informations d'identification WiFi ou de paiement
Pour la prise en charge d'Unicode et les caractères internationaux, consultez notre tutoriel écriture de codes-barres Unicode.
Comment définir la taille du code QR?
Spécifiez la taille du QR code directement en tant que type Int32 en pixels (px). La taille par défaut est de 500 px. Considérez ces facteurs :
- Médium d'affichage : Les affichages à l'écran nécessitent généralement 200-400px
- Applications d'impression : Utilisez 600px ou plus pour une impression de qualité
- Distance de lecture : Les codes de grande taille se lisent mieux à grande distance
Qu'est-ce que le niveau de correction d'erreur QR et pourquoi est-il important ?
QRErrorCorrectionLevel détermine la tolérance aux erreurs, avec quatre niveaux : Le plus élevé, Élevé, Moyen, et Faible. Des niveaux de correction plus élevés permettent de créer des codes QR plus complexes qui résistent aux erreurs de lecture, même lorsqu'ils sont endommagés ou partiellement masqués.
QRErrorCorrectionLevel.Highest
Génère le code QR le plus complexe avec une correction d'erreur de 30 %. Prise en charge de l'estampillage de logo ou de graphiques d'image. Idéal pour personnaliser des codes QR avec des logos.
QRErrorCorrectionLevel.High
Application d'une correction de 25 % des erreurs. Moins complexe que le niveau le plus élevé. Équilibre entre durabilité et capacité de données.
QRErrorCorrectionLevel.Medium
La correction d'erreurs s'élève à 15 %. Produit des codes QR plus rapidement mais avec plus de risques d'erreurs. Convient à la plupart des applications professionnelles avec une impression claire.
QRErrorCorrectionLevel.Low
Applique une correction d'erreur de 7 %, créant ainsi le code QR le moins complexe possible. À utiliser lorsqu'une capacité de données maximale est requise dans des conditions de numérisation optimales.
Quand dois-je utiliser différentes versions de QR?
La version QR (1-40) détermine la complexité du symbole et la capacité des données. Les versions supérieures produisent des codes plus complexes stockant davantage de données. Une version trop basse entraîne des problèmes d'encodage de grandes quantités de données. La version 0 attribue automatiquement la version appropriée en fonction de la valeur encodée. Voir QR Version pour plus d'informations.
Comment créer une image de code QR avec des paramètres spécifiques?
Utilisez QRCodeWriter.CreateQrCode() pour écrire un QR code et l'enregistrer sous forme d'image :
using IronBarCode;
// Basic QR code creation
QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");
// Advanced QR code with logo and custom styling
var qrCode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com", new QRCodeLogo("logo.png"), 500);
// Apply styling
qrCode.ChangeBarCodeColor(System.Drawing.Color.DarkBlue);
// Save in multiple formats
qrCode.SaveAsPng("styled-qr.png");
qrCode.SaveAsPdf("styled-qr.pdf");Le code encode une valeur alphanumérique à 250 pixels avec une correction d'erreur moyenne. La version 0 permet au programme de sélectionner la version appropriée du code QR. SaveAsJpeg() accepte le nom de fichier avec l'extension JPEG.
Bonnes pratiques pour la génération d'images de BarCodes
Pour les applications de production :
- Choisir le bon format : PNG pour le web, TIFF pour l'archivage, JPEG pour un usage général
- Tester la numérisation : Vérifiez les codes-barres avec plusieurs dispositifs de numérisation
- Appliquer les marges appropriées : Utilisez les paramètres de marge de code-barres pour une numérisation fiable
- Considérer la performance : Explorez les options asynchrones et multithread pour une génération à haut volume
Pour des exemples et des techniques supplémentaires, consultez notre tutoriel sur le générateur d'images de codes-barres C#.
Questions Fréquemment Posées
Comment créer une image de code-barres en C# à l'aide d'une seule ligne de code ?
Avec IronBarcode, vous pouvez créer une image de code-barres en une ligne à l'aide de la méthode BarcodeWriter.CreateBarcode(). Il vous suffit de transmettre vos données, le type d'encodage, la largeur et la hauteur, puis de l'enregistrer en tant que fichier image. Par exemple : BarCode.BarcodeWriter.CreateBarcode("Sample123", BarcodeEncoding.Code128, 250, 100).SaveAsPng("Barcode.png") ;
Quels types de données puis-je encoder dans des codes-barres ?
La méthode BarcodeWriter.CreateBarcode() d'IronBarcode accepte plusieurs types de données, notamment des tableaux d'octets, des MemoryStreams et des chaînes. La longueur des chaînes et les caractères acceptés varient selon le type de code-barres - le Code128 prend en charge l'ensemble des caractères ASCII, tandis que l'UPC-A exige exactement 12 chiffres. Pour les données binaires, vous pouvez utiliser des tableaux d'octets pour encoder des structures de données complexes.
Quels sont les formats de codes-barres pris en charge pour la génération d'images ?
IronBarcode prend en charge de nombreux formats de codes-barres, notamment les codes-barres linéaires/1D (Code128, Code39, UPC-A, UPC-E, EAN-8, EAN-13), les codes-barres 2D (QR Code, Data Matrix, PDF417, Aztec) et des formats spécialisés tels que MaxiCode pour l'expédition et Databar pour la vente au détail. Chaque format répond à des besoins spécifiques, le code 128 gérant les données alphanumériques générales et les codes QR offrant une correction d'erreur supérieure pour le balayage mobile.
Comment définir les dimensions de mon image de code-barres ?
Vous pouvez définir les dimensions de l'image du code-barres en pixels directement dans les paramètres de la méthode CreateBarcode(). IronBarcode utilise des mesures par défaut de 250px pour la largeur et la hauteur. Certains types de codes-barres tels que QR et PDF417 peuvent nécessiter des dimensions spécifiques pour être conformes, et la bibliothèque s'ajuste automatiquement lorsque les dimensions saisies ne correspondent pas aux exigences.
Sous quels formats de fichier image puis-je enregistrer mes BarCodes générés ?
IronBarcode vous permet d'enregistrer les codes-barres générés dans plusieurs formats d'image à l'aide de la méthode SaveAs(). Vous pouvez enregistrer au format PNG à l'aide de la méthode SaveAsPng(), ainsi que dans d'autres formats courants tels que JPEG, BMP et TIFF. L'objet GeneratedBarcode renvoyé par CreateBarcode() fournit diverses méthodes d'enregistrement pour différents types de fichiers.
Puis-je générer des codes QR ainsi que des codes-barres traditionnels ?
Oui, IronBarcode prend entièrement en charge la génération de codes QR, parallèlement aux codes-barres traditionnels. Vous pouvez créer des codes QR en utilisant la même méthode CreateBarcode() en spécifiant BarcodeEncoding.QRCode comme type d'encodage. Les codes QR offrent des avantages tels qu'une correction d'erreur supérieure et sont idéaux pour les applications de balayage mobiles.
What are the capabilities of QR codes generated using IronBarcode?
The QR codes generated by IronBarcode can store a variety of data types such as URLs, text, binary data, and structured data like vCards or WiFi credentials. They offer flexibility and customization for diverse applications.
How can I customize the appearance of barcode images with IronBarcode?
IronBarcode provides customization options like changing colors, adjusting margins, and applying text below the barcode. Additionally, you can embed logos within QR codes for branding purposes.
Why is it important to choose the correct image format for barcode generation?
Choosing the right image format ensures optimal quality for specific uses. For instance, PNG is best for web display, TIFF for archival purposes, and JPEG for general use. Proper format selection promotes reliable scanning and data integrity.
What best practices should I follow when generating barcode images with IronBarcode?
Best practices include choosing the right image format, testing barcodes with multiple scanners, setting proper margins, and considering performance needs by leveraging async and multithreading techniques for high-volume generation.
