Granice projektowe typu Enum

Enum Type jest autorytatywną listą tego, coNetBarcodepotrafi generować. Analiza tekstu pozwala poznać zakres biblioteki:

//NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Codabar,
    Code11,
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39E,
    Code93,
    EAN13,
    EAN8
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist
// Type.UPCA        — does not exist
// Type.UPCE        — does not exist
// Type.ITF         — does not exist
// Type.MSI         — does not exist

//NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Codabar,
    Code11,
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39E,
    Code93,
    EAN13,
    EAN8
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist
// Type.UPCA        — does not exist
// Type.UPCE        — does not exist
// Type.ITF         — does not exist
// Type.MSI         — does not exist

Public Enum Type
    Codabar
    Code11
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39E
    Code93
    EAN13
    EAN8
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist
' Type.UPCA        — does not exist
' Type.UPCE        — does not exist
' Type.ITF         — does not exist
' Type.MSI         — does not exist

Enum ma jedenaście wpisów w ośmiu rodzinach symbologii liniowej i odzwierciedla to zakres bibliotek. Każda aplikacja wymagająca kodów QR, DataMatrix, PDF417, Aztec, UPC-A, UPC-E, ITF czy MSI musi uzyskać osobny pakiet dla dostarczenia tych formatów.

Szczegółowe porównanie funkcji

Podejście NetBarcode

NetBarcode dostarcza 11 wartości enumu kodów kreskowych liniowych w 8 rodzinach symbolik poprzez enum Type. W tym zakresie wybór formatu jest prosty — wystarczy przekazać odpowiedni element wyliczenia do konstruktóra. Granica jest równie jasna: próba użycia formatu spoza wyliczenia powoduje błąd kompilacji.

//NetBarcode— formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

//NetBarcode— formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117
// var upca   = new Barcode("data", Type.UPCA);        // error CS0117
// var itf    = new Barcode("data", Type.ITF);         // error CS0117

//NetBarcode— formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

//NetBarcode— formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117
// var upca   = new Barcode("data", Type.UPCA);        // error CS0117
// var itf    = new Barcode("data", Type.ITF);         // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

'NetBarcode— formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117
' Dim upca As New Barcode("data", Type.UPCA)     ' error CS0117
' Dim itf As New Barcode("data", Type.ITF)       ' error CS0117

Branże, w których ta granica staje się ograniczeniem, obejmują śledzenie produktów farmaceutycznych (kodDataMatrixwymagany zgodnie z wymogąmi FDA dotyczącymi BARCODE-ów 2D), karty pokładowe linii lotniczych (Aztec), listy przewozowe (PDF417) oraz marketing mobilny (kod QR). Każdy z tych wymagań wykluczaNetBarcodejako samodzielne rozwiązanie.

Podejście IronBarcode

IronBarcode eksponuje wszystkie obsługiwane formaty przez tę samą metodę BarcodeWriter.CreateBarcode. Powierzchnia API nie zmienia się przy przechodzeniu z formatu 1D na 2D — różni się tylko stała BarcodeEncoding.

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

Pełna lista obsługiwanych stałych jest dostępna w dokumentacji dotyczącej obsługiwanych formatów BARCODE, obejmującej wszystkie formaty generowania BARCODE 2D oraz pełny zestaw BARCODE 1D.

Podejście NetBarcode

Model generowaniaNetBarcodeopiera się na konstruktórach. Obiekt Barcode jest zainicjowany za pomocą ciągu danych i wartości enumu Type. Wyjście jest albo zapisywane bezpośrednio za pomocą SaveImageFile() albo pobierane jako Image<Rgba32> za pomocą GetImage(). Od wersji 1.8, typ zwracany przez GetImage() to typ SixLabors.ImageSharp, co oznacza, że każdy kod przechowujący lub przetwarzający wartość zwracaną musi importować i działać w ramach API ImageSharp.

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

Typ zwracany przez metodę GetImage() wiąże kod potomny z biblioteką ImageSharp. Każda metoda, która akceptuje lub przechowuje wynik, musi deklarować go jako Image<Rgba32>, wprowadzając przejściową zależność do kodu wywołującego.

Podejście IronBarcode

IronBarcode wykorzystuje łańcuch płynny. BarcodeWriter.CreateBarcode zwraca obiekt GeneratedBarcode, który ma wiele metod wyjściowych. Obsługa obrazów odbywa się wewnętrznie — kod wywołujący nie ma dostępu do typu ImageSharp.

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

