Data-Matrix-Generator in C# – Vollständiges Tutorial mit Codebeispielen

Was macht Data-Matrix-Barcodes so besonders?

Data Matrix BarCodes sind 2D-Symbole, die Daten in einem Raster aus schwarzen und weißen Punkten kodieren, die in Zeilen und Spalten angeordnet sind. Im Gegensatz zu herkömmlichen linearen Barcodes wie UPC oder EAN können sie bis zu 2.335 alphanumerische Zeichen oder 3.116 numerische Ziffern auf einer Fläche von nur 10 x 10 Modulen speichern. Dank ihrer eingebauten Reed-Solomon-Fehlerkorrektur können sie von modernen Barcode-Scannern auch dann präzise gelesen werden, wenn bis zu 30 % des Symbols beschädigt sind.

Aufgrund dieser Eigenschaften eignet sich Data Matrix ideal für die Kennzeichnung von Kleinteilen, postalischen Barcodes und elektronischen Komponenten sowie für die Etikettierung im Gesundheitswesen und in Logistikzentren. Die Gesundheitsbranche nutzt GS1 Data Matrix-Standards zur Medikamentenverfolgung, während Hersteller diese in Produktionslinien integrieren, um Produkte weltweit zu identifizieren. Da ein einzelner Barcode so viele Daten speichern kann, werden sie mittlerweile international branchenübergreifend eingesetzt, um eine vollständige Rückverfolgbarkeit von Anwendungen zu gewährleisten.

Der ISO/IEC 16022-Standard regelt die Data-Matrix-Codierung und definiert die ECC200-Variante, die IronBarcode standardmäßig verwendet. ECC200 bietet die effizienteste Fehlerkorrektur und die größte Datenkapazität aller Data Matrix-Versionen und ist damit die richtige Wahl für neue Implementierungen.

Wie installiert man die Barcode-Bibliothek in einem C#-Projekt?

Die Installation von IronBarcode dauert mit dem NuGet Paketmanager weniger als eine Minute. Öffnen Sie die Paketmanager-Konsole in Visual Studio und führen Sie den Befehl aus:

Install-Package BarCode

Alternativ können Sie in der NuGet -Paketmanager-GUI nach "BarCode by Iron Software" suchen. Nach der Installation fügen Sie den Namespace zu Ihrer C#-Datei hinzu:

using IronBarCode;

using IronBarCode;

Das ist die gesamte erforderliche Einrichtung. IronBarcode übernimmt die gesamte komplexe Data-Matrix-Codierung intern gemäß dem ISO/IEC 16022-Standard, sodass Sie sich auf die Anwendungslogik konzentrieren können. Weitere Installationsoptionen wie Offline-Installation oder benutzerdefinierte Paketquellen finden Sie im IronBarcode -Installationshandbuch und auf der Seite zur erweiterten NuGet Installation .

Wie erstellt man seinen ersten Data-Matrix-Barcode?

Zum Generieren eines Data-Matrix-Barcodes wird nur eine Codezeile benötigt:

// Create a Data Matrix barcode with product information
var myBarcode = BarcodeWriter.CreateBarcode("PROD-12345-2024", BarcodeWriterEncoding.DataMatrix);

// Save as a high-quality PNG image
myBarcode.SaveAsImage("product-label.png");

// Create a Data Matrix barcode with product information
var myBarcode = BarcodeWriter.CreateBarcode("PROD-12345-2024", BarcodeWriterEncoding.DataMatrix);

// Save as a high-quality PNG image
myBarcode.SaveAsImage("product-label.png");

Dieser Code erstellt einen Data-Matrix-Barcode, der den Text PROD-12345-2024 kodiert, und speichert ihn als PNG-Datei. Der Parameter BarcodeWriterEncoding.DataMatrix weist IronBarcode an, das Data-Matrix-Format zu verwenden. Der resultierende Barcode wendet automatisch die ECC200-Spezifikation an, die eine integrierte Fehlerkorrektur beinhaltet und ein zuverlässiges Scannen unter realen Bedingungen gewährleistet.

// Get barcode as a bitmap for direct display in a UI control
var barcodeBitmap = myBarcode.ToBitmap();

// Save as PDF for document integration
myBarcode.SaveAsPdf("barcode-document.pdf");

// Get barcode as a bitmap for direct display in a UI control
var barcodeBitmap = myBarcode.ToBitmap();

// Save as PDF for document integration
myBarcode.SaveAsPdf("barcode-document.pdf");

Welche Datentypen können in einem Data-Matrix-Barcode kodiert werden?

Data Matrix unterstützt mehrere Kodierungsmodi, die jeweils für einen anderen Zeichensatz optimiert sind. IronBarcode wählt automatisch den effizientesten Modus basierend auf den von Ihnen bereitgestellten Inhalten aus:

