Wie man Barcodes in C# mit IronBarcode generiert

Wie installiert man eine Barcode-Generator-Bibliothek mit dem NuGet Paketmanager?

Öffnen Sie Visual Studio und installieren Sie das NuGet-Paket mit diesem Befehl in der Paketmanager-Konsole:

Install-Package BarCode

Das NuGet Paket unterstützt .NET 10, .NET 8, .NET 6, .NET Core, .NET Standard und .NET Framework – und ist somit mit Windows-Anwendungen und plattformübergreifenden .NET Anwendungen kompatibel. IronBarcode unterstützt die Bereitstellung auf Docker-Containern, Azure und Linux-Servern. Weitere Details und Referenzdokumentation finden Sie auf der IronBarcode -Dokumentationsseite und im Iron Software GitHub Projekt .

Nach der Installation steht Ihnen der Namespace IronBarCode in Ihrem Projekt zur Verfügung. Die Bibliothek benötigt unter Windows keine zusätzlichen Laufzeitabhängigkeiten. Unter Linux müssen Sie möglicherweise einige Systembibliotheken installieren, wie im IronBarcode Linux-Bereitstellungsleitfaden beschrieben.

Wie generiert man eine einfache Barcode-Bilddatei in C#?

Erstellen Sie Barcode-Bilder mit nur ein paar Zeilen Code. Das folgende Beispiel zeigt die Erzeugung von Barcodes, die als PNG-Bilddatei gespeichert werden:

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

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

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

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

Die Methode BarcodeWriter.CreateBarcode() akzeptiert eine zu kodierende Zeichenkette und das Barcode-Format von BarcodeWriterEncoding. Die zurückgegebene Referenz GeneratedBarcode bietet Styling-Methoden und Exportoptionen zum Speichern als PNG, JPEG, BMP, TIFF, PDF oder HTML.

Wie erstellt man einen QR-Code und andere 2D-Barcode-Typen?

IronBarcode unterstützt alle gängigen Barcode-Formate, einschließlich 2D-Barcodes wie QR-Code und Data Matrix. Generieren Sie einen QR-Code mit ähnlicher Syntax:

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

QR-Code-Barcodes eignen sich hervorragend zum Speichern von URLs und größeren Datenmengen. Die Bibliothek sorgt für eine automatische Fehlerkorrektur und stellt sicher, dass der Barcode auch bei teilweiser Beschädigung noch lesbar ist. Standardmäßig verwendet IronBarcode die Fehlerkorrekturstufe M (mittel), die einen Datenverlust von etwa 15 % ausgleicht. Für gedruckte Barcodes, die zerkratzt oder teilweise verdeckt sein könnten, kann diese Stufe auf H erhöht werden.

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

Wie erstellt man einen formatierten QR-Code mit erweiterten Gestaltungsoptionen?

Professionelle Barcode-Generierung erfordert oft erweiterte Styling-Optionen, um Farben anzupassen und Anmerkungen hinzuzufügen. Die Klasse GeneratedBarcode bietet eine flüssige API mit Styling-Methoden:

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

Mit der flüssigen API können Sie Styling-Methoden verketten, um Farben anzupassen, Ränder festzulegen und Text in einer einzigen Anweisung hinzuzufügen. Die Methode Verify() gibt an, ob Ihr Barcode auch nach der Verwendung nicht standardmäßiger Farben oder der Verkleinerung der Abmessungen maschinenlesbar bleibt und somit ein ordnungsgemäßes Scannen in der Produktion gewährleistet ist.

Wenn die Farbe des Barcodes in einen sehr hellen Farbton oder ein kontrastarmes Blau vor weißem Hintergrund geändert wird, kann dies dazu führen, dass der Barcode nicht gescannt werden kann. Rufen Sie nach jedem Farbwechsel immer Verify() an. Falls die Überprüfung fehlschlägt, erhöhen Sie entweder den Kontrast oder kehren Sie zu schwarzen Balken zurück. Der Leitfaden zur Barcode-Gestaltung und -Anpassung beschreibt alle verfügbaren Stilmethoden im Detail.

Um mehrere Barcodes mit einheitlichem Styling für einen gesamten Katalog zu generieren, erstellen Sie eine Hilfsmethode, die Ihre Standard-Styling-Kette auf jede GeneratedBarcode-Instanz anwendet. Dieses Verfahren gewährleistet einheitliche Ränder, Schriftgröße und Farbe bei Tausenden von generierten Bildern.

Wie exportiert man Barcodes in verschiedene Bildformate?