Szczegółowe opcje generowania kodów kreskowych 1D, w tym szerokość, wysokość i konfiguracja etykiet, zostały omówione w dokumentacji IronBarcode.

Podejście NetBarcode

NetBarcode nie posiada API do odczytu. Nie ma metody, klasy ani konfiguracji, która dekodowałaby obraz kodu kreskowego z powrotem do ciągu danych. Jest to celowe ograniczenie zakresu, a nie pominięcie w oczekiwaniu na wydanie. Projekt, który generuje BarCodes za pomocą NetBarcode, a następnie musi je odczytać — w celu weryfikacji wydrukowanej etykiety, zeskanowania przesyłki zwrotnej lub wyodrębnienia wartości z faktury dostawcy — musi wprowadzić oddzielną bibliotekę do tego celu.

//NetBarcode— no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

//NetBarcode— no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

'NetBarcode— no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

Biblioteka ZXing.Net jest najczęściej dodawanym elementem do odczytu obok NetBarcode, zapewniając trzeci interfejs API i trzeci pakiet do zarządzania wersjami obokNetBarcodei dowolnej biblioteki 2D już dodanej dla kodów QR.

Podejście IronBarcode

IronBarcode zawiera BarcodeReader w tej samej paczce, co BarcodeWriter. API odczytu akceptuje pliki graficzne i dokumenty PDF i zwraca zbiór zdekodowanych wyników, z których każdy zawiera wartość BARCODE, typ formatu oraz numer strony w przypadku odczytu z pliku PDF.

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.Format}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.Format}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.Format}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

Przewodnik dotyczący odczytu kodów kreskowych z obrazów obejmuje opcje dostosowywania szybkości, wykrywania wielu kodów kreskowych oraz korekcji obrazu dostępne w interfejsie API odczytu.

NetBarcodei ImageSharp

NetBarcode jest objęty licencją MIT. Biblioteka SixLabors.ImageSharp, od której jest ona zależna, stosuje inny model: jest bezpłatna dla projektów open source oraz dla firm, których roczne przychody brutto nie przekraczają określonego progu, ale powyżej tego progu wymagana jest licencja komercyjna. Ten podział obowiązuje bez względu na to, czy ImageSharp jest wyraźnie wymieniony w .csproj projektu, czy przychodzi przejściowo przez NetBarcode.

<PackageReference Include="NetBarcode" Version="1.8.3" />

<PackageReference Include="NetBarcode" Version="1.8.3" />

W przypadku firmy detalicznej lub logistycznej przetwarzającej BarCodes na dużą skalę — głównego przypadku użycia, do którego skierowany jestNetBarcode— roczne przychody często przekraczają próg, od którego obowiązuje komercyjna licencja ImageSharp. Audyt zgodności może ujawnić ten obowiązek osadzony w drzewie pakietów.

Wydanie v1.8 wprowadziło dodatkową konsekwencję zależności ImageSharp: typ zwracany przez GetImage() zmienił się z wewnętrznego przedstawienia na SixLabors.ImageSharp.Image<Rgba32>. Istniejący kod, który wywoływał GetImage() bez wyraźnego typowania, przestał działać podczas kompilacji, a nowe dyrektywy using dla SixLabors.ImageSharp i SixLabors.ImageSharp.PixelFormats stały się wymagane. Gdy własne API ImageSharp ewoluuje w przyszłych wersjach, ma to wpływ na publiczny interfejs API NetBarcode.

IronBarcode

IronBarcode nie jest zależny od SixLabors.ImageSharp. Warunki licencji są określone bezpośrednio na stronie licencyjnej IronBarcode, bez progu podziału ani przechodnich zobowiązań komercyjnych. Dostępny jest klucz próbny do oceny wersji próbnej; Zakupione licencje usuwają znak wodny wersji próbnej z wygenerowanych wyników.

Wymagania dotyczące kodów QR i formatów 2D

Najczęstszym powodem rozważania alternatywy dlaNetBarcodejest nowe wymaganie dotyczące kodów QR. Aplikacje, które zaczynają od generowania kodów kreskowych 1D dla etykiet detalicznych lub listów przewozowych, często otrzymują kolejne wymagania dotyczące kodów QR — linków bezdotykowych, głębokich linków do aplikacji mobilnych, kampanii marketingowych. Ponieważ enum Type nie zawiera wpisu QR, nie można spełnić tego wymagania w NetBarcode. Zespoły, które dodają oddzielną bibliotekę kodów QR, aby wypełnić tę lukę, stają następnie przed drugą oceną, gdyDataMatrixjest wymagany do integracji farmaceutycznej lubPDF417dla przewoźnika logistycznego, który wymaga go na etykietach wysyłkowych.