// Encode alphanumeric product codes
var productCode = BarcodeWriter.CreateBarcode("ABC-123-XYZ", BarcodeWriterEncoding.DataMatrix);
productCode.SaveAsImage("product-code.png");

// Encode numeric serial numbers (numeric mode uses less space)
var serialNumber = BarcodeWriter.CreateBarcode("987654321098765", BarcodeWriterEncoding.DataMatrix);
serialNumber.SaveAsImage("serial-number.png");

// Encode URLs for product landing pages or support portals
var urlCode = BarcodeWriter.CreateBarcode("https://example.com/product/12345", BarcodeWriterEncoding.DataMatrix);
urlCode.SaveAsImage("url-datamatrix.png");

// Encode Unicode text for international applications
var unicodeBarcode = BarcodeWriter.CreateBarcode("製品-2024-東京", BarcodeWriterEncoding.DataMatrix);
unicodeBarcode.SaveAsImage("unicode-datamatrix.png");

// Encode alphanumeric product codes
var productCode = BarcodeWriter.CreateBarcode("ABC-123-XYZ", BarcodeWriterEncoding.DataMatrix);
productCode.SaveAsImage("product-code.png");

// Encode numeric serial numbers (numeric mode uses less space)
var serialNumber = BarcodeWriter.CreateBarcode("987654321098765", BarcodeWriterEncoding.DataMatrix);
serialNumber.SaveAsImage("serial-number.png");

// Encode URLs for product landing pages or support portals
var urlCode = BarcodeWriter.CreateBarcode("https://example.com/product/12345", BarcodeWriterEncoding.DataMatrix);
urlCode.SaveAsImage("url-datamatrix.png");

// Encode Unicode text for international applications
var unicodeBarcode = BarcodeWriter.CreateBarcode("製品-2024-東京", BarcodeWriterEncoding.DataMatrix);
unicodeBarcode.SaveAsImage("unicode-datamatrix.png");

Numerische Daten verwenden einen kompakten Kodierungsmodus, der die Barcodegröße im Vergleich zu alphanumerischem Text reduziert. Die Binärkodierung verarbeitet Sonderzeichen und Unicode-Text ohne manuelle Konfiguration. IronBarcode wählt automatisch den effizientesten Kodierungsmodus aus, sodass Sie ihn nicht explizit angeben müssen.

Wie kann man das Erscheinungsbild eines Data-Matrix-Barcodes anpassen?

IronBarcode bietet eine vollständige Palette an Barcode-Anpassungsoptionen zur Steuerung von Größe, Farbe, Beschriftungen und Rändern:

// Create barcode with custom styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeWriterEncoding.DataMatrix);

// Set specific dimensions in pixels
customBarcode.ResizeTo(500, 500);

// Adjust colors for special label requirements
customBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
customBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);

// Add human-readable text below the barcode symbol
customBarcode.AddAnnotationTextBelowBarcode("Product: CUSTOM-2024");

// Set margins to preserve the required quiet zone
customBarcode.SetMargins(10);

customBarcode.SaveAsImage("custom-datamatrix.png");

// Create barcode with custom styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeWriterEncoding.DataMatrix);

// Set specific dimensions in pixels
customBarcode.ResizeTo(500, 500);

// Adjust colors for special label requirements
customBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
customBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);

// Add human-readable text below the barcode symbol
customBarcode.AddAnnotationTextBelowBarcode("Product: CUSTOM-2024");

// Set margins to preserve the required quiet zone
customBarcode.SetMargins(10);

customBarcode.SaveAsImage("custom-datamatrix.png");

Diese individuellen Anpassungen helfen dabei, die Anforderungen des Corporate Brandings oder spezifische Kennzeichnungsstandards zu erfüllen. Die Methode ResizeTo gewährleistet die korrekten Modulproportionen, was für die Lesbarkeit von Data-Matrix-Daten bei jedem Scannerabstand unerlässlich ist. Farbänderungen ermöglichen die Berücksichtigung spezieller Druckverfahren oder Substratbeschränkungen, wie z. B. farbige Etiketten oder metallische Materialien. Der durch SetMargins festgelegte Abstand zwischen den Leerzeichen erfüllt die in der ISO/IEC 16022-Spezifikation definierte Mindestanforderung an den Leerraum.

Wie generiert man mehrere Barcodes in einem Batch?

Die Stapelgenerierung reduziert den Aufwand bei der Erstellung großer Mengen von Data-Matrix-Codes für Produktionsläufe, Versandetiketten oder serialisierte Lagerbestände:

// Generate barcodes for a batch of products
string[] productIds = { "PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005" };

foreach (string id in productIds)
{
    var batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix);
    batchBarcode.ResizeTo(150, 150);
    batchBarcode.AddAnnotationTextBelowBarcode(id);

    // Save each barcode with a unique filename
    string filename = $"barcode_{id.Replace("-", "_")}.png";
    batchBarcode.SaveAsImage(filename);
}

