NetBarcode vs IronBarcode: C# Barkod Kütüphanesi Karşılaştırması

Tür Enum Tasarım Sınırı

Type enumu, NetBarcode'un üretebileceği şeylerin kesin listesidir. İnceleme yapmak, kütüphanenin kapsamını ortaya çıkarır:

//NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// 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

//NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// 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

Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
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

Bu, bir çekme isteği bekleyen eksik bir özellik değildir. Enum, hepsi 1D olan on dört girdiye sahiptir ve bu kütüphanenin öngörülen kapsamını yansıtır. QR kodları, DataMatrix,PDF417veyaAztekgerektiren herhangi bir uygulama, bu formatları sağlamak için ayrı bir paket almak zorundadır.

Detayli Özellik Karsilastirmasi

NetBarcode Yaklaşımı

NetBarcode, Type enumu aracılığıyla 14 lineer barkod formatı sağlar. Bu kapsam dahilinde, format seçimi basittir — uygun enum üyesini yapılandırıcıya iletin. Sınır eşit derecede nettir: enum dışında bir format kullanmaya çalışmak derleme zamanında hata verir.

//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

//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

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

Bu sınırın kısıtlama haline geldiği endüstriler arasında tıbbi takip (FDA 2D barkod zorunlulukları altında gerekli olan DataMatrix), havayolu biniş kartları (Aztec), lojistik manifestoları (PDF417) ve mobil pazarlama (QR Code) bulunur. Bu gereksinimlerden her biri, NetBarcode'u bağımsız bir çözüm olarak kullanışsız hale getirir.

IronBarcode Yaklaşımı

IronBarcode, tüm desteklenen formatları aynı BarcodeWriter.CreateBarcode metodu üzerinden açığa çıkarır. 1D formatından 2D formatına geçildiğinde API yüzeyi değişmez — sadece BarcodeEncoding sabiti farklıdır.

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

Desteklenen sabitlerin tam listesi, tüm 2D barkod oluşturma formatlarının yanı sıra tam 1D setini içeren desteklenen barkod formatları referansında bulunabilir.

NetBarcode Yaklaşımı

NetBarcode'un oluşturma modeli kurucu tabanlıdır. Bir Barcode nesnesi veri dizesi ve Type enum değeri ile başlatılır. Çıktı ya doğrudan SaveImageFile() ile kaydedilir ya da Image<Rgba32> olarak GetImage() aracılığıyla alınır. Sürüm 1.8'den beri, GetImage() dönüş türü SixLabors.ImageSharp türüdür, bu da dönüş değerini saklayan veya işleyen herhangi bir kodun ImageSharp API'si içinde çalışması gerektiği anlamına gelir.

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

GetImage() metodunun dönüş türü, akış aşağı kodu ImageSharp kütüphanesine bağlar. Sonucu kabul eden veya saklayan herhangi bir metot, bunu Image<Rgba32> olarak beyan etmeli, çağrı koduna geçişli bir bağımlılık tanıtır.

IronBarcode Yaklaşımı

IronBarcode akıcı bir zincir kullanır. BarcodeWriter.CreateBarcode, birçok çıkış yöntemini taşıyan bir GeneratedBarcode nesnesi döndürür. Görüntü işleme dahili olup, çağrı koduna ImageSharp türü açılmaz.

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

1D barkod oluşturma için genişlik, yükseklik ve etiket yapılandırması dahil ayrıntılı seçeneklerIronBarcodedokümantasyonunda kapsanmıştır.

NetBarcode Yaklaşımı

NetBarcode'un bir okuma API'si yoktur. Barkod görüntüsünü verisine geri çözecek bir yöntem, sınıf veya yapılandırma yoktur. Bu, bir sürüm beklenirken eksiklik değil, kasıtlı bir kapsam sınırıdır.NetBarcodeile barkod üreten ve daha sonra bunları okuması gereken bir proje — basılı bir etiketi doğrulamak, bir iade gönderisini taramak veya bir tedarikçi faturasından değerler çıkarmak için — bu amaç için ayrı bir kütüphane eklemelidir.

