Bu kılavuz, OnBarcode'dan IronBarcode'a geçiş yolunu tamamen kapsar. Üç adımlı kurulum değişikliğini ele alır, her yaygın desen için önceki ve sonraki kod örnekleri sağlar,OnBarcodeAPI'sini IronBarcode eşdeğerlerine eşler, geçiş sırasında ortaya çıkan sorunları belgeler ve geçişi tamamladığınızı düşündüğünüzde kod tabanınızı denetlemek için arama terimleri listesi sunar.

Neden OnBarcode'dan Geçiş Yapmalısınız?

İki SKU Satın Alma Aşırı Yükü: OnBarcode, Generator SDK (Sadece Doğrusal ve Doğrusal + 2D kademeleri) için sürekli fiyatlandırma yayınlar ve Reader SDK'yı ayrı fiyatlandırılmış bir ürün olarak listeler. Her iki yeteneğe sahip olması gereken bir organizasyon, iki SKU'ya karşı iki satın alma işlemi tamamlamalıdır — kullanılan semboloji için doğru Generator kademesini seçmek, sonra Okuyucuyu ayrı olarak satın almak — toplam maliyet belirlenmeden önce. Sürtüşme, tek bir kalemlik satın alma yerine iki ayrı satın alma durumunda tekrar eder.

Bölünmüş Ürün Yükü: Üretim ve okuma ayrı ürünlerdir ve ayrı NuGet paketleri, ayrı lisans isim alanları, ayrı lisans anahtarları ve ayrı sürüm programları vardır. Her iki ürünü kullanan bir proje, başlangıçta iki lisans anahtarı yapılandırmalı, yükseltmeler boyunca iki paket sürümünü izlemeli ve iki bağımsız sürüm döngüsünün farkında olmalıdır. Oku talebi başlangıçta yalnızca üretim olan bir projeye eklendiğinde, ikinci ürün için tüm tedarik ve entegrasyon süreci yeniden yapılmalıdır.

PDF İş Akışı Boşlukları: OnBarcode, PDF belgelerinden barkod okumak için yerel desteğe sahip değil. Faturalar, nakliye manifestleri, satın alma emirleri veya arşiv taramaları içine gömülü barkodları işleyen projeler, ayrı bir PDF-görüntü işleme kütüphanesi edinmeli, boru hattına entegre etmeli, lisansını ayrı olarak yönetmeli ve her birini birer birerOnBarcodeReader SDK'sına iletmelidir. Bu, tek bir bağımlılık çözümünün yeterli olamayacağı iki-bağımlılık çözümüne yol açar.

**API Belirginliği:**OnBarcodejeneratörü, bir Barcode nesnesini başlatmayı, Resolution, BarWidth ve BarHeight gibi mantıklı varsayılanlar içeren özelliklerin atanmasını ve ardından bir üretim yönteminin çağrılmasını gerektirir. Aynı çıktı, statik fabrika API'si kullanılarak önemli ölçüde daha az kodla üretilebilir. Toplu üretim üzerinde arttıkça, özellik atama deseni büyük miktarda tekrarlayan kod üretir, bu da gözden geçirilmesi ve bakımı yapılması gereken büyük miktardadır.

Temel Sorun

Çift-lisans yapılandırması, hem üretim hem de okuma gereksinimi duyan herhangi bir proje için en acil sürtünme noktasıdır. OnBarcode, başlangıçta iki ayrı lisans isim alanına iki ayrı çağrı gerektirir:

// OnBarcode: two products, two DLL references, no runtime key
//OnBarcodeuses pre-licensed DLLs — the purchased DLL is already activated.
// There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// OnBarcode: two products, two DLL references, no runtime key
//OnBarcodeuses pre-licensed DLLs — the purchased DLL is already activated.
// There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
using OnBarcode.Barcode;
using OnBarcode.Barcode;

IronBarcode, tüm yetenekleri — üretim, okuma, PDF desteği ve toplu işlemler — kapsayan tek bir özelliği atamayla ve tek bir anahtar altında azaltır.

// IronBarcode: one package, one key, one line
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// IronBarcode: one package, one key, one line
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Uygulamadaki her barkod işlemi — ister üretim yapıyor, ister okuyucu, ister PDF işliyor olsun — bu tek konfigürasyon altında çalışır.

IronBarcode vs OnBarcode: Özellik Karşılaştırması

Hızlı Başlangıç: OnBarcode'dan IronBarcode'a Geçiş

Adım 1:OnBarcodePaket Referanslarını Kaldırın

Projeniz NuGet paketlerini kullanıyorsa, her ikisini de kaldırın:

dotnet remove package OnBarcode.Barcode.Generator
dotnet remove package OnBarcode.Barcode.Reader

dotnet remove package OnBarcode.Barcode.Generator
dotnet remove package OnBarcode.Barcode.Reader

Projeniz eski DLL tabanlı dağıtımı kullanıyorsa, ayrıca manuel referans bloğunu .csproj'dan kaldırın:

<!-- Remove this block entirely -->
<ItemGroup>
  <Reference Include="OnBarcode.Barcode">
    <HintPath>lib\OnBarcode.Barcode.dll</HintPath>
    <Private>true</Private>
  </Reference>
</ItemGroup>

<!-- Remove this block entirely -->
<ItemGroup>
  <Reference Include="OnBarcode.Barcode">
    <HintPath>lib\OnBarcode.Barcode.dll</HintPath>
    <Private>true</Private>
  </Reference>
</ItemGroup>

DLL dosyalarını lib/ dizininden veya depolandıkları yerden silin. Eski montajların, yeni NuGet paketiyle birlikte bırakılması derleme zamanında isim alanı çatışmalarına yol açar.

Adım 2:IronBarcode Ekle

Bir paket, üretim, okuma ve PDF desteğini kapsar:

dotnet add package IronBarcode

dotnet add package IronBarcode

Okuma için ikinci bir paket gerekli değil. PDF desteği için ikinci bir paket gerekli değil.

Adım 3: İsim Alanlarını Güncelleyin ve İkili Lisans Yapılandırmasını Değiştirin

Her ikiOnBarcodeusing direktifini tek bir IronBarcode ithalatı ile değiştirin:

// Remove
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// Add
using IronBarCode;

// Remove
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// Add
using IronBarCode;

Imports IronBarCode

Imports IronBarCode

Çift DLL referanslarını tek bir anahtar ataması ile değiştirin. Bu işlemi uygulamanın başlangıcında bir kez, herhangi bir barkod işlemi çalışmadan önce yerleştirin:

// Remove theOnBarcodeDLL references and using directives
// Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove theOnBarcodeDLL references and using directives
// Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Kod Göç Örnekleri

Code 128 Barkod Oluşturma

Temel Code 128 durumu, özellik-atama deseni ile statik fabrika desenini karşılaştırarak gösterir.

OnBarcode Yaklaşımı:

using OnBarcode.Barcode;

Linear barcode = new Linear();
barcode.Type = BarcodeType.CODE128;
barcode.Data = "SHIP-2024-001";
barcode.Resolution = 96;
barcode.X = 1;
barcode.BarcodeHeight = 80;
barcode.ShowText = true;
barcode.drawBarcode("shipping-label.png");

using OnBarcode.Barcode;

Linear barcode = new Linear();
barcode.Type = BarcodeType.CODE128;
barcode.Data = "SHIP-2024-001";
barcode.Resolution = 96;
barcode.X = 1;
barcode.BarcodeHeight = 80;
barcode.ShowText = true;
barcode.drawBarcode("shipping-label.png");

Imports OnBarcode.Barcode

Dim barcode As New Linear()
barcode.Type = BarcodeType.CODE128
barcode.Data = "SHIP-2024-001"
barcode.Resolution = 96
barcode.X = 1
barcode.BarcodeHeight = 80
barcode.ShowText = True
barcode.drawBarcode("shipping-label.png")

Imports OnBarcode.Barcode

Dim barcode As New Linear()
barcode.Type = BarcodeType.CODE128
barcode.Data = "SHIP-2024-001"
barcode.Resolution = 96
barcode.X = 1
barcode.BarcodeHeight = 80
barcode.ShowText = True
barcode.drawBarcode("shipping-label.png")

IronBarcode Yaklaşımı:

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

Veri ve kodlama türü, CreateBarcode için argüman olarak geçirilir. Çözünürlük ve çubuk yüksekliği gibi özellikler, taranabilir bir çıktı üretmek için gerekli değildir; varsayılanlar çoğu uygulama için uygundur. Özel boyutlar gerektiğinde, bunlar, CreateBarcode ile SaveAsPng arasında zincirli çağrılar olarak eklenebilir, değiştirilebilir nesne durumu oluşturmadan.

Logo ile QR Kod Oluşturma

Logo markalı QR kodları, görüntü kaplama adımında OnBarcode'un System.Drawing adımına dönmesini gerektirir.IronBarcode bunu yerleşik bir işlem olarak sunar.

OnBarcode Yaklaşımı:

using OnBarcode.Barcode;
using System.Drawing;

QRCode qr = new QRCode();
qr.Data = "https://example.com/product/4891";
qr.QRCodeDataMode = QRCodeDataMode.Auto;
qr.QRCodeECL = QRCodeECL.H; // H-level error correction required for logo overlay

Image qrImage = qr.drawBarcode();

using (Graphics g = Graphics.FromImage(qrImage))
{
    Image logo = Image.FromFile("brand-logo.png");
    int logoSize = qrImage.Width / 5;
    int x = (qrImage.Width - logoSize) / 2;
    int y = (qrImage.Height - logoSize) / 2;
    g.DrawImage(logo, x, y, logoSize, logoSize);
}

qrImage.Save("product-qr.png");

using OnBarcode.Barcode;
using System.Drawing;

QRCode qr = new QRCode();
qr.Data = "https://example.com/product/4891";
qr.QRCodeDataMode = QRCodeDataMode.Auto;
qr.QRCodeECL = QRCodeECL.H; // H-level error correction required for logo overlay

Image qrImage = qr.drawBarcode();

using (Graphics g = Graphics.FromImage(qrImage))
{
    Image logo = Image.FromFile("brand-logo.png");
    int logoSize = qrImage.Width / 5;
    int x = (qrImage.Width - logoSize) / 2;
    int y = (qrImage.Height - logoSize) / 2;
    g.DrawImage(logo, x, y, logoSize, logoSize);
}

qrImage.Save("product-qr.png");

Imports OnBarcode.Barcode
Imports System.Drawing

Dim qr As New QRCode()
qr.Data = "https://example.com/product/4891"
qr.QRCodeDataMode = QRCodeDataMode.Auto
qr.QRCodeECL = QRCodeECL.H ' H-level error correction required for logo overlay

Dim qrImage As Image = qr.drawBarcode()

Using g As Graphics = Graphics.FromImage(qrImage)
    Dim logo As Image = Image.FromFile("brand-logo.png")
    Dim logoSize As Integer = qrImage.Width \ 5
    Dim x As Integer = (qrImage.Width - logoSize) \ 2
    Dim y As Integer = (qrImage.Height - logoSize) \ 2
    g.DrawImage(logo, x, y, logoSize, logoSize)
End Using

qrImage.Save("product-qr.png")

Imports OnBarcode.Barcode
Imports System.Drawing

Dim qr As New QRCode()
qr.Data = "https://example.com/product/4891"
qr.QRCodeDataMode = QRCodeDataMode.Auto
qr.QRCodeECL = QRCodeECL.H ' H-level error correction required for logo overlay

Dim qrImage As Image = qr.drawBarcode()

Using g As Graphics = Graphics.FromImage(qrImage)
    Dim logo As Image = Image.FromFile("brand-logo.png")
    Dim logoSize As Integer = qrImage.Width \ 5
    Dim x As Integer = (qrImage.Width - logoSize) \ 2
    Dim y As Integer = (qrImage.Height - logoSize) \ 2
    g.DrawImage(logo, x, y, logoSize, logoSize)
End Using

qrImage.Save("product-qr.png")

IronBarcode Yaklaşımı:

using IronBarCode;

var qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500);
qr.SaveAsPng("product-qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500);
qr.SaveAsPng("product-qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500)
qr.SaveAsPng("product-qr.png")

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500)
qr.SaveAsPng("product-qr.png")

Hata düzeltme seviyesi, logo boyutlandırma hesaplaması ve görüntü bileşimi dahili olarak ele alınır. Hiçbir System.Drawing bağımlılığı gerekli değildir.

Görüntüden Barkod Okuma

Bir görüntü dosyasından okuma, ürün birleşimini en net şekilde gösterir.OnBarcodeile birlikte, okuma, ayrı bir Reader SDK, ayrı bir lisans çağrısı ve açık format belirtimi gerektirir.IronBarcode ile aynı paket ve anahtarla yerine geçen tek bir statik çağrıdır.

OnBarcode Yaklaşımı:

using OnBarcode.Barcode;

//OnBarcodereader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };
string[] results = scanner.Scan("received-label.png");

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

using OnBarcode.Barcode;

//OnBarcodereader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };
string[] results = scanner.Scan("received-label.png");

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

IronBarcode Yaklaşımı:

using IronBarCode;

var results = BarcodeReader.Read("received-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

using IronBarCode;

var results = BarcodeReader.Read("received-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

Imports IronBarCode

Dim results = BarcodeReader.Read("received-label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Imports IronBarCode

Dim results = BarcodeReader.Read("received-label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Nesne oluşturma yok, format dizisi yok, ayrı lisans yapılandırması yok. Format otomatik olarak algılanır. Her sonuç, çözülen değeri ve algılanan formatı taşır. Okuma seçenekleri ve desteklenen görüntü türleri hakkında daha fazla bilgi için görüntülerden barkod okuma kılavuzuna bakın.

PDF'den Barkod Okuma

Bu geçiş örneği, PDF sayfalarını bir üçüncü taraf kütüphane kullanarak görüntülere dönüştürüp bu görüntüleriOnBarcodeReader SDK'sına ileten takımlar için geçerlidir.

OnBarcode Yaklaşımı:

//OnBarcodehas no native PDF support.
// A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
var pageImages = RenderPdfPagesToImages("invoices.pdf"); // external library call

using OnBarcode.Barcode;
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };

foreach (var pageImage in pageImages)
{
    string[] results = scanner.Scan(pageImage);
    foreach (string value in results)
        Console.WriteLine(value);
}

//OnBarcodehas no native PDF support.
// A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
var pageImages = RenderPdfPagesToImages("invoices.pdf"); // external library call

using OnBarcode.Barcode;
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };

foreach (var pageImage in pageImages)
{
    string[] results = scanner.Scan(pageImage);
    foreach (string value in results)
        Console.WriteLine(value);
}

IronBarcode Yaklaşımı:

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}");

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}");

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}")
Next

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}")
Next

Rendelenme adımı yok, harici PDF kütüphanesi yok, format dizisi yok. PDF barkod okuma yeteneği, tüm sayfaları otomatik olarak işler ve her sonuca sayfa numarasını ekler.

Toplu Üretim

Öğeler koleksiyonu için barkod üretimi, tekli üretim ile aynı desen farkını takip eder.

OnBarcode Yaklaşımı:

using OnBarcode.Barcode;

foreach (var item in inventoryItems)
{
    Linear barcode = new Linear();
    barcode.Type = BarcodeType.CODE128;
    barcode.Data = item.Sku;
    barcode.Resolution = 96;
    barcode.BarWidth = 1;
    barcode.BarHeight = 80;
    barcode.ShowText = true;
    barcode.drawBarcode($"labels/{item.Id}.png");
}

using OnBarcode.Barcode;

foreach (var item in inventoryItems)
{
    Linear barcode = new Linear();
    barcode.Type = BarcodeType.CODE128;
    barcode.Data = item.Sku;
    barcode.Resolution = 96;
    barcode.BarWidth = 1;
    barcode.BarHeight = 80;
    barcode.ShowText = true;
    barcode.drawBarcode($"labels/{item.Id}.png");
}

Imports OnBarcode.Barcode

For Each item In inventoryItems
    Dim barcode As New Linear()
    barcode.Type = BarcodeType.CODE128
    barcode.Data = item.Sku
    barcode.Resolution = 96
    barcode.BarWidth = 1
    barcode.BarHeight = 80
    barcode.ShowText = True
    barcode.drawBarcode($"labels/{item.Id}.png")
Next

Imports OnBarcode.Barcode

For Each item In inventoryItems
    Dim barcode As New Linear()
    barcode.Type = BarcodeType.CODE128
    barcode.Data = item.Sku
    barcode.Resolution = 96
    barcode.BarWidth = 1
    barcode.BarHeight = 80
    barcode.ShowText = True
    barcode.drawBarcode($"labels/{item.Id}.png")
Next

IronBarcode Yaklaşımı:

using IronBarCode;

foreach (var item in inventoryItems)
{
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128)
        .SaveAsPng($"labels/{item.Id}.png");
}

using IronBarCode;

foreach (var item in inventoryItems)
{
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128)
        .SaveAsPng($"labels/{item.Id}.png");
}

Imports IronBarCode

For Each item In inventoryItems
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128) _
        .SaveAsPng($"labels/{item.Id}.png")
Next

Imports IronBarCode

For Each item In inventoryItems
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128) _
        .SaveAsPng($"labels/{item.Id}.png")
Next

OnBarcode API'den IronBarcode Eşleme Başvuru

Yaygın Göç Sorunları ve Çözümleri

Sorun 1: DLL Referans Çatışmaları

OnBarcode: Eski DLL dağıtımındaki projeler .csproj içinde lib\OnBarcode.Barcode.dll veya benzer yolları işaret eden <Reference> öğeleri içerir.IronBarcode eklendiğinde eski DLL disk üzerinde kalırsa, derleyici aynı ad alanı öneklerini sağlayan iki derleme görecek ve belirsiz referans hataları üretecektir.

Çözüm: dotnet add package IronBarcode çalıştırmadan önce .csproj'den <ItemGroup> referans bloğunu kaldırın. DLL dosyalarını diskten silin. Temiz bir derleme ile, eskimiş derleme referanslarının kalmadığını doğrulayın.

# Search for lingeringOnBarcodeDLL references in project files
grep -r "OnBarcode" --include="*.csproj" .
grep -r "OnBarcode" --include="*.props" .

# Search for lingeringOnBarcodeDLL references in project files
grep -r "OnBarcode" --include="*.csproj" .
grep -r "OnBarcode" --include="*.props" .

Konu 2: Aşamalı Göç Sırasında Tür Adı Çakışmaları

OnBarcode: Okuyucu ad alanı, BarcodeScanner adlı bir sınıf ihraç eder. IronBarcode, BarcodeReader adlı bir statik sınıfa sahiptir. Bu isimler doğrudan çatışmaz, ancak hem OnBarcode.Barcode.Reader hem de IronBarCode'yi aynı anda içe aktaran herhangi bir dosya BarcodeType enum belirsizliği görebilir —OnBarcodeformat seçimi için BarcodeType tanımlar ve IronBarcodeBarcodeEncoding kullanır. Geçiş sırasında her iki ad alanını aktif tutmak, herhangi bir BarcodeType referansında derleme hatalarına neden olacaktır.

Çözüm: Her dosyanın geçişini atomik olarak tamamlayın — aynı düzenlemede using OnBarcode.Barcode.Reader yönergesini kaldırın ve using IronBarCode ekleyin. Hiçbir dosyada her iki 'using' direktifini bırakmayın. Aşamalı bir yaklaşım gerekliyse, geçici olarak tam nitelikli adlar kullanın:

// Temporary disambiguation during phased migration
var results = IronBarCode.BarcodeReader.Read("file.png");

// Temporary disambiguation during phased migration
var results = IronBarCode.BarcodeReader.Read("file.png");

' Temporary disambiguation during phased migration
Dim results = IronBarCode.BarcodeReader.Read("file.png")

' Temporary disambiguation during phased migration
Dim results = IronBarCode.BarcodeReader.Read("file.png")

Sorun 3: BarcodeType Dizisi Kaldırma

OnBarcode: Okuyucu 'reader.BarcodeTypes = new BarcodeType[] { ... }' işlevi görmesi için gereklidir. Okuyucu kodunu taşıyan geliştiriciler, formatları açıkça belirtme alışkanlığını taşıyabilir ve IronBarcode içinde bir eşdeğer yapılandırma arayabilir.

Çözüm: Format belirtimini tamamen kaldırın. BarcodeReader.Read desteklenen tüm formatlar arasında otomatik algılama gerçekleştirir. Herhangi bir yapılandırma gerekmez ve IronBarcode içinde BarcodeType[] eşdeğeri mevcut değildir çünkü gerekli değildir.

// No format configuration required
var results = BarcodeReader.Read("label.png");

// No format configuration required
var results = BarcodeReader.Read("label.png");

Dim results = BarcodeReader.Read("label.png")

Dim results = BarcodeReader.Read("label.png")

OnBarcode Göç Kontrol Listesi

Geçiş Öncesi Görevler

OnBarcode kullanımlarını tespit etmek için kod tabanını inceleyin ve değişiklik yapmadan önce:

# Find allOnBarcodenamespace imports
grep -rn "using OnBarcode" --include="*.cs" .

# Find all license configuration calls
grep -rn "SetLicense" --include="*.cs" .

# Find all generator usage
grep -rn "new Linear\|new QRCode\|drawBarcode\|BarcodeType\." --include="*.cs" .

# Find all reader usage
grep -rn "BarcodeScanner\|\.Scan(\|BarcodeType\[\]" --include="*.cs" .

# Find DLL references in project files
grep -rn "OnBarcode" --include="*.csproj" .
grep -rn "OnBarcode" --include="*.sln" .

# Find allOnBarcodenamespace imports
grep -rn "using OnBarcode" --include="*.cs" .

# Find all license configuration calls
grep -rn "SetLicense" --include="*.cs" .

# Find all generator usage
grep -rn "new Linear\|new QRCode\|drawBarcode\|BarcodeType\." --include="*.cs" .

# Find all reader usage
grep -rn "BarcodeScanner\|\.Scan(\|BarcodeType\[\]" --include="*.cs" .

# Find DLL references in project files
grep -rn "OnBarcode" --include="*.csproj" .
grep -rn "OnBarcode" --include="*.sln" .

Hangi dosyaların sadece üretim, hangilerinin okuma kullandığını ve hangilerinin her ikisini kullandığını belgeleyin. NuGet paket referansı yerine manuel <Reference> DLL bloğu içeren dosyaları not edin.

Kod Güncelleme Görevleri

1. OnBarcode.Barcode.Generator NuGet paketini kaldırın
2. OnBarcode.Barcode.Reader NuGet paketini kaldırın
3. Herhangi bir manuel <Reference> DLL girdilerini .csproj dosyalarından kaldırın 4.OnBarcodeDLL dosyalarını depodan silin
4. dotnet add package IronBarcode çalıştırın
5. Her dosyada using OnBarcode.Barcode yerine using IronBarCode koyun
6. Her dosyada using OnBarcode.Barcode.Reader yerine using IronBarCode koyun
7. Her ikiOnBarcodeDLL <Reference> girdilerini kaldırın (üretici ve okuyucu) — değiştirilecek herhangi bir çalışma zamanı lisans araması yok
8. Uygulama başlatıldığında bir kere IronBarCode.License.LicenseKey = "YOUR-KEY" ekleyin
9. Her new Linear() veya new QRCode() + özellik atama bloğunu BarcodeWriter.CreateBarcode(data, encoding)'e dönüştürün
10. Her dosyada barcode.drawBarcode("file.png")'i .SaveAsPng("file.png") ile değiştirin (veya uygun format yöntemi)
11. Her dosyada new BarcodeScanner() { BarcodeTypes = [...] } + .Scan(path) yerine BarcodeReader.Read(path) ile değiştirin
12. Sonuç işleme yöntemlerini string[] indekslemeden result.Value ve result.Format'ye BarcodeResults üzerinde güncelleyin
13. Herhangi birOnBarcodePDF kısıtlaması çalışmasını çözmek için kullanılan PDF'den resim oluşturma kodunu kaldırın
14. Çok aşamalı PDF işleme + tarama döngülerini tek bir BarcodeReader.Read("file.pdf") çağrısıyla değiştirin

Geçiş Sonrası Testler

• Projede kullanılan tüm barkod türlerini (Kod 128, QR, EAN, Data Matrix, PDF417) doğrulayın ve taranabilir bir çıktı almasını sağlayın
• Oluşturulan barkodları fiziksel bir tarayıcı veya mobil cihazla tarayarak okunabilirliğini onaylayın
• Bilinen test resimleri için barkod okumanın doğru değerleri döndürdüğünü doğrulayın
• Çok sayfalı test belgeleri için PDF okumanın doğru değerleri ve doğru sayfa numaralarını döndürdüğünü doğrulayın
• Uygulamayı herhangi bir CI ortamında çalıştırarak lisans anahtar yapılandırmasının boru hattında doğru çalıştığını doğrulayın
• Geçiş tamamlandıktan sonra .cs, .csproj veya yapılandırma dosyalarında OnBarcode dizesinin kalmadığını kontrol edin

IronBarcode'a Geçmenin Temel Faydaları

Konsolide Paket ve Lisans: Göçten sonra, bir NuGet paketi ve bir lisans anahtarı tüm barkod işlemlerini kapsar. Satın alınacak ayrı ürünler yoktur, izlenecek bağımsız sürüm programları veya başlangıçta sürdürülecek çift lisans yapısı yoktur. İki ürünlü düzenlemenin karmaşıklığı, tek bir bağımlılıkla değiştirilmiştir.

Şeffaf Satın Alma: IronBarcode, ürün web sitesinde fiyatlarla yayımlanmış süresiz lisans seviyeleri sunar. Bir organizasyon, toplam maliyeti belirleyebilir, bir satın alma siparişi verebilir ve bir satış görüşmesi yapmadan satın alma işlemini tamamlayabilir. IronBarcode lisanslama sayfası tüm seviyeler için fiyatlandırma ve Docker ve bulut ortamları için anahtar yapılandırma detaylarını içerir.

Yerel PDF Desteği: Barkod gömülü PDF'leri işlemek için ayrı bir PDF oluşturma kütüphanesi gerektiren projeler, bu bağımlılığı tamamen ortadan kaldırabilir. Tek bir BarcodeReader.Read çağrısı, bir PDF belgesinin tüm sayfalarını herhangi bir işleme adımı olmadan işler ve her sonuç, çekildiği sayfa numarasını içerir.

Daha Zengin Okuma Sonuçları: BarcodeResults dönüş türü, kod çözülmüş değeri, algılanan barkod formatını, kaynak görüntü içindeki sınırlama kutusu koordinatlarını ve PDF okumaları için sayfa numarasını sağlar. Daha önce düz bir string[] ile çalışan uygulamalar, artık format bilgisini yüzeye çıkarabilir, açıklama iş akışlarını destekleyebilir veya ek işlem olmadan güven temelli filtreleme uygulayabilir.

Azaltılmış API Yüzeyi: Statik fabrika modeli, özellik-atama modelinin yerini alır. Ortak üretim işlemleri daha az kod satırı gerektirir ve okuma işlemleri, örnek oluşturma veya format ön yapılandırması gerektirmez. Toplu işlemler, incelemesi ve zaman içinde sürdürülmesi daha kolay olan, öğe başına daha küçük bir kod harcaması ile fayda sağlar.