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

Type enumu, NetBarcode'un üretebileceği resmi listedir. İncelendiğinde kütüphanenin kapsamını ortaya çıkarır:

//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, sekiz lineer simgoloji ailesi arasında on bir girdiye sahiptir ve bu, kütüphanenin hedeflediği kapsamı yansıtır. QR kodları, DataMatrix, PDF417, Aztek, UPC-A, UPC-E, ITF veya MSI gerektiren herhangi bir uygulama için bu formatları sağlayacak ayrı bir paket edinilmelidir.

Ayrıntılı Özellik Karşılaştırması

NetBarcode Yaklaşımı

NetBarcode, Type enumu aracılığıyla 8 semboloji ailesi arasında 11 lineer barkod enum değeri sağlar. Bu kapsam içinde format seçimi basittir — uygun enum üyesini kurucuya iletin. Sınır da aynı şekilde nettir: enum dışındaki bir formatın kullanılmaya çalışılması derleme hatasına neden olur.

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

Bu sınırın bir kısıt haline geldiği endüstriler arasında farmasötik izleme (FDA 2D barkod zorunlulukları gereği DataMatrix), havayolu biniş kartları (Aztec), lojistik manifestolar (PDF417) ve mobil pazarlama (QR Kod) bulunmaktadır. Bu gerekliliklerin her biri, NetBarcode'u bağımsız bir çözüm olarak devre dışı bırakır.

IronBarcode Yaklaşımı

IronBarcode, tüm desteklenen formatları aynı BarcodeWriter.CreateBarcode yöntemi aracılığıyla açığa çıkarır. 1D formatından 2D formatına geçerken API yüzeyi değişmez — sadece BarcodeEncoding sabiti farklılık gösterir.

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 üretim formatlarıyla birlikte tam 1D setini kapsayan desteklenen barkod formatları referansında mevcuttur.

NetBarcode Yaklaşımı

NetBarcode'un üretim modeli kurucu-tabandadır. Barcode nesnesi, veri dizesi ve Type enum değeriyle örneklenir. Çıktı ya doğrudan SaveImageFile() ile kaydedilir ya da GetImage() yoluyla Image<Rgba32> olarak alınır. Sürüm 1.8'den itibaren, GetImage() dönüş tipi SixLabors.ImageSharp tipi haline gelmiştir, bu da demektir ki dönüş değerini depolayan veya işleyen herhangi bir kod, ImageSharp API'sini içe aktarıp çalışmalıdır.

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üş tipi, alt akış kodunu ImageSharp kütüphanesine bağlar. Sonucu kabul eden veya depolayan herhangi bir yöntem, bunu Image<Rgba32> olarak beyan etmeli, çağırma koduna geçişli bir bağımlılık eklemelidir.

IronBarcode Yaklaşımı

IronBarcode bir akış zinciri kullanır. BarcodeWriter.CreateBarcode, birden fazla çıktı yöntemi taşıyan bir GeneratedBarcode nesnesi döndürür. Görüntü işleme içseldir — çağrı koduna herhangi bir ImageSharp türü açık edilmez.

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

Genişlik, yükseklik ve etiket yapılandırmasını da kapsayan 1D barkod üretimi için detaylı seçenekler IronBarcode belgelerinde kapsanmıştır.

NetBarcode Yaklaşımı

NetBarcode'un bir okuma API'si yoktur. Geri yeniden veri stringine dekodlanan bir barkod görüntüsünü çözen bir metod, sınıf veya yapılandırma mevcut değildir. Bu, bir yayın bekleyen bir eksiklik değil, bilinçli bir kapsam sınırıdır.Net/Barcodeile barkod üreten ve sonrasında bunları okumaya ihtiyaç duyan — bir basılı etiketi doğrulamak, iade gönderimi taramak veya bir tedarikçi faturasından değerleri almak için — bir proje, bu amaçla ayrı bir kütüphane tanıtmak zorundadır.

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