//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

NetBarcode ile birlikte okuma için eklenen en yaygın kütüphane ZXing.Net kütüphanesidir ve QR kodları için zaten eklenmiş olan herhangi bir 2D kütüphane ile birlikte NetBarcode'un yanında üçüncü bir API yüzeyi ve üçüncü bir paket getirmiş olur.

IronBarcode Yaklaşımı

IronBarcode, BarcodeReader ile aynı pakette BarcodeWriter içerir. Okuma API'si görüntü dosyalarını ve PDF belgelerini kabul eder ve PDF'den okuma durumunda her biri barkod değeri, format türü ve sayfa numarasını içeren kodlanmış sonuçlar koleksiyonu döndürür.

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {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.BarcodeType}: {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.BarcodeType}: {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

görüntülerden barkod okuma kılavuzu, okuma API'sinde bulunan hız ayarı, çoklu barkod algılama ve görüntü düzeltme seçeneklerini kapsar.

NetBarcode ve ImageSharp

NetBarcodeMITlisanslıdır. Bağlı olduğu SixLabors.ImageSharp kütüphanesi farklı bir model kullanır: açık kaynak projeler ve belirlenmiş bir eşik altındaki yıllık brüt gelire sahip şirketler için ücretsizdir, ancak bu eşik üzerinde ticari lisans gereklidir. Bu ayrım, ImageSharp bir projenin .csproj içinde açıkça listelenip listelenmemiş olmasına veyaNetBarcodearacılığıyla geçişli olarak gelmesine bakılmaksızın uygulanır.

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

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

NetBarcode'un hedeflediği birincil kullanım alanı olan ölçekli barkod işleme yapan bir perakende veya lojistik şirketi için yıllık gelir, genellikle ImageSharp ticari lisansının uygulandığı eşik üstündedir. Bir uyum denetimi, paketin ağacında gömülü bu yükümlülüğü ortaya çıkarabilir.

V1.8 sürümü, ImageSharp bağımlılığının ek bir sonucunu tanıttı: GetImage() dönüş türü, dahili temsilden SixLabors.ImageSharp.Image<Rgba32>'a değişti. Özel bir yazım olmadan GetImage() çağırmış olan mevcut kod, derleme zamanında bozuldu ve yeni using direktifleri SixLabors.ImageSharp ve SixLabors.ImageSharp.PixelFormats için gerekli hale geldi. Gelecek sürümlerde ImageSharp'ın kendi API'si evrim geçirdiğinde, NetBarcode'un genel API yüzeyi sırasıyla etkilenir.

IronBarcode

IronBarcode'un SixLabors.ImageSharp bağımlılığı yoktur. Lisanslama terimleri doğrudan IronBarcode lisanslama sayfasında belirtilmiştir ve hiçbir eşik ayrımı ya da dolaylı ticari yükümlülük içermez. Değerlendirme için bir deneme anahtarı mevcuttur; satın alınan lisanslar, oluşturulan çıktılardan deneme filigranını kaldırır.

QR Kodu ve 2D Format Gereksinimleri

NetBarcode'a bir alternatif değerlendirilmesindeki en sık tetikleyici yeni bir QR kod gereksinimidir. Perakende etiketleri veya sevkiyat manifastaları için 1D barkod oluşturma ile başlayan uygulamalar genellikle bir QR kod gereksinimi takip eder — temassız bağlantılar, mobil uygulama derin bağlantıları, pazarlama kampanyaları. Type enumu QR girdisine sahip olmadığından, bu gereksinimNetBarcodeiçinde karşılanamaz. Bu açığı kapatmak için ayrı bir QR kütüphanesi ekleyen ekipler, daha sonra bir ilaç entegrasyonu içinDataMatrixgereklidir veya bir lojistik taşıyıcı iade gönderilerindePDF417talep ettiğinde, ikinci bir değerlendirme süreci ile karşılaşırlar.

Barkod Okuma Gereksinimi Olmak

Bazı projeler saf oluşturma ile başlar ve daha sonra bir doğrulama veya belge işleme gereksinimi ekler: bir basılı barkodun kaynak verileriyle eşleştiğini doğrulamak, gelen tedarikçi faturalarından barkod değerlerini çıkarmak veya iade gönderi etiketlerini taramak.NetBarcodebu konuda bir yol sağlamaz. ZXing.Net veya benzeri bir okuma kütüphanesi eklemek, zatenNetBarcodeve bir QR kütüphanesi içeren aynı kod tabanında üçüncü bir API öğrenme ve bakım yükümlülüğü ekler. Gelecekteki bir aşamada okuma gereksinimlerini öngören projeler, genellikle her iki konuyu baştan itibaren ele alacak bir kütüphane seçmenin daha verimli olduğunu bulur.

ImageSharp Ticari Lisans Denetimi

Üçüncü parti bağımlılıkların yasal ve uyum incelemeleri, bazenNetBarcodepaket ağacında yerleşik SixLabors.ImageSharp ticari lisans koşulunu ortaya çıkarır. Yıllık brüt geliri eşiği aşan şirketler için, ImageSharp seçilmiş olsun ya daNetBarcodearacılığıyla dolaylı olarak gelmiş olsun, yükümlülük geçerlidir. Takımlar bu durumu bir denetim sırasında keşfettiğinde - kabulden önce değil - planlanmış bir geçiş yerine geriye dönük bir düzeltmeyle karşılaşırlar. Bir projeye başlamadan önce bağımlılık lisansını değerlendirmek, daha temiz bir yoldur.

Çoklu Kütüphane Karmaşıklığını Azaltmak

1D üretim için NetBarcode, 2D çıktı için QR'a özel bir kütüphane ve okuma için ZXing.Net biriktirmiş olan takımlar, üç ayrı paket arasında sürüm uyumluluğunu korumak zorunda kalırlar. Her yükseltme döngüsü, üç kütüphanenin paylaşılan ImageSharp sürümü üzerinde aynı fikirde olup olmadığını kontrol etmeyi gerektirir. Projeye katılan her yeni geliştirici, kavramsal olarak bir konu olan üç farklı API ile karşılaşır. Tek bir barkod kütüphanesine konsolidasyon, alışma sürecini basitleştirir, sürüm çatışması yüzeyini azaltır ve bir sürüm döngüsüne bakım yoğunlaşmasını sağlar.

Paket Değişimi ve Geçiş Bağımlılığı Temizliği

NetBarcode'u dotnet remove package NetBarcode ile kaldırmak ilk adımdır. Projedeki diğer paketler de geçişli olarak bunu içerse, SixLabors.ImageSharp paketi bağımlılık ağacında tekrar görünebilir. Kaldırmadan sonra, ImageSharp'ın hala mevcut olup olmadığını ve ticari lisans koşulunun hala geçerli olup olmadığını doğrulamak için dotnet list package --include-transitive ile geri yüklenen paket listesini inceleyin.

GetImage() Dönüş Türü Değiştirme

GetImage() sonucunu Image<Rgba32> olarak saklayan her kod güncellenmelidir. ImageSharp türünün IronBarcode'da doğrudan bir karşılığı yoktur; değişiklik, görüntünün ardından nasıl kullanıldığına bağlıdır. Görseli bir akışa kaydeden kod, .SaveAsPng(stream) yerine doğrudan GeneratedBarcode nesnesi üzerinde kullanılabilir. Ham baytları alan kod, .ToPngBinaryData() kullanabilir. Dönen görüntü üzerinde daha fazla ImageSharp manipulasyonu yapan kodlar, bu işlemleri ayrı ayrı değerlendirmek zorunda kalacaktır.

Namespace Güncelleme

using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats; veya using SixLabors.Fonts;'yi içeren dosyalar, bu direktiflerin using IronBarCode; ile değiştirilmesi gereklidir. Bu using ifadelerini proje çapında bir arama, derleme denenmeden önce dikkat edilmesi gereken her dosyayı belirler.