Generator Data Matrix w C# — Kompletny samouczek z przykładami kodu

Co wyróżnia BarCodes Data Matrix?

BarCodes Data Matrix to symbole 2D, które kodują dane w siatce czarnych i białych kropek ułożonych w rzędach i kolumnach. W przeciwieństwie do tradycyjnych BARCODE-ów, takich jak UPC lub EAN, mogą one przechowywać do 2335 znaków alfanumerycznych lub 3116 cyfr w przestrzeni o wymiarach zaledwie 10 x 10 modułów. Wbudowana korekcja błędów Reed-Solomon pozwala na ich dokładny odczyt przez nowoczesne skanery BarCode, nawet gdy do 30% symbolu jest uszkodzone.

Te cechy sprawiają, że Data Matrix idealnie nadaje się do znakowania małych części, BarCode'ów pocztowych i komponentów elektronicznych, a także do etykietowania w placówkach służby zdrowia i centrach logistycznych. Branża opieki zdrowotnej opiera się na standardach GS1 Data Matrix w zakresie śledzenia leków, a producenci wdrażają je na liniach produkcyjnych w celu identyfikacji produktów na całym świecie. Ponieważ pojedynczy BARCODE może pomieścić tak wiele danych, są one obecnie stosowane na całym świecie w różnych branżach, które dążą do pełnej identyfikowalności produktów.

Standard ISO/IEC 16022 reguluje kodowanie Data Matrix, definiując wariant ECC200, którego IronBarcode używa domyślnie. ECC200 zapewnia najskuteczniejszą korekcję błędów i największą pojemność danych spośród wszystkich wersji Data Matrix, co czyni go właściwym wyborem dla nowych wdrożeń.

Jak zainstalować bibliotekę BarCode w projekcie C#?

Instalacja IronBarcode zajmuje mniej niż minutę przy użyciu menedżera pakietów NuGet. Otwórz konsolę menedżera pakietów w Visual Studio i uruchom:

Install-Package BarCode

Alternatywnie, poszukaj BarCode firmy Iron Software w interfejsie graficznym menedżera pakietów NuGet. Po instalacji dodaj przestrzeń nazw do pliku C#:

using IronBarCode;

using IronBarCode;

Imports IronBarCode

To wszystko, co trzeba zrobić. IronBarcode wewnętrznie obsługuje wszystkie złożone procesy kodowania Data Matrix zgodnie z normą ISO/IEC 16022, dzięki czemu możesz skupić się na logice aplikacji. Aby uzyskać informacje na temat dodatkowych opcji konfiguracji, takich jak instalacja w trybie offline lub niestandardowe źródła pakietów, zapoznaj się z instrukcją instalacji IronBarcode oraz stroną poświęconą zaawansowanej instalacji NuGet.

Jak stworzyć swój pierwszy BarCode Data Matrix?

Wygenerowanie BarCODE-a Data Matrix wymaga zaledwie jednej linii kodu:

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

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

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

Ten kod tworzy kod kreskowy Data Matrix zawierający tekst PROD-12345-2024 i zapisuje go jako plik PNG. Parametr BarcodeWriterEncoding.DataMatrix nakazuje bibliotece IronBarcode użycie formatu Data Matrix. Wygenerowany BARCODE automatycznie stosuje specyfikację ECC200, która obejmuje wbudowaną korekcję błędów i zapewnia niezawodne skanowanie w rzeczywistych warunkach.

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

' Get barcode as a bitmap for direct display in a UI control
Dim barcodeBitmap = myBarcode.ToBitmap()

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

Jakie typy danych można zakodować w BarCode'ie Data Matrix?

Data Matrix obsługuje kilka trybów kodowania, z których każdy jest zoptymalizowany pod kątem innego zestawu znaków. IronBarcode automatycznie wybiera najbardziej wydajny tryb na podstawie dostarczonej treści:

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

Imports System

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

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

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

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

Dane liczbowe wykorzystują tryb kompaktowego kodowania, który zmniejsza rozmiar BARCODE w porównaniu z tekstem alfanumerycznym. Kodowanie binarne obsługuje znaki specjalne i tekst Unicode bez konieczności ręcznej konfiguracji. IronBarcode automatycznie wybiera najbardziej wydajny tryb kodowania, więc nie trzeba go określać jawnie.

Jak dostosować wygląd BarCoda Data Matrix?

IronBarcode udostępnia pełen zestaw opcji dostosowywania kodów kreskowych, umożliwiających kontrolę rozmiaru, koloru, adnotacji i marginesów:

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

' Create barcode with custom styling
Dim 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")

Te dostosowania pomagają spełnić wymagania dotyczące wizerunku firmy lub konkretne standardy oznaczania. Metoda ResizeTo zachowuje odpowiednie proporcje modułów, co jest niezbędne dla czytelności kodów Data Matrix przy każdej odległości skanera. Zmiany kolorów uwzględniają specjalne procesy drukowania lub ograniczenia związane z podłożem, takie jak kolorowe etykiety lub materiały metaliczne. Margines strefy ciszy ustalony przez SetMargins spełnia minimalne wymagania dotyczące odstępów określone w specyfikacji ISO/IEC 16022.

