Sadece Üretim Kontrol Mimarisi

SfBarcode, özellik tabanlı bir API'ye sahip bir WinForms kontrolüdür: Text, Symbology, BarHeight, NarrowBarWidth, ShowText. Bir form üzerine barkod render etmek, bir WinForms tasarımcısında beklendiği gibi çalışır. Bir barkod dosyasını programatik olarak oluşturmak, doğru boyutlarla bir Bitmap önceden ayırmayı içeren DrawToBitmap yöntemini gerektirir:

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

// Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "12345678";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;

barcode.Width = 400;
barcode.Height = 150;
using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("barcode.png", ImageFormat.Png);

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

// Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "12345678";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;

barcode.Width = 400;
barcode.Height = 150;
using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("barcode.png", ImageFormat.Png);

Imports Syncfusion.Windows.Forms.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

' Version-specific key required — changes with every major Essential Studio release
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

Dim barcode As New SfBarcode()
barcode.Text = "12345678"
barcode.Symbology = BarcodeSymbolType.Code128A
barcode.BarHeight = 100
barcode.NarrowBarWidth = 1
barcode.ShowText = True

barcode.Width = 400
barcode.Height = 150
Using bitmap As New Bitmap(barcode.Width, barcode.Height)
    barcode.DrawToBitmap(bitmap, barcode.ClientRectangle)
    bitmap.Save("barcode.png", ImageFormat.Png)
End Using

Bu model, çağrıda bulunulan her projede Windows Forms çalışma zamanını yüklemeyi ima eder, buna konsol uygulamaları, ASP.NET Core hizmetleri ve Azure İşlevleri dahildir. Blazor varyantı SfBarcodeGenerator bir Razor bileşenidir ve sunucu tarafında dosya çıktı yolu yoktur.

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

Syncfusion Yaklaşımı

SfBarcode bir WinForms kontrolüdür. Görevi, bir formun görsel düzeninin bir parçası olarak bir barkodu render etmektir. Ondan bir dosya üretmek için geliştirici, istenen çıkış boyutuna uygun bir Bitmap önceden ayırmalı, DrawToBitmap çağırmalı ve ardından Bitmap.Save çağırmalıdır. Her adım Windows Forms çalışma zamanı gerektirir.

Blazor için SfBarcodeGenerator, Syncfusion Blazor JavaScript katmanı aracılığıyla tarayıcıda görüntülenen bir Razor bileşenidir. SfBarcodeGenerator üzerinde sunucu tarafı API yoktur. Blazor uygulamasından indirilebilir bir barkod üretmek, bir sunucu API çağrısından ziyade JavaScript interop ve tarayıcı indirme tetikleyicileri gerektirir.

MAUI uygulamaları için SfBarcodeGenerator, MAUI yerleşim sistemi içinde barkodları görüntüler. Bir dosya olarak iletim veya yazdırma için bir barkod oluşturmak, kontrol tarafından sağlanmayan ek aracılık adımları gerektirir.

IronBarcode Yaklaşımı

IronBarcode, doğrudan dosya çıktısı üreten statik, zincirlenebilir bir API kullanır. Aynı çağrı deseni, herhangi bir .NET uygulama modelinde değişiklik olmadan çalışır:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

Imports IronBarCode

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

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPng("barcode.png")

1D barkod üretim belgeleri, desteklenen tüm sembolojileri ve çıktı seçeneklerini kapsar. Kontrol oluşturma yok, önceden tahsis edilmiş Bitmap yok ve Windows Forms çalışma zamanı bağımlılığı yok.

Syncfusion Yaklaşımı

SfBarcode ve SfBarcodeGenerator, tasarım gereği okuma yeteneğine sahip değildir. Syncfusion ekosistemi bu açığı Barcode Reader OPX ile, kendi lisansı ve satın alma yolu olan ayrı bir ticari ürünle kapatır.

Barcode Reader OPX, içsel olarak ZXing.Net kullanır. ZXing.Net, Apache 2.0 lisansı altında yayımlanan açık kaynaklı bir barkod okuma kütüphanesidir. Apache 2.0, kısıtlamasız ticari kullanımına izin veren bir izin verici lisanstır. Herhangi bir geliştirici, ZXing.Net'i doğrudan yükleyebilir:

dotnet add package ZXing.Net

dotnet add package ZXing.Net

Barkod Okuyucu OPX, Syncfusion barkod kontrollerinden ayrı bir lisansla sağlanır. Hem üretim hem de okuma kaplayan tam bir Syncfusion barkod iş akışı, bu nedenle iki Syncfusion ürünü, iki lisans anlaşması ve iki farklı API yüzeyi gerektirir — okuma ürünü, ücretsiz olarak sunulan açık kaynaklı dekoder üzerine katmanlanmıştır.

IronBarcode Yaklaşımı

Barkod okuma, üretim ile aynı NuGet paketi içindedir. İkinci bir ürün veya lisans gerekmez:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