ZXing.Net kütüphanesi,NetBarcodeile birlikte okuma için en yaygın ekleme olup,NetBarcodeve QR kodları için zaten eklenmiş olan herhangi bir 2D kütüphane ile birlikte, sürüm yönetimini sağlamak için üçüncü bir API yüzeyini ve üçüncü bir paketi getirir.

IronBarcode Yaklaşımı

IronBarcode, BarcodeWriter ile aynı pakette BarcodeReader içerir. Okuma API görsel dosyalara ve PDF belgelerine kabul eder ve bir PDF'den okunduğunda barkod değeri, format türü ve sayfa numarası her biriyle birlikte çözülmüş sonuçların koleksiyonunu 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.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

resimlerden barkod okuyun kılavuzu, okuma API'de mevcut hız ayarlama, çoklu barkod algılama ve görüntü düzeltme seçeneklerini kapsar.

NetBarcode ve ImageSharp

NetBarcodeMITlisansına sahiptir. Bağlı olduğu SixLabors.ImageSharp kütüphanesi, farklı bir modeli kullanır: açık kaynak projeler ve belirli bir eşiğin altında yıllık brüt gelire sahip şirketler için ücretsiz, ancak bu eşik üzerinde ticari bir lisans gereklidir. Bu ayrım, ImageSharp'ın bir projenin .csproj dosyasında açıkça listelenip listelenmemesi ya daNetBarcodearacılığıyla geçişli olarak gelmesinden bağımsız olarak geçerlidir.

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

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

NetBarcode'un hedef aldığı birincil kullanım durumu olan barkodları ölçek üzerinde işleyen bir perakende veya lojistik şirketi için, yıllık gelir genellikle ImageSharp ticari lisansının geçerli olduğu eşik üzerinde olmaktadır. Bir uyumluluk denetimi, bu yükümlülüğün paket ağacına gömülü olduğunu ortaya çıkarabilir.

V1.8 sürümü, ImageSharp bağımlılığının ek bir sonucunu tanıttı: GetImage() dönüş tipi, dahili temsilden SixLabors.ImageSharp.Image<Rgba32> olarak değiştirildi. Açık bir tipi olmadan GetImage() çağıran mevcut kod, derleme sırasında bozuldu ve SixLabors.ImageSharp ve SixLabors.ImageSharp.PixelFormats için yeni using direktifleri zorunlu hale geldi. ImageSharp'un kendi API'si gelecek sürümlerde geliştiğinde, NetBarcode'un kamuya açık API yüzeyi de etkilenir.

IronBarcode

IronBarcode'un SixLabors.ImageSharp bağımlılığı yoktur. Lisanslama şartları, hiçbir bölünme eşiği veya geçişli ticari yükümlülük olmadan doğrudan IronBarcode lisanslama sayfasında belirtilmiştir. Değerlendirme için bir deneme anahtarı mevcuttur; Satın alınan lisanslar, oluşturulan çıktılardan deneme filigranını kaldırır.

QR Kod ve 2D Format Gereksinimleri

NetBarcode'a alternatif değerlendirme için en sık tetikleyici QR kodları için yeni bir gereksinimdir. Perakende etiketleri veya gönderim manifestoları için 1D barkod üretimi ile başlayan uygulamalar, genellikle QR kodları için takip eden bir gereksinim alır — temassız bağlantılar, mobil uygulama derin bağlantıları, pazarlama kampanyaları. Type enumunda QR girişi olmadığı için bu gereklilikNetBarcodeiçinde karşılanamaz. Bu açığı kapatmak için ayrı bir QR kütüphanesi ekleyen takımlar, eczacılık entegrasyonu içinDataMatrixveya gönderim etiketlerinde zorunlu kılındığı için bir lojistik taşıyıcı içinPDF417gerektiğinde ikinci bir değerlendirme ile karşılaşır.

Barkod Okuma Gerekliliği Olur

