Jak generować kody kreskowe w C# używając IronBarcode

Jak zainstalować bibliotekę generatora kodów kreskowych za pomocą menedżera pakietów NuGet?

Otwórz program Visual Studio i zainstaluj pakiet NuGet, wpisując następujące polecenie w konsoli menedżera pakietów:

Install-Package BarCode

Pakiet NuGet obsługuje .NET 10, .NET 8, .NET 6, .NET Core, .NET Standard i .NET Framework — dzięki czemu jest kompatybilny z aplikacjami Windows oraz wielopłatformowymi aplikacjami .NET. IronBarcode obsługuje wdrażanie w kontenerach Docker, na platformie Azure oraz na serwerach z systemem Linux. Więcej szczegółów i dokumentacji referencyjnej można znaleźć na stronie dokumentacji IronBarcode oraz w projekcie Iron Software na GitHubie.

Po instalacji w projekcie pojawi się przestrzeń nazw IronBarCode. Biblioteka nie wymaga żadnych dodatkowych zależności środowiskowych w systemie Windows — w systemie Linux może być konieczne zainstalowanie kilku bibliotek systemówych zgodnie z instrukcją zawartą w przewodniku wdrażania IronBarcode dla systemu Linux.

Jak wygenerować prosty plik obrazu BarCode w języku C#?

Twórz obrazy BARCODE za pomocą zaledwie kilku linii kodu. Poniższy przykład przedstawia generowanie BARCODE, które zapisuje plik obrazu w formacie 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");

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

Metoda BarcodeWriter.CreateBarcode() przyjmuje ciąg znaków do zakodowania oraz format BARCODE z BarcodeWriterEncoding. Zwracane odwołanie GeneratedBarcode udostępnia metody stylizacji oraz opcje eksportu do formatów PNG, JPEG, BMP, TIFF, PDF lub HTML.

Jak utworzyć kod QR i inne rodzaje kodów kreskowych 2D?

IronBarcode obsługuje wszystkie główne formaty kodów kreskowych, w tym kody 2D, takie jak QR Code i Data Matrix. Wygeneruj kod QR o podobnej składni:

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 BarCode doskonale nadaje się do przechowywania adresów URL i większych ilości danych. Biblioteka automatycznie koryguje błędy, zapewniając, że BARCODE pozostaje czytelny nawet w przypadku częściowego uszkodzenia. Domyślnie IronBarcode używa poziomu korekcji błędów M (średni), który pozwala odzyskać około 15% utraconych danych — możesz podnieść ten poziom do H w przypadku drukowanych kodów kreskowych, które mogą być porysowane lub częściowo zasłonięte.

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

Jak stworzyć stylizowany kod QR z zaawansowanymi opcjami stylizacji?

Profesjonalne generowanie BarCodes często wymaga zaawansowanych opcji stylizacji w celu dostosowania kolorów i dodania adnotacji. Klasa GeneratedBarcode zapewnia płynny interfejs API z metodami stylizacji:

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

Płynny interfejs API pozwala łączyć metody stylizacji w celu dostosowania kolorów, ustawienia marginesów i dodania tekstu w jednym wyrażeniu. Metoda Verify() wskazuje, czy BarCode pozostaje czytelny dla maszyn — zapewniając prawidłowe skanowanie w środowisku produkcyjnym po zastosowaniu niestandardowych kolorów lub zmniejszeniu rozmiaru do niewielkich wymiarów.

Zmiana koloru paska na bardzo jasny odcień lub niebieski o niskim kontraście na białym tle może spowodować, że BARCODE nie będzie można zeskanować. Zawsze wywołuj Verify() po każdej zmianie koloru. Jeśli weryfikacja nie powiedzie się, należy zwiększyć kontrast lub przywrócić czarne paski. Przewodnik po stylach i dostosowywaniu BarCodeów szczegółowo opisuje wszystkie dostępne metody stylizacji.

Aby wygenerować wiele BARCODE-ów o spójnym stylu w całym katalogu, należy stworzyć metodę pomocniczą, która zastosuje standardowy łańcuch stylów do każdej instancji GeneratedBarcode. Takie podejście zapewnia jednolite marginesy, rozmiar czcionki i kolor na tysiącach wygenerowanych obrazów.

Jak eksportować BarCodes do różnych formatów obrazów?

Generuj obrazy BarCode w wielu formatach do różnych zastosowań. Biblioteka zapisuje pliki w formatach PNG, JPEG, BMP, TIFF, PDF i HTML:

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()