Generieren Sie Barcode-Bilder in verschiedenen Formaten für unterschiedliche Anwendungsfälle. Die Bibliothek kann in PNG, JPEG, BMP, TIFF, PDF und HTML gespeichert werden:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

Die Methode ToStream() gibt Barcode-Daten zurück, die mit ASP.NET Core Web-APIs und Blazor Anwendungen kompatibel sind. Die Methode ToBitmap() bietet eine System.Drawing.Bitmap Referenz für die weitere Bildbearbeitung. Informationen zum Einfügen von Barcodes in bestehende PDF-Dokumente finden Sie im IronBarcode PDF-Barcode-Tutorial .

Welche plattformübergreifenden .NET -Umgebungen unterstützt IronBarcode ?

IronBarcode unterstützt die Barcode-Generierung auf allen gängigen .NET Plattformen. Bereitstellen für:

Der IronBarcode Docker-Setup-Leitfaden enthält Details zu den erforderlichen Systembibliotheken für containerisierte Bereitstellungen. Bei der Ausführung unter Linux benötigen Sie in der Regel libgdiplus und libc6-dev in Ihrem Docker-Image. Unter Alpine Linux wird ein etwas anderer Satz von Paketen benötigt - die Anleitung behandelt sowohl Ubuntu/Debian als auch Alpine Dockerfiles.

Für AWS Lambda-Bereitstellungen erklärt die AWS Lambda-Bereitstellungsanleitung , wie native Abhängigkeiten im Bereitstellungspaket gebündelt und Speichergrenzen konfiguriert werden, um Barcode-Rendering-Workloads zu bewältigen.

Wie befolgt man Best Practices für die Barcode-Generierung in .NET?

Die Einhaltung einheitlicher Vorgehensweisen bei der Generierung von Barcode-Bildern in C#-Anwendungen macht den Unterschied zwischen Barcodes, die im Außendienst zuverlässig gescannt werden können, und solchen, die an der Verkaufsstelle oder im Lager versagen. Die nachfolgenden Richtlinien gelten unabhängig davon, welches Barcode-Format Sie wählen.

Wählen Sie das passende Barcode-Format für Ihren Anwendungsfall. Wählen Sie ein Format, das zu Ihrer Scanumgebung und Ihren Datenanforderungen passt. Verwenden Sie QR-Codes für URLs und Datenpakete mit mehr als 80 Zeichen. Verwenden Sie Code 128 für Inventur und Logistik, wenn alphanumerische Daten in ein kompaktes lineares Symbol passen müssen. Verwenden Sie EAN-13 oder UPC-A für Einzelhandelsprodukte, die im GS1-System registriert werden müssen. Die Barcode-Formatvergleichsseite von IronBarcode bietet eine Übersicht aller unterstützten Typen, ihrer Kapazitätsgrenzen und empfohlenen Anwendungsfälle.

Achten Sie stets auf ausreichend Ruhezonen. Der weiße Bereich um einen Barcode – die sogenannte Ruhezone – ist genauso wichtig wie die Balken selbst. Scanner nutzen es, um zu erkennen, wo das Symbol beginnt und endet. Verwenden Sie die Methode SetMargins(), um für die digitale Anzeige auf jeder Seite mindestens 10 Pixel Abstand und für die Druckausgabe mindestens 2,5 mm hinzuzufügen. Das Eindringen in die Ruhezone ist eine der häufigsten Ursachen für Scanfehler in der Produktion.

Nach jeder Formatänderung überprüfen. Nach dem Anpassen von Farben, dem Anwenden von Farbverläufen oder dem Ändern der Größe auf eine nicht standardmäßige Dimension rufen Sie Verify() für das GeneratedBarcode-Objekt auf. Wenn die Funktion "false" zurückgibt, kann Ihr Barcode mit Standardhardware nicht zuverlässig gescannt werden. Entweder den Kontrast erhöhen oder die Komplexität der Stiländerung reduzieren.

Verwenden Sie Stapelverarbeitungsmuster für große Ausgabemengen. Wenn Ihre Anwendung Tausende von Barcodes generiert – beispielsweise Produktetiketten oder Versandmanifeste –, verarbeiten Sie diese in einer Schleife und verwenden Sie dieselbe Formatierungskonfiguration wieder. Vermeiden Sie das Laden von Schriftarten oder Konfigurationsobjekten innerhalb der Schleife, da dies unnötigen Overhead verursacht. Das Beispiel zur Stapelbarcode-Generierung von IronBarcode demonstriert ein effizientes Schleifenmuster mit konsistenter Ausgabe.