Bazı projeler saf üretimle başlar ve daha sonra doğrulama veya belge işleme gereksinimi ekler: basılı bir barkodun kaynak verileriyle eşleştiğini doğrulama, gelen tedarikçi faturalarından barkod değerlerini çıkarma veya geri gönderim etiketlerini okuma.Net/Barcodebu konuda bir yol sunmaz. ZXing.Net veya benzer bir okuma kütüphanesi eklenmesi,NetBarcodeve bir QR kütüphanesini zaten barındıran aynı kod tabanında öğrenme ve bakım yükünü arttıran üçüncü bir API tanıtır. Okuma gereksinimlerini gelecekte bir aşamada bile bekleyen projeler, başından beri her iki konuda da işlem yapan bir kütüphane seçmenin daha verimli olduğunu sıklıkla bulur.

ImageSharp Ticari Lisans Denetimi

Üçüncü taraf bağımlılıklarının yasal ve uyumluluk incelemeleri ara sıraNetBarcodepaket ağacına gömülü olan SixLabors.ImageSharp ticari lisans koşulunu ortaya çıkarır. Yıllık brüt geliri eşiği aşan şirketler için, SixLabors.ImageSharp kasten seçilmiş olsun ya da geçişli olarakNetBarcodearacılığıyla gelmiş olsun yükümlülük geçerlidir. Bu sorunu bir denetim sırasında keşfeden ekipler — benimsemeden önce değil — planlanan bir geçiş yerine geriye dönük bir düzeltme ile karşılaşır. Bir projeye başlamadan önce bağımlılık lisansını değerlendirmek daha temiz bir yol.

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

1D üretimi için NetBarcode, 2D çıkış için QR özel bir kütüphane ve okumak için ZXing.Net toplayan ekipler kendilerini üç ayrı paket arasında sürüm uyumluluğunu sürdürüyor olarak bulurlar. Her bir yükseltme döngüsü, üç kütüphanenin ortak ImageSharp sürümünde anlaştığını kontrol etmeyi gerektirir. Projeye katılan her yeni geliştirici, kavramsal olarak tek bir konu için üç farklı API ile karşılaşır. Tek bir barkod kütüphanesine konsolidasyon, yeni başlayanlar için eğitimi basitleştirir, sürüm çatışması yüzeyini azaltır ve bakım işlemlerini tek bir sürüm döngüsüne yoğunlaştırır.

Paket Değiştirme ve Geçişli Bağımlılık Temizleme

NetBarcode'u dotnet remove package NetBarcode ile kaldırmak ilk adımdır. Projelerdeki diğer paketler de geçişli olarak çekiyorsa SixLabors.ImageSharp paketi bağımlılık ağacında tekrar görünebilir. Kaldırıldıktan sonra, ImageSharp'ın hala mevcut olup olmadığını ve ticari lisans koşulunun hala geçerli olup olmadığını onaylamak 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 depolayan herhangi bir kod güncellenmelidir. ImageSharp türü IronBarcode içinde doğrudan eşdeğer yoktur; değişim, görüntünün aşağı akışta nasıl kullanıldığına bağlıdır. Görüntüyü bir akışa kaydeden kod, doğrudan GeneratedBarcode nesnesi üzerinde .SaveAsPng(stream) ile değiştirilebilir. Ham baytları alan kod, .ToPngBinaryData() kullanabilir. Dönen görüntü üzerinde daha fazla ImageSharp manipülasyonu yapan kodlar, bu işlemleri bireysel olarak değerlendirmeye ihtiyaç duyacaktır.

Namespace Güncellemesi

using NetBarcode;, using SixLabors.ImageSharp;, using SixLabors.ImageSharp.PixelFormats; veya using SixLabors.Fonts; içe aktaran dosyalar, bu direktiflerin using IronBarCode; ile değiştirilmesi gerektirir. Bu using deyimlerini proje genelinde arama yaparak, derleme denemesi öncesinde dikkat gerektiren her dosya belirlenir.