Jak wygenerować wiele BarCodes w partii?

Generowanie partii zmniejsza nakład pracy związany z tworzeniem dużych zestawów kodów Data Matrix na potrzeby produkcji seryjnej, etykiet wysyłkowych lub inwentaryzacji seryjnej:

// 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);
}

' Generate barcodes for a batch of products
Dim productIds As String() = {"PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005"}

For Each id As String In productIds
    Dim batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix)
    batchBarcode.ResizeTo(150, 150)
    batchBarcode.AddAnnotationTextBelowBarcode(id)

    ' Save each barcode with a unique filename
    Dim filename As String = $"barcode_{id.Replace("-", "_")}.png"
    batchBarcode.SaveAsImage(filename)
Next

Ten wzorzec pasuje do procesów logistycznych i opieki zdrowotnej, które wymagają dużych zestawów etykiet, z których każda jest powiązana z unikalnym identyfikatorem. W przypadku aplikacji internetowych umieszczanie BarCODE bezpośrednio w dokumentach PDF lub przesyłanie ich strumieniowo jako tablice bajtów umożliwia generowanie etykiet w czasie rzeczywistym bez zapisywania plików pośrednich.

Jak odczytywać i weryfikować BarCodes Data Matrix?

Generowanie kodów kreskowych to tylko połowa procesu — weryfikacja, czy skanery potrafią je poprawnie odczytać, zamyka cykl jakości. IronBarcode zawiera wbudowany czytnik kodów kreskowych, który pozwala na dekodowanie wygenerowanego obrazu natychmiast po jego utworzeniu:

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

Imports System

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

' Read it back to confirm correct encoding
Dim results = BarcodeReader.Read("verify-test.png")
For Each result In results
    Console.WriteLine($"Decoded value: {result.Value}")
    Console.WriteLine($"Format: {result.BarcodeTyp}")
Next

Ten model weryfikacji w obie strony jest szczególnie cenny w branżach podlegających regulacjom, takich jak farmaceutyka, gdzie rozporządzenie DSCSA nakazuje, aby serializowane BARCODES na opakowaniach leków na receptę były zarówno czytelne dla maszyn, jak i miały prawidłowy format. Przeprowadzenie kontroli odczytu w ramach procesu generacji pozwala wychwycić błędy kodowania, zanim etykiety trafią na linię produkcyjną.

W przypadku bardziej zaawansowanych scenariuszy odczytu zapoznaj się z dokumentacją dotyczącą odczytu IronBarcode oraz przewodnikiem dotyczącym odczytu kodów kreskowych z plików PDF.

Jakie są Twoje kolejne kroki?

Generowanie kodów kreskowych Data Matrix w języku C# za pomocą IronBarcode przebiega według spójnego schematu: zainstaluj pakiet NuGet, wywołaj BarcodeWriter.CreateBarcode za pomocą BarcodeWriterEncoding.DataMatrix, zastosuj wszelkie wymagańe dostosowania i wyeksportuj do formatu docelowego. Ten sam interfejs API obsługuje wszystko, od prototypów z pojedynczym BARCODE-em po potoki przetwarzające duże partie danych.

Oto zalecane sposoby dalszego postępowania:

• Poznaj odczytywanie kodów kreskowych: Przewodnik IronBarcode obejmuje dekodowanie kodów kreskowych z obrazów, plików PDF i strumieni na żywo z kamer.
• Wypróbuj inne formaty 2D: IronBarcode generuje również kody QR, PDF417, Aztec oraz wszystkie główne formaty 1D przy użyciu tego samego API.
• Osadzanie kodów kreskowych w dokumentach: Samouczek dotyczący stemplowania plików PDF pokazuje, jak programowo dodawać kody kreskowe do istniejących plików PDF.
• Skalowanie dzięki przetwarzaniu asynchronicznemu: Zapoznaj się z przewodnikiem dotyczącym przetwarzania asynchronicznego i wielowątkowego, aby zrównoleglić duże zadania wsadowe.
• Zapoznaj się z licencjami: Strona licencyjna IronBarcode zawiera opcje od licencji deweloperskiej po dystrybucję OEM.

Rozpocznij bezpłatny okres próbny, aby przetestować wszystkie funkcje bez ograniczeń, lub zapoznaj się z pełną dokumentacją IronBarcode, aby uzyskać szczegółowe informacje o Dokumentacji API i dodatkowe przykłady kodu.

Zainstaluj za pomocą NuGet

PM >  Install-Package BarCode

Sprawdź IronBarcode na NuGet dla szybkiej instalacji. Z ponad 10 milionami pobrań, przekształca rozwój PDF z C#. Możesz również pobrać DLL.