Testen Sie verschiedene Scannermodelle und Lichtverhältnisse. Barcode-Scanner unterscheiden sich in ihrer Toleranz gegenüber kontrastarmen Farben, kleinen Modulgrößen und der Druckqualität. Testen Sie gedruckte Barcodes vor der Verwendung mit mindestens zwei verschiedenen Scannertypen. Bei QR-Codes, die auf Bildschirmen angezeigt werden, testen Sie diese mit Handykameras sowohl bei hellem als auch bei schwachem Licht. Die GS1-Seite zu den Barcode-Verifizierungsstandards bietet eine maßgebliche Anleitung zur Bewertung der Symbolqualität von Barcodes im Einzelhandel.

Beachten Sie die Datenkapazitätsgrenzen. Jedes Barcode-Format hat eine maximale Datenkapazität. Mit Code 128 lassen sich bis zu etwa 48 Zeichen problemlos kodieren, bevor das Symbol zu breit wird, um bei Standardetikettengrößen gedruckt werden zu können. Die Kapazität eines QR-Codes hängt vom Fehlerkorrekturniveau ab – auf Niveau H beträgt das Maximum etwa 1.273 alphanumerische Zeichen. Wird die Kapazität überschritten, ist die Bibliothek gezwungen, entweder eine Ausnahme auszulösen oder die Qualität stillschweigend zu verschlechtern. Eine Kurzübersicht über die Kapazität von QR-Code-Daten finden Sie auf Wikipedia unter dem Stichwort "QR-Code-Datenkapazitätsreferenz" .

Folgen Sie den .NET -Dispose-Mustern. Der Stream GeneratedBarcode und alle von ToStream() zurückgegebenen Streams implementieren IDisposable. Um nicht verwaltete Ressourcen schnell freizugeben, sollten sie in using-Anweisungen eingeschlossen werden, insbesondere in Webanwendungen mit hohem Durchsatz, bei denen die Barcode-Generierung pro Anfrage erfolgt.

Das Verständnis häufiger Fehlermodi hilft Ihnen auch dabei, robusteren Generierungscode zu entwickeln. Die drei häufigsten Ursachen für Scanfehler sind: unzureichende Ruhezone, zu ähnliche Balkenfarbe wie Hintergrundfarbe und Barcode, der unterhalb der minimalen Modulgröße für das gewählte Format skaliert ist. Die Methode Verify() von IronBarcode fängt alle drei zur Laufzeit ab.

Informationen zum Auslesen von Barcodes aus generierten Bildern – für Roundtrip-Tests oder zum Scannen hochgeladener Dateien – finden Sie im IronBarcode Barcode-Lesegerät-Leitfaden . Die Reader-API spiegelt die Writer-API in ihrer Einfachheit wider und unterstützt die gleiche breite Palette an Formaten.

Die technischen Spezifikationen, denen IronBarcode entspricht, sind in der Norm ISO/IEC 15417 für Code 128 und in der Norm ISO/IEC 18004 für QR-Codes definiert. Die Überprüfung des relevanten Standards für Ihren Ziel-Barcodetyp hilft Ihnen, die Einschränkungen zu verstehen, innerhalb derer die Bibliothek arbeiten muss.

Was sind Ihre nächsten Schritte?

Dieser Leitfaden behandelte die Generierung von Barcode-Bildern in C# mit IronBarcode – von der NuGet Installation über die Generierung von Code 128, QR-Code und EAN-13 bis hin zu fortgeschrittenem Styling mit der Fluent API, dem Export in verschiedene Formate, der plattformübergreifenden Bereitstellung und Best Practices für die Produktion.

Um weiter ins Detail zu gehen, können Sie diese Ressourcen nutzen:

• IronBarcode vollständige API-Referenz -- vollständige Methodendokumentation für BarcodeWriter, GeneratedBarcode und alle Aufzählungen
• IronBarcode Barcode-Lesegerät-Tutorial – Lesen und Dekodieren von Barcodes aus Bildern, PDFs und Datenströmen
• Beispiel für die Stapelgenerierung von Barcodes – Generierungsmuster für große Mengen im Rahmen von Etikettendruck- und Versandprozessen -IronBarcode Lizenzierung und Preisgestaltung -- Optionen ab $799

Laden Sie IronBarcode herunter, um Ihren .NET Anwendungen Barcode-Funktionalität hinzuzufügen, oder starten Sie eine kostenlose 30-Tage-Testversion, um Barcode-Bilder in Ihrer Umgebung ohne Lizenzschlüssel zu generieren.