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 wird das IronBarCode-Namespace in Ihrem Projekt verfügbar sein. 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 generieren Sie eine einfache Barcode-Bild-Datei 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");

Imports IronBarCode

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

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

Die BarcodeWriter.CreateBarcode()-Methode akzeptiert einen zu kodierenden String und das Barcode-Format von BarcodeWriterEncoding. Die zurückgegebene GeneratedBarcode-Referenz bietet Stilmethoden 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");

Imports IronBarCode

' Create a QR code and encode URL data
Dim 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");

Imports IronBarCode

' Generate an EAN-13 barcode compatible with UPC for retail print applications
Dim 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 GeneratedBarcode-Klasse bietet eine fließende API mit Stilmethoden:

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");

Imports IronBarCode
Imports IronSoftware.Drawing

' Create a styled barcode with advanced styling options
Dim 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
Dim isReadable As Boolean = styledBarcode.Verify()
Console.WriteLine($"Barcode verification: {(If(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 Verify()-Methode zeigt an, ob Ihr Barcode maschinenlesbar bleibt, indem sie sicherstellt, dass er in der Produktion nach dem Anwenden nicht standardmäßiger Farben oder beim Verkleinern zu kleinen Dimensionen richtig gescannt werden kann.

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 immer nach jeder Farbänderung Verify() auf. Falls die Überprüfung fehlschlägt, erhöhen Sie entweder den Kontrast oder kehren Sie zu schwarzen Balken zurück. Der Barcode-Styling- und Anpassungsleitfaden behandelt alle verfügbaren Style-Methoden im Detail.

Um mehrere Barcodes mit einheitlichem Stil über einen gesamten Katalog zu erzeugen, erstellen Sie eine Hilfsmethode, die Ihre Standard-Stilkette 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();

Imports IronBarCode

Dim 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
Dim barcodeStream As System.IO.Stream = barcode.ToStream()
Dim bitmapImage As System.Drawing.Bitmap = barcode.ToBitmap()

Die ToStream()-Methode gibt Barcode-Daten zurück, die mit ASP.NET Core-Web-APIs und Blazor-Anwendungen kompatibel sind. Die ToBitmap()-Methode bietet eine System.Drawing.Bitmap-Referenz für weitere Bildmanipulationen. Zum Stempeln von Barcodes auf vorhandene PDF-Dokumente sehen Sie das 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. Beim Ausführen unter Linux benötigen Sie typischerweise libgdiplus und libc6-dev in Ihrem Docker-Image installiert. 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. IronBarcode's Barcode-Format-Vergleichsseite bietet eine gegenübergestellte Referenz 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 SetMargins()-Methode, um auf jeder Seite mindestens 10 Pixel Rand für die digitale Anzeige und mindestens 2,5 mm für den Ausdruck zuzufügen. Das Eindringen in die Ruhezone ist eine der häufigsten Ursachen für Scanfehler in der Produktion.

Überprüfen Sie nach jeder Stiländerung. Nach dem Anpassen von Farben, dem Anwenden von Verläufen oder dem Ändern der Größe auf eine nicht standardmäßige Dimension, rufen Sie Verify() auf dem 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 IronBarcode-Massenbarcode-Generierungsbeispiel zeigt 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" .

Befolgen Sie die Dispose-Muster von .NET. Der GeneratedBarcode und alle von ToStream() zurückgegebenen Streams implementieren IDisposable. Umschließen Sie sie in using-Anweisungen, um nicht verwaltete Ressourcen schnell freizugeben, besonders in Web-Anwendungen mit hohem Durchsatz, bei denen Barcode-Erzeugung 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 Verify()-Methode von IronBarcode fängt alle drei zur Laufzeit ab.

Um Barcodes von generierten Bildern zurückzulesen -- für Rundreisetests oder das Scannen hochgeladener Dateien -- sehen Sie das IronBarcode Barcode-Reader-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-Reader-Tutorial -- Lesen und Dekodieren von Barcodes aus Bildern, PDFs und Streams
• Massenbarcode-Generierungsbeispiel -- Hochvolumen-Generierungsmuster für Etikettendruck- und Versand-Workflows
• IronBarcode Lizenzierung und Preisgestaltung -- Optionen ab $999

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.