// Generate barcodes for a batch of products
string[] productIds = { "PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005" };

foreach (string id in productIds)
{
    var batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix);
    batchBarcode.ResizeTo(150, 150);
    batchBarcode.AddAnnotationTextBelowBarcode(id);

    // Save each barcode with a unique filename
    string filename = $"barcode_{id.Replace("-", "_")}.png";
    batchBarcode.SaveAsImage(filename);
}

Dieses Muster eignet sich für Logistik- und Gesundheitsprozesse, die große Etikettensätze erfordern, wobei jedes Etikett mit einer eindeutigen Kennung verknüpft ist. Bei Webanwendungen ermöglicht das direkte Aufbringen von Barcodes auf PDF-Dokumente oder deren Übertragung als Byte-Arrays die Echtzeit-Etikettengenerierung ohne Zwischenspeicherung.

Wie liest und verifiziert man Data-Matrix-Barcodes?

Das Generieren von Barcodes ist nur die halbe Miete – die Überprüfung, ob Scanner sie korrekt lesen können, schließt den Qualitätskreislauf. IronBarcode enthält einen integrierten Barcode-Leser, mit dem Sie ein generiertes Bild direkt nach dessen Erstellung dekodieren können:

// Generate a barcode
var generated = BarcodeWriter.CreateBarcode("VERIFY-2024", BarcodeWriterEncoding.DataMatrix);
generated.SaveAsImage("verify-test.png");

// Read it back to confirm correct encoding
var results = BarcodeReader.Read("verify-test.png");
foreach (var result in results)
{
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Format: {result.BarcodeTyp}");
}

// Generate a barcode
var generated = BarcodeWriter.CreateBarcode("VERIFY-2024", BarcodeWriterEncoding.DataMatrix);
generated.SaveAsImage("verify-test.png");

// Read it back to confirm correct encoding
var results = BarcodeReader.Read("verify-test.png");
foreach (var result in results)
{
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Format: {result.BarcodeTyp}");
}

Dieses Verfahren zur Rundum-Verifizierung ist besonders wertvoll in regulierten Branchen wie der Pharmaindustrie, wo die DSCSA-Verordnung vorschreibt, dass serialisierte Barcodes auf verschreibungspflichtigen Arzneimittelverpackungen sowohl maschinenlesbar als auch korrekt formatiert sein müssen. Durch die Durchführung einer Rückleseprüfung im Rahmen der Generierungspipeline werden Kodierungsfehler erkannt, bevor die Labels die Produktionslinie erreichen.

Für fortgeschrittenere Leseszenarien konsultieren Sie bitte die IronBarcode Lesedokumentation und den Leitfaden zum Lesen von Barcodes aus PDFs .

Was sind Ihre nächsten Schritte?

Die Generierung von Data Matrix-Barcodes in C# mit IronBarcode folgt einem einheitlichen Muster: Installieren Sie das NuGet Paket, rufen Sie BarcodeWriter.CreateBarcode mit BarcodeWriterEncoding.DataMatrix auf, nehmen Sie alle erforderlichen Anpassungen vor und exportieren Sie in Ihr Zielformat. Dieselbe API verarbeitet alles von Prototypen mit einem einzigen Barcode bis hin zu Batch-Pipelines mit hohem Datenvolumen.

Hier sind die empfohlenen Wege, um dies weiter zu verfolgen:

• Barcode-Lesen entdecken : Der IronBarcode Leseleitfaden behandelt das Dekodieren von Barcodes aus Bildern, PDFs und Live-Kamerastreams.
• Probieren Sie andere 2D-Formate aus : IronBarcode generiert mit derselben API auch QR-Codes , PDF417, Aztec und alle gängigen 1D-Formate.
• Barcodes in Dokumente einbetten : Das PDF-Stempelt-Tutorial zeigt, wie man programmgesteuert Barcodes zu bestehenden PDFs hinzufügt.
• Skalierung mit asynchroner Verarbeitung : Lesen Sie den Leitfaden zu asynchroner und Multithread-Verarbeitung , um große Batch-Jobs zu parallelisieren.
• Lizenzprüfung : Auf derIronBarcode -Lizenzseite werden die Optionen für die Weiterverteilung vom Entwickler bis zum OEM aufgelistet.

Starten Sie eine kostenlose Testversion , um alle Funktionen uneingeschränkt zu testen, oder lesen Sie die vollständige IronBarcode -Dokumentation für detaillierte API-Referenzen und zusätzliche Codebeispiele.

Mit NuGet installieren

PM >  Install-Package BarCode

Schauen Sie sich IronBarcode auf NuGet für eine schnelle Installation an. Mit über 10 Millionen Downloads transformiert es die PDF-Entwicklung mit C#. Sie können auch das DLL herunterladen.