Odczytywanie BarCode staje się konieczne

Niektóre projekty zaczynają się od samego generowania, a później dodają wymóg walidacji lub przetwarzania dokumentów: potwierdzenie, że wydrukowany BARCODE pasuje do danych źródłowych, wyciąganie wartości BARCODE-ów z przychodzących faktur dostawców lub skanowanie etykiet przesyłek zwrotnych.Net/Barcodenie zapewnia takiej możliwości. Dodanie ZXing.Net lub podobnej biblioteki do odczytu wprowadza trzecie API, którego trzeba się nauczyć i które trzeba utrzymywać w tym samym kodzie źródłowym, który już zawieraNetBarcodei bibliotekę QR. W projektach, w których przewiduje się zapotrzebowanie na odczyt danych, nawet w przyszłej fazie, często bardziej efektywne jest wybranie biblioteki, która od samego początku obsługuje oba te zadania.

Audyt licencji komercyjnej ImageSharp

Podczas przeglądów prawnych i zgodnościowych zależności stron trzecich czasami pojawia się warunek licencji komercyjnej SixLabors.ImageSharp osadzony w drzewie pakietów NetBarcode. W przypadku firm, których roczne przychody brutto przekraczają próg, obowiązek ten ma zastosowanie niezależnie od tego, czy ImageSharp został wybrany celowo, czy też trafił do nich pośrednio poprzez NetBarcode. Zespoły, które odkryją to podczas audytu — a nie przed wdrożeniem — staną przed koniecznością retroaktywnego naprawiania błędów zamiast planowanej migracji. Ocena licencji zależności przed rozpoczęciem projektu jest lepszym rozwiązaniem.

Zmniejszenie złożoności wielu bibliotek

Zespoły, które korzystają zNetBarcodedo generowania kodów 1D, biblioteki przeznaczonej do generowania kodów QR oraz ZXing.Net do odczytu, muszą dbać o kompatybilność wersji trzech oddzielnych pakietów. Każdy cykl aktualizacji wymaga sprawdzenia, czy wszystkie trzy biblioteki korzystają z tej samej wersji ImageSharp. Każdy nowy programista w projekcie ma do czynienia z trzema różnymi interfejsami API, które koncepcyjnie dotyczą tej samej kwestii. Konsolidacja w jedną bibliotekę BarCODE upraszcza wdrażanie, zmniejsza ryzyko konfliktów między wersjami i skupia konserwację w jednym cyklu wydawniczym.

Zamiana pakietów i czyszczenie zależności przechodnich

UsunięcieNetBarcodeza pomocą dotnet remove package NetBarcode to pierwszy krok. Pakiet SixLabors.ImageSharp może ponownie pojawić się w drzewie zależności, jeśli inne pakiety w projekcie również go przejmują. Po usunięciu, sprawdź przywróconą listę pakietów za pomocą dotnet list package --include-transitive, aby potwierdzić, czy ImageSharp nadal jest obecny i czy nadal obowiązuje jego warunek licencji komercyjnej.

Zastąpienie typu zwracanego przez metodę GetImage()

Każdy kod, który przechowywał wynik GetImage() jako Image<Rgba32>, musi być zaktualizowany. Typ ImageSharp nie ma bezpośredniego odpowiednika w IronBarcode; Wybór zamiennika zależy od tego, w jaki sposób obraz został wykorzystany w dalszej części procesu. Kod, który zapisywał obraz do strumienia, można zastąpić .SaveAsPng(stream) bezpośrednio na obiekcie GeneratedBarcode. Kod, który pobierał surowe bajty, może używać .ToPngBinaryData(). Kod, który wykonywał dalsze operacje ImageSharp na zwróconym obrazie, będzie wymagał indywidualnej oceny tych operacji.

Aktualizacja przestrzeni nazw

Pliki, które importowały using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats; lub using SixLabors.Fonts;, muszą mieć te dyrektywy zastąpione using IronBarCode;. Wyszukiwanie tych instrukcji using w całym projekcie pozwala zidentyfikować każdy plik, który wymaga uwagi przed rozpoczęciem kompilacji.