Barkod okuma belgeleri, çoklu barkod tespiti, güven puanlaması, bayt dizilerinden okuma ve hız-karşılığı-doğruluk ayarlamalarını kapsar. PDF belgelerinden okumak da ayrıdır, ek bir PDF kütüphanesi gerektirmez.

Syncfusion Yaklaşımı

Syncfusion Community License, ücretsiz erişim sağlar ancak dört eşzamanlı uygunluk koşulu uygular: yıllık brüt gelir $1,000,000'ın altında, beş veya daha az geliştirici, on veya daha az çalışan ve toplam dış sermaye $3,000,000'ın altında. Bu dört koşul sürekli olarak tutmalıdır. Vergiyle finanse edilen hükümet organizasyonları hak kazanamaz. Herhangi bir şart aşıldığında ticari lisans yükümlülüğü oluşturur, ve Community License'dan ticari bir lisansa geçiş, Syncfusion satış tarafından teklif üzerinde verilen bir değere sahip yıllık geliştirici başına Essential Studio aboneliğine dönüşür.

Uygunluğun ötesinde, Syncfusion lisans anahtarları sürüm-spesifiktir. Essential Studio 24.x için çıkarılan bir anahtar, 25.x'e yükseltildikten sonra geçerli olmaz. Her büyük NuGet sürüm güncellemesi, hesap portalından yeni bir anahtar alma, ortam sırlarını güncelleme ve üretim çıktılarında deneme su işaretlerinin görünmesini önlemek için yeniden dağıtımı gerektirir.

Platform kaydı daha fazla adım ekler. Bir Blazor uygulaması, üç ayrı yapılandırma girişi gerektirir:

// Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

// Step 2: Service registration in Program.cs
builder.Services.AddSyncfusionBlazor();

// Step 3: Namespace imports in _Imports.razor
// @using Syncfusion.Blazor
// @using Syncfusion.Blazor.BarcodeGenerator

// Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

// Step 2: Service registration in Program.cs
builder.Services.AddSyncfusionBlazor();

// Step 3: Namespace imports in _Imports.razor
// @using Syncfusion.Blazor
// @using Syncfusion.Blazor.BarcodeGenerator

' Step 1: License registration
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

' Step 2: Service registration in Program.vb
builder.Services.AddSyncfusionBlazor()

' Step 3: Namespace imports in _Imports.razor
' @Imports Syncfusion.Blazor
' @Imports Syncfusion.Blazor.BarcodeGenerator

MAUI uygulamaları dördüncü bir adım gerektirir: builder.ConfigureSyncfusionCore().

IronBarcode Yaklaşımı

IronBarcode lisans aktivasyonu, tüm platformlarda ve uygulama modellerinde aynı olan tek bir atama işlemidir:

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

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

Imports IronBarCode

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

IronBarcode lisans sayfası, süresiz lisans modelini açıklar. Lisans anahtarı kurulum rehberi, CI/CD ve Docker dağıtımları için ortam değişkeni desenlerini kapsar. Anahtar, büyük bir sürüm içindeki küçük ve yama sürümler arasında değişmez ve platforma özgü hizmet kaydı gerekmez.

Syncfusion Yaklaşımı

Syncfusion barkod kontrolleri, PDF çıktısı üretemez. Syncfusion araçlarını kullanarak bir barkodu PDF belgesine yerleştirmek, barkod kontrol paketini Syncfusion.Pdf ile birleştirmeyi, barkodu DrawToBitmap aracılığıyla bir Bitmap olarak üretmeyi ve ardından bu bitmap'i PDF belge nesne modeli içinde bir görüntü öğesi olarak eklemeyi gerektirir. Bu iş akışı, iki ayrı Syncfusion ürünü, iki NuGet paketi ve çok adımlı bir renderleme hattı içerir.

Mevcut PDF belgelerinden barkod okuma, ne barkod kontrolü ne de Barcode Reader OPX tarafından desteklenmez.

IronBarcode Yaklaşımı

PDF, IronBarcode'da birinci sınıf bir çıktı formatıdır. İkinci bir kütüphane gerekmiyor:

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("barcode.pdf");

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("barcode.pdf");

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPdf("barcode.pdf")

Kütüphane ayrıca barkodları doğrudan PDF belgelerinden okur:

var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

Dim pdfResults = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Barkod PDF oluşum kılavuzu, çok sayfalı çıktılar ve diğer PDF içeriğiyle birlikte barkod yerleştirme işlemlerini kapsar.

Barkod Okuma Gereklilikleri

Tamamen WinForms veya Blazor içinde çalışan bir ekip, görüntüleme amacıyla önce SfBarcode veya SfBarcodeGenerator ile başlayabilir ve daha sonra gelen görüntülerden, e-posta eklerinden veya kamera yakalamalarından barkod tarama gereksinimi alabilir. O noktada, Syncfusion kontrol yüzeyi ileriye giden bir yol sağlamaz. Syncfusion belgeleri, ekipleri barcode Reader OPX'e yönlendirir, bu da Apache 2.0 lisansı altında ücretsiz olarak sunulan bir kütüphane olan ZXing.Net'i saran ayrı bir ticari satın almadır. Bu noktaya ulaşan ekipler, genellikle ikinci bir ticari ürün eklenmesini mi yoksa üretim ve okumanın tek bir kütüphanede birleştirilmesini mi değerlendirecektir.