Metoda ToStream() zwraca dane BARCODE zgodne z interfejsami API ASP.NET Core oraz aplikacjami Blazor. Metoda ToBitmap() zapewnia odwołanie System.Drawing.Bitmap do dalszej obróbki obrazu. Aby dowiedzieć się, jak umieszczać kody kreskowe w istniejących dokumentach PDF, zapoznaj się z samouczkiem dotyczącym kodów kreskowych IronBarcode PDF.

Jakie wielopłatformowe środowiska .NET obsługuje IronBarcode?

IronBarcode obsługuje generowanie kodów kreskowych na wszystkich głównych platformach .NET. Wdrożenie w:

Przewodnik konfiguracji IronBarcode Docker zawiera szczegółowe informacje na temat bibliotek systemówych wymagańych do wdrożeń kontenerowych. W przypadku uruchamiania w systemie Linux zazwyczaj konieczne jest zainstalowanie libgdiplus i libc6-dev w obrazie Docker. W systemie Alpine Linux wymagańy jest nieco inny zestaw pakietów — przewodnik obejmuje zarówno pliki Dockerfile dla systemów Ubuntu/Debian, jak i Alpine.

W przypadku wdrożeń AWS Lambda przewodnik po wdrażaniu AWS Lambda wyjaśnia, jak dołączyć natywne zależności do pakietu wdrożeniowego i skonfigurować limity pamięci w celu obsługi obciążeń związanych z renderowaniem kodów BarCode.

Jak stosować najlepsze praktyki dotyczące generowania BarCodes w .NET?

Stosowanie spójnego zestawu praktyk podczas generowania obrazów BarCode w aplikacjach C# decyduje o tym, czy BarCode będzie skanowany niezawodnie w terenie, czy też zawiodą w punkcie sprzedaży lub na magazynie. Poniższe wytyczne mają zastosowanie niezależnie od wybranego formatu BARCODE.

Wybierz format BarCode odpowiedni do swojego zastosowania. Wybierz format, który pasuje do Twojego środowiska skanowania i wymagań dotyczących danych. W przypadku adresów URL i danych o długości powyżej 80 znaków należy używać kodów QR. Użyj kodu 128 do inwentaryzacji i logistyki, gdzie dane alfanumeryczne muszą zmieścić się w kompaktowym symbolu liniowym. W przypadku produktów detalicznych, które wymagają rejestracji w systemie GS1, należy używać kodów EAN-13 lub UPC-A. Strona IronBarcode poświęcona porównaniu formatów kodów kreskowych zawiera zestawienie wszystkich obsługiwanych typów, ich limitów pojemności oraz zalecanych zastosowań.

Zawsze należy uwzględniać wystarczające strefy ciszy. Biała przestrzeń wokół BarCODE'a — zwana strefą ciszy — jest równie ważna jak same kreski. Skanery wykorzystują go do wykrywania początku i końca symbolu. Należy użyć metody SetMargins(), aby dodać co najmniej 10 pikseli odstępu z każdej strony w przypadku wyświetlania cyfrowego oraz co najmniej 2,5 mm w przypadku wydruku PRINT. Wtargnięcie w strefę ciszy jest jedną z najczęstszych przyczyn niepowodzeń skanowania w środowisku produkcyjnym.

Sprawdź po każdej zmianie stylizacji. Po dostosowaniu kolorów, zastosowaniu gradientów lub zmianie rozmiaru na niestandardowy, wywołaj Verify() na obiekcie GeneratedBarcode. Jeśli zwraca wartość false, BARCODE nie będzie działał poprawnie przy skanowaniu za pomocą standardowego sprzętu. Należy zwiększyć kontrast lub zmniejszyć złożoność zmian stylistycznych.

W przypadku generowania dużych ilości danych należy stosować wzorce generowania wsadowego. Jeśli aplikacja generuje tysiące BarCodes — na przykład etykiet produktów lub listów przewozowych — należy przetwarzać je w pętli i ponownie wykorzystywać tę samą konfigurację stylów. Należy unikać ładowania zasobów czcionek lub obiektów konfiguracyjnych wewnątrz pętli, ponieważ powoduje to niepotrzebne obciążenie. Przykład generowania kodów kreskowych w trybie wsadowym w IronBarcode ilustruje wydajny wzorzec pętli zapewniający spójne wyniki.

Przeprowadź testy na wielu modelach skanerów i w różnych warunkach oświetleniowych. Skanery BarCode różnią się pod względem tolerancji na kolory o niskim kontraście, małe rozmiary modułów i jakość druku. Przed wdrożeniem przetestuj wydrukowane BarCodes przy użyciu co najmniej dwóch różnych typów skanerów. W przypadku kodów QR wyświetlanych na ekranach należy przeprowadzić testy przy użyciu aparatów w telefonach komórkowych zarówno w jasnym, jak i słabym oświetleniu. Strona poświęcona standardom weryfikacji BarCodes GS1 zawiera wiarygodne wytyczne dotyczące klasyfikacji jakości symboli w przypadku BarCodes stosowanych w handlu detalicznym.

Należy przestrzegać limitów pojemności danych. Każdy format BarCode ma określoną maksymalną pojemność danych. Kod 128 może z łatwością zakodować do około 48 znaków, zanim symbol stanie się zbyt szeroki, aby można go było wydrukować na etykietach o standardowych rozmiarach. Pojemność kodu QR zależy od poziomu korekcji błędów — na poziomie H maksymalna pojemność wynosi około 1273 znaków alfanumerycznych. Przekroczenie pojemności zmusza bibliotekę do wygenerowania wyjątku lub cichego obniżenia jakości. Zapoznaj się z informacjami na temat pojemności danych kodów QR w Wikipedii, aby uzyskać szybki przegląd tabeli pojemności.

Należy stosować wzorce dysponowania .NET. GeneratedBarcode oraz wszelkie strumienie zwracane przez ToStream() implementują IDisposable. Należy umieścić je w instrukcjach using, aby szybko zwolnić zasoby niezarządzane, zwłaszcza w aplikacjach internetowych o dużej przepustowości, w których generowanie BarCode'ów odbywa się na żądanie.

Zrozumienie typowych trybów awarii pomaga również w tworzeniu bardziej odpornego kodu generującego. Trzy najczęstsze przyczyny niepowodzeń skanowania to: niewystarczająca strefa ciszy, kolor kreski zbyt zbliżony do koloru tła oraz BARCODE o rozmiarze poniżej minimalnego rozmiaru modułu dla wybranego formatu. Metoda Verify() firmy IronBarcode przechwytuje wszystkie trzy w czasie wykonywania.

Aby odczytać kody kreskowe z wygenerowanych obrazów — w celu przeprowadzenia testów w obie strony lub skanowania przesłanych plików — zapoznaj się z przewodnikiem po czytniku kodów kreskowych IronBarcode. API odczytu odzwierciedla API zapisu pod względem prostoty i obsługuje ten sam szeroki zakres formatów.

Norma ISO/IEC 15417 dotycząca kodu 128 oraz norma ISO/IEC 18004 dotycząca kodów QR określają specyfikacje techniczne, z którymi zgodny jest IronBarcode. Zapoznanie się z odpowiednią normą dotyczącą docelowego typu BARCODE pomoże Ci zrozumieć ograniczenia, w ramach których biblioteka musi działać.

Jakie są Twoje kolejne kroki?

W niniejszym przewodniku omówiono generowanie obrazów kodów kreskowych w języku C# przy użyciu biblioteki IronBarcode — od instalacji z NuGet, poprzez generowanie kodów Code 128, QR i EAN-13, zaawansowane stylizowanie za pomocą płynnego interfejsu API, eksport do wielu formatów, wdrażanie na wielu platformach oraz najlepsze praktyki produkcyjne.

Aby dowiedzieć się więcej, zapoznaj się z poniższymi zasobami:

• Pełna dokumentacja API IronBarcode — kompletna dokumentacja metod dla BarcodeWriter, GeneratedBarcode oraz wszystkich wyliczeń
• Samouczek dotyczący czytnika BarCode — odczytywanie i dekodowanie kodów kreskowych z obrazów, plików PDF i strumieni
• Przykład generowania kodów kreskowych w trybie wsadowym — wzorce generowania dużych ilości kodów do drukowania etykiet i procesów wysyłkowych
• Licencjonowanie i ceny IronBarcode — opcje zaczynające się od @@—CODE-12428—@@

Pobierz IronBarcode, aby dodać funkcję kodów kreskowych do swoich aplikacji .NET, lub rozpocznij bezpłatny 30-dniowy okres próbny, aby generować obrazy kodów kreskowych w swoim środowisku bez klucza licencyjnego.