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 twoim projekcie będzie dostępna 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 systemowych zgodnie z instrukcją zawartą w przewodniku wdrażania IronBarcode dla systemu Linux.

Jak wygenerować prosty plik obrazu kodu kreskowego w 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() akceptuje ciąg znaków do zakodowania oraz format kodu kreskowego z BarcodeWriterEncoding. Zwrócona referencja GeneratedBarcode zapewnia metody stylizacji oraz opcje eksportu do zapisania w formatach 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łynne 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 twój kod kreskowy pozostaje czytelny dla maszyn -- zapewniając prawidłowe skanowanie w produkcji po zastosowaniu niestandardowych kolorów lub zmniejszeniu do małych 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 stylizacji i dostosowywaniu kodów kreskowych obejmuje wszystkie dostępne metody stylizacji w szczegółach.

Aby wygenerować wiele kodów kreskowych z jednolitą stylizacją w całym katalogu, stwórz metodę pomocniczą, która stosuje twój standardowy łańcuch stylizacji 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 kodu kreskowego kompatybilne z ASP.NET Core web API oraz aplikacjami Blazor. Metoda ToBitmap() zapewnia referencję System.Drawing.Bitmap do dalszej manipulacji obrazem. Aby stemplować kody kreskowe na istniejących dokumentach PDF, zobacz Poradnik kodów kreskowych PDF IronBarcode.

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 systemowych wymaganych do wdrożeń kontenerowych. Podczas pracy na Linuxie zazwyczaj potrzebujesz libgdiplus i libc6-dev zainstalowanych w twoim obrazie Docker. W systemie Alpine Linux wymagany 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 porównawcza formatu kodu kreskowego IronBarcode zapewnia odniesienie wszystkich obsługiwanych typów, ich ograniczeń pojemności i zalecanych przypadków użycia.

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. Użyj metody SetMargins(), aby dodać co najmniej 10 pikseli marginesu z każdej strony dla wyświetlania cyfrowego oraz co najmniej 2.5 mm dla wydruku. Wtargnięcie w strefę ciszy jest jedną z najczęstszych przyczyn niepowodzeń skanowania w środowisku produkcyjnym.

Zweryfikuj 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 batch generowania kodów kreskowych IronBarcode demonstruje efektywny wzór pętli z jednolitym wyjściem.

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.

Stosuj wzorce zwalniania zasobów .NET. GeneratedBarcode i wszelkie strumienie zwracane przez ToStream() zaimplementują IDisposable. Obejmij je w instrukcjach using, aby szybko zwolnić niezarządzane zasoby, szczególnie w aplikacjach webowych o dużej przepustowości, gdzie generowanie kodów kreskowych 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() w IronBarcode podczas działania przechwytuje wszystkie trzy.

Dla odczytu kodów kreskowych z wygenerowanych obrazów -- dla testowania w systemie pętli zwrotnej lub skanowania przesłanych plików -- zobacz Przewodnik czytnika 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 i wszystkich enumeracji
• Samouczek czytnika kodów kreskowych IronBarcode -- czytanie i dekodowanie kodów kreskowych z obrazów, PDF i strumieni
• Przykład generowania wsadowego kodów kreskowych -- wzorce generacji na dużą skalę dla drukowania etykiet i przepływów roboczych wysyłki
• Licencjonowanie i ceny IronBarcode -- opcje zaczynające się od $999

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.