Sunucu Tarafı ve Arka Plan Üretimi

WinForms veya WPF masaüstü araçları olarak başlayan uygulamalar, bazen bir web API katmanı, arka plan işleme hizmeti veya bir bulut işlemi içerecek şekilde evrim geçirir. Bu, barkod dosyaları oluşturmayı gerektirir. SfBarcode, ASP.NET Core hizmetlerine, Azure İşlevlerine veya Linux Docker konteynerlerine temiz bir şekilde çevrilemeyen bir Windows Forms çalışma zamanı bağımlılığı taşır. DrawToBitmap kalıbı, başsız bir ortamda var olmayabilecek bir WinForms görüntüleme yüzeyi gerektirir. Bu sınıra ulaşan ekipler genellikle UI rendereleme yığınından ayrılmış bir nesil modeline sahip bir kütüphaneye ihtiyaç duyar.

Community License Uygunluk Değişiklikleri

Syncfusion'un Community License, hızlı büyüyen ekipler için çekici bir seçenektir. Gelir, kadro sayısı, çalışan sayısı ve toplanan sermaye şeklindeki dört eşzamanlı uygunluk koşulu, ani gelebilecek bir lisanslama uçurumunu oluşturur. A Serisi bir fonlama turu, genellikle kapanış günü $3,000,000'luk sermaye eşiğini aşarak, geliştirici sayısı veya gelirden bağımsız olarak bir ticari lisans yükümlülüğü tetikler. Community License etrafında üretim iş akışları oluşturan ekipler, geçişin maliyeti ve zamanlamasını değerlendirmek zorundadırlar, özellikle de ticari lisansın yalnızca barkod bileşeni değil, Essential Studio paketinin tamamını kapsadığı hallerde.

Sürüm-Specifik Konfigürasyon Yükünü Azaltma

CI/CD boru hatlarında Syncfusion uygulamalarını sürdüren işletim ekipleri, NuGet sürüm yükseltmeleriyle bağlı bir tekrar eden görev olarak lisans anahtarı dönüşümü ile karşılaşır. Essential Studio 24.x için geçerli bir anahtar, 25.x'e yükseltildikten sonra çalışmayı durdurur, bu da her dağıtım ortamında sırları güncellemeyi ve üretim çıktılarında deneme su işaretlerinin görünmediğinden emin olmayı gerektirir. Sık sürüm kadansları veya birden çok dağıtım hedefi olan takımlar, bu dönüşüm yükünü sağlanan yararına orantısız bulurlar, özellikle temel kullanım durumunun tam bir UI bileşen paketi tüketmektense bir barkod görüntüsü üretmek olduğu durumlarda.

SyncfusionLicenseProvider Kaydı Kaldırma

Syncfusion lisans çağrısı — SyncfusionLicenseProvider.RegisterLicense("KEY") — genellikle Program.cs, App.xaml.cs veya bir uygulama başlangıç metodunda görünür. Başlangıç dizisindeki aynı noktada IronBarCode.License.LicenseKey = "KEY" ile kaldırılmalı ve değiştirilmelidir. İlgili hizmet kayıt çağrıları (AddSyncfusionBlazor, ConfigureSyncfusionCore) ve _Imports.razor içindeki namespace içe aktarmaları proje içinde başka Syncfusion bileşenleri kalmamışsa da kaldırılmalıdır.

SfBarcode'dan BarcodeWriter'a Desen

SfBarcode iş akışı, kontrol oluşturma, özellik atama, boyut belirtimi ve DrawToBitmap oluşturmayı içerir.IronBarcode eşdeğeri tek zincirli bir çağrıdır: BarcodeWriter.CreateBarcode(value, encoding).ResizeTo(w, h).SaveAsPng(path). BarcodeSymbolType enum değerleri, doğrudan BarcodeEncoding değerlerine eşlenir — Code128A, Code128 olarak eşlenir, QRBarcode, QRCodeWriter.CreateQrCode olarak eşlenir.

Blazor Bileşeninden API Uç Noktasına Desen

SfBarcodeGenerator bir Razor bileşenidir; Onu IronBarcode ile değiştirmek, satır-başı bir ikame yerine yapısal bir değişikliktir. Blazor için IronBarcode modeli, bir Razor bileşeninden standart <img src="..."> etiketi aracılığıyla atıfta bulunulan ve bayt olarak bir barkod görüntüsü döndüren bir minimal API uç noktasıdır. Bu yaklaşım, sunucu tarafında bağımsız olarak test edilebilir ve yeniden kullanılabilir bir uç nokta oluşturur, Syncfusion Blazor JavaScript katmanına bağlı tarayıcıda render bileşeni yerine.