Tür Belirtimi Gereksinimi

Spire.Barcode'un BarcodeScanner.Scan() yalnızca bir dosya yolunu kabul eden bir aşırı yüklemeye sahip değildir. Her okuma işlemi, çağrılan kodun barkod formatını önceden beyan etmesini gerektirir. Tek formatlı iş akışları için bu çalışabilir, ancak karışık formatlı belge işleme için bir aday yineleme döngüsü üretir:

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

Aday dizisine eklenen her tür, ek bir tarama geçişidir. Listede bulunmayan herhangi bir format sessizce atlanır. Geliştirici, kapsamlı bir tür envanteri tutmaktan ve iş akışına yeni bir format girdiğinde yeniden test yapmaktan sorumludur.

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

Spire.Barcode Yaklaşımı

Spire.Barcode'un BarcodeScanner.Scan() her çağrıda bir BarCodeType parametresini gerektirir. Tek tür çağrısı, formatın bilinmesi ve garanti edilmesi durumunda uygundur:

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

Format önceden bilinmediğinde, mevcut tek yaklaşım aday türleri arasından yinelemektir. Her yineleme tam bir tarama geçişidir ve listede olmayan herhangi bir format sessizce atlanır. Sonuç, format bilgisi içermeyen bir string[], bu nedenle formata dayalı alt yörüngelendirme, arayan tarafından ek durum yönetimi gerektirir.

IronBarcode Yaklaşımı

IronBarcode'un BarcodeReader.Read() tür parametresi gerektirmez. Kütüphane, desteklenen tüm sembolojiler arasında otomatik olarak formatı belirler. Görüntülerden barkod okuma, kaynakta kaç farklı format olursa olsun tek bir metot çağrısıdır:

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Her sonuç nesnesi Format, Value ve konumsal meta verileri içerir. Format bazlı yönlendirme, sonuçta tip mevcutken ek bir durum gerektirmez.

Spire.Barcode Ücretsiz Seviyesi

FreeSpire.Barcode üretilen barkod imajlarına büyük bir değerlendirme su oylumu uygular. Filigran, barkodu üretim kullanımı için uygun olmaktan çıkaracak şekilde kaplar ve üretim kalitesinin anlamlı bir değerlendirmesini gizler. Ücretsiz sürümde tarama performansı kasıtlı olarak düşürülür, bu da değerlendirme sırasında yapılan verim ölçümlerinin ticari Spire.Barcode performansını temsil etmediği anlamına gelir. Ücretsiz paket ayrıca çalıştırma sırasında uyarı iletişim kutuları bastırılmadan önce E-iceblue'dan elde edilen bir kayıt anahtarı gerektirir. Ücretsiz seviyedeki mevcut semboloji seti, ticari teklifin bir alt kümesidir. Bu kısıtlamalar topluca, FreeSpire.Barcode üzerine kurulmuş bir değerlendirmenin, ticari ürünün sunduğunu doğru bir şekilde temsil etmediğini ifade eder.

IronBarcode Deneme Modu

IronBarcode'un denemesi, bir lisans anahtarı kullanılmadan kullanılan lisanslı pakettir. Okuma, tam hızda çalışır, tam semboloji desteği sağlar ve davranışsal kısıtlamalar içermez. Okuma hızı ve doğruluk seçenekleri deneme ve lisanslı modda aynı şekilde davranır. Deneme modunda üretilen barkod çıktısı, görüntünün kenarında küçük bir filigran taşır; barkodun kendisini gizlemez.IronBarcode değerlendirmesi sırasında ölçülen davranış, üretime gönderilen davranıştır.

Spire.Barcode Yaklaşımı

Spire.Barcode'un yerel bir PDF okuma özelliği yoktur. Bir PDF dosyasından barkod çıkarmak için geliştirici ayrı bir Spire.PDF paketi yüklemeli, ayrı bir Spire.PDF lisansı satın almalı ve barkod taramaya başlamadan önce manuel sayfa yineleme ve resim çıkarma kodu yazmalıdır:

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

Bu model, iki NuGet paketi, iki lisans anlaşması ve geliştirici yazılı sayfa yönetim kodu gerektirir. Eğer barkodlar PDF içinde raster görüntüler yerine vektör içeriğe gömülüyorsa, resim çıkarma yaklaşımı onları tamamen kaçırabilir.

IronBarcode Yaklaşımı

IronBarcode, PDF dosyalarını herhangi bir ek bağımlılık olmadan yerel olarak işler. PDF belgelerinden barkod okuma, resim dosyaları için kullanılan BarcodeReader.Read() API'siyle aynı olan tek bir yöntem çağrısıdır. Sayfa numaraları her sonuç nesnesine dahildir:

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

Manuel sayfa çıkarmaya, ikincil pakete ve ek lisans satın almaya gerek yoktur.

Spire.Barcode Yaklaşımı

Spire.Barcode'un üretim modeli, ayarlanabilir bir BarcodeSettings yapılandırma nesnesine odaklanır. Bir geliştirici ayarları başlatır, özellikleri tek tek atar, ayar nesnesini bir BarCodeGenerator'e geçirir ve ardından GenerateImage() çağırır:

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

Değiştirilebilir ayarlar nesnesi, birden fazla üretim işlemi boyunca tek bir örnek yeniden kullanıldığında yapılandırmaların yanlışlıkla paylaşıldığı anlamına gelir. Üretici sınıfı, kendi başına hiçbir yapılandırma mantığı taşımayan ek bir başlatma adımı ekler.

IronBarcode Yaklaşımı

IronBarcode, isteğe bağlı akıcı zincirleme ile statik bir fabrika yöntemi kullanır. Yönetilecek bir ayarlar nesnesi veya üretici örneği yoktur:

//IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

//IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' IronBarcode generation
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Özel logolara sahip QR kodları tüm IronBarcode lisans seviyelerinde mevcuttur:

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

Karışık Formatlı Belge İşleme

Tek bir bilinen barkod formatı ile başlayıp zamanla format çeşitliliği büyüyen ekipler. Code128 etiketleriyle başlayan bir depolama uygulaması, DataMatrix, GS1-128 veya QR kodları kullanan tedarikçilerden sevkiyat alabilir. İş akışına giren her yeni format, aday dizisini tür tahmin döngüsünde güncellemeyi, algılama mantığını yeniden test etmeyi ve hiçbir mevcut formatın yineleme sırasından etkilenmediğini doğrulamayı gerektirir. Format çeşitliliği, bu döngünün bakım yükünün tekrarlayan bir geliştirme maliyeti haline geldiği bir noktaya ulaştığında, ekipler bu yükün tamamen ortadan kaldırılıp kaldırılmayacağını değerlendirilir.

PDF Entegrasyonu

Belge ağırlıklı uygulamalar genellikle barkodların bağımsız görüntüler yerine PDF dosyalarından çıkarılması gereken bir anla karşılaşır. Bir Spire.Barcode iş akışında, bu geçiş bir Spire.PDF lisansı edinmeyi gerektirir, ikinci bir paketi entegre etmeyi ve herhangi bir barkod okuma işlemi gerçekleşmeden önce sayfa yineleme ve görüntü çıkarma altyapısı yazmayı gerektirir. İlk satın alımda bu gereksinimi öngörmeyen ekipler, barkod okuma işlemine kavramsal olarak ait olan bir görev için iki ürün lisansını ve iki API yüzeyini yönetirken kendilerini bulurlar. PDF desteğinin ayrı bir satın alma gerektirdiğinin öğrenilmesi, ürün seçimini yeniden değerlendirmek için yaygın bir tetikleyici olur.

Ücretsiz Seviye Değerlendirme Sınırlamaları

FreeSpire.Barcode'u değerlendiren ve ardından ticari lisansı satın alan ekipler, bazen ticari ürünün değerlendirmede önerilenden farklı davrandığını rapor eder. Bu, tasarıma göredir: Ücretsiz seviye, okuma performansını kasıtlı olarak düşürür ve semoloji setini kısıtlar, bu da değerlendirme sırasında yapılan kıyaslamaların ve format kapsamı testlerinin ticari dağıtıma aktarılmadığı anlamına gelir. Bir ekip bu tutarsızlığı satın aldıktan sonra keşfettiğinde, deneme davranışının üretim davranışını temsil eden alternatifler ararlar.

Ürün Sayısını Azaltma

Teknoloji yığınını standartlaştıran kuruluşlar bazen Spire.Barcode'u, her biri kendi lisans maliyeti ve yenileme döngüsüne sahip olan E-iceblue ürünlerinin büyüyen bir envanterinde yalnızca bir bileşen olarak tanımlar. Spire.Barcode'un birincil itici gücü, bir belge işleme hattı içinde barkod okuma ise — Spire.Doc veya Spire.XLS ile derin entegrasyon yerine — ekipler, tek bir bağımsız barkod kütüphanesinin lisans karmaşıklığını ve destek yüzeyini azaltıp azalmayacağını değerlendirir.

Barkod Türü Parametresini Kaldırma

Bir Spire.Barcode kod tabanındaki her scanner.Scan() çağrısı bir BarCodeType argümanı taşır. Bu çağrıları BarcodeReader.Read() ile değiştirmek tür parametresini tamamen kaldırır. Tür tahmin döngüleri — aday BarCodeType değerleri üzerinden yineleme yapan foreach blokları — tamamen silinebilir; tek bir BarcodeReader.Read() çağrısı tüm döngüyü değiştirir.

Dönüş Türünü Güncelleme

Spire.Barcode'un Scan(), string[] döner.IronBarcode bir BarcodeResults koleksiyonu döner. string[] atama veya bu türü bekleyen yöntemlere sonuçları geçiren çağrı noktaları güncellenmelidir. Bir dizi olarak değerleri çıkarmak .Select(r => r.Value).ToArray() kullanır; ilk sonucu elde etmek .First()?.Value kullanır.

Spire.PDF Paketini Kaldırma

Spire.PDF yalnızca PDF dosyalarından barkod çıkarmayı desteklemek amacıyla yüklendiyse, IronBarcode'a geçiş yapıldıktan sonra kaldırılabilir. Tüm using Spire.Pdf; içe aktarımları ve manuel sayfa yineleme blokları, tek bir BarcodeReader.Read("file.pdf") çağrısıyla değiştirilir. Spire.PDF barkod çıkarma dışında diğer belge işlemleri için kullanılıyorsa, tutulmalıdır ve yalnızca barkodla ilgili kod yolları değiştirilmelidir.

Ad Alanı Değişiklikleri

using Spire.Barcode;, using IronBarCode; ile değiştirin. BarCodeType enumu, oluşturma için BarcodeEncoding ile değiştirilir ve okuma için eşdeğeri gerekmez. Lisans başlatma, uygulama başlatmada tek bir IronBarCode.License.LicenseKey özellik atamasına dönüşür.