IronBarcode Kullanarak Çizgikodu .NET Bileşen Eğitimi

Barkod .NET Bileşeni Nedir?

Barkod .NET bileseni, temiz bir API aracılığıyla barkod üretimi ve okuma yetenekleri sağlayan bir NuGet paketi olarak paketlenmiş bir yazılım kütüphanesidir. Manuel toplam kontrol hesaplamaları ve karmaşık biçimlendirme kuralları gerektiren barkod yazı tiplerinin aksine, özel bir bileşen tüm kodlama mantığını içsel olarak işler.

IronBarcode kutuphanesi iki ana giris noktası açar:

• BarcodeWriter -- metin veya sayısal verilerden barkod görüntüleri, PDF'ler ve HTML oluşturur
• BarcodeReader -- barkod değerlerini çıkarmak için görüntüleri, PDF'leri ve çok kareli TIFF'leri tarar

Bu çift yönlü tasarım, etiketlere barkodları basmanız ve dokümanlardan onları geriye taramanız anlamına gelir, bu da envanter yönetimi, belge takibi, Crystal Reports entegrasyonu ve veri otomasyon iş akışları için gereklidir.

Desteklenen sembolojiler şunları içerir:

• 1D lineer: Code 128, Code 39, Code 93, ITF-14, EAN-13, EAN-8, UPC-A, UPC-E
• 2D matris: QR Kod, Data Matrix, PDF417, Aztek
• GS1 varyantları: GS1-128, GS1 DataBar

Uretim sistemleri tipik olarak Code 128'i ürün takibi icin kullanir cunku yuzeysel olarak alfanumerik verileri kodlar. Saglık uygulamaları, ilaç etiketleme icin genellikle Data Matrix'e dayanır, cunku çok küçük boyutlarda bile iyi baskı yapar. Perakende satış noktasında, EAN-13 ve UPC-A barkodları kasada taranır. Barkod işlevselliğini entegre ettiğinizde, kullanım durumunuza en uygun sembolojiyi secmek ilk kararlarinizdan biri olacaktır.

IronBarcode'u bir .NET Projesine Nasıl Kurarsınız?

IronBarcode'u yüklemek, Visual Studio'da NuGet Paket Yöneticisi veya .NET CLI kullanarak iki dakikadan kısa surer.

Paket Yonuetici Konsolu (Visual Studio):

Install-Package BarCode

Install-Package BarCode

.NET CLI:

dotnet add package BarCode

dotnet add package BarCode

Paketi yukledikten sonra, barkod islevselligi kullanan herhangi bir dosyanin ustune namespace'i ekleyin:

using IronBarCode;

using IronBarCode;

Imports IronBarCode

IronBarCode.NET Framework 4.6.2 ve uzerini, .NET Core 3.1 ve uzerini ve .NET 5 ile .NET 10 arasında hedefler. Windows, Linux ve macOS'ta çalışır, böylece aynı kod platforma özgü konfigürasyonsuz, bulut barındırılan konteynerlerde, kurum içi sunucularda ve geliştirici iş istasyonlarında çalısır.

ASP.NET Core uygulamaları icin arabulucu kaydetmeye gerek yoktur. API çağrısını doğrudan denetleyici, arka plan hizmetleri veya Razor Pages'den yapabilirsiniz. Windows Forms ve WPF uygulamaları aynı şekilde adlandırma alanı ekleyerek metod çağrıları ile erişim sağlar.

IronBarcode tek başına calisabileceği gibi NuGet paketi uzerine kurulum, proxy ayarlarını ve çevrimdışı besleme konfigürasyonunu da içeren detaylı kurulum adımları, IronBarcode başlangic kılavuzunda mevcuttur.

Bir C#'de Barkod Imgesi Nasıl Oluşturursunuz?

IronBarcode ile barkod uretmek üç adım gerektirir: kodlamayi sec, degeri ayarla ve cikışı kaydet. Asagıdaki örnek bir Code 128 barkodu oluşturur ve hem PNG görüntüsu hem de PDF dokümanı olarak kaydeder:

using IronBarCode;

// Create a Code 128 barcode encoding a product identifier
var barcode = BarcodeWriter.CreateBarcode("PRD-12345-2024", BarcodeEncoding.Code128);

// Set the output dimensions in pixels
barcode.ResizeTo(400, 100);

// Add human-readable text beneath the bars
barcode.AddBarcodeValueTextBelowBarcode();

// Export to PNG for screen display and label printing
barcode.SaveAsImage("product-barcode.png");

// Export to PDF for document embedding
barcode.SaveAsPdf("product-barcode.pdf");

using IronBarCode;

// Create a Code 128 barcode encoding a product identifier
var barcode = BarcodeWriter.CreateBarcode("PRD-12345-2024", BarcodeEncoding.Code128);

// Set the output dimensions in pixels
barcode.ResizeTo(400, 100);

// Add human-readable text beneath the bars
barcode.AddBarcodeValueTextBelowBarcode();

// Export to PNG for screen display and label printing
barcode.SaveAsImage("product-barcode.png");

// Export to PDF for document embedding
barcode.SaveAsPdf("product-barcode.pdf");

Imports IronBarCode

' Create a Code 128 barcode encoding a product identifier
Dim barcode = BarcodeWriter.CreateBarcode("PRD-12345-2024", BarcodeEncoding.Code128)

' Set the output dimensions in pixels
barcode.ResizeTo(400, 100)

' Add human-readable text beneath the bars
barcode.AddBarcodeValueTextBelowBarcode()

' Export to PNG for screen display and label printing
barcode.SaveAsImage("product-barcode.png")

' Export to PDF for document embedding
barcode.SaveAsPdf("product-barcode.pdf")

ResizeTo() yöntemi, piksel boyutlarını kesin olarak ayarlar, bu da belirli bir DPI'da etiket basarken önemlidir. AddBarcodeValueTextBelowBarcode() çağrısı, çubukların altına insan tarafından okunabilir metin ekleyerek, depo ve perakende ortamlarında manuel doğrulamayı kolaylaştırır.

using IronBarCode;

// Generate a QR code from a URL with 500px dimensions
var qrCode = QRCodeWriter.CreateQrCode("https://example.com/product/12345", 500);

// Save the QR code to a PNG file
qrCode.SaveAsImage("product-qr.png");

using IronBarCode;

// Generate a QR code from a URL with 500px dimensions
var qrCode = QRCodeWriter.CreateQrCode("https://example.com/product/12345", 500);

// Save the QR code to a PNG file
qrCode.SaveAsImage("product-qr.png");

Imports IronBarCode

' Generate a QR code from a URL with 500px dimensions
Dim qrCode = QRCodeWriter.CreateQrCode("https://example.com/product/12345", 500)

' Save the QR code to a PNG file
qrCode.SaveAsImage("product-qr.png")

Barkodlar Resimlerden Nasıl Okunur?

Bir resimden barkod okumak, onları yazmak kadar doğrudandır. BarcodeReader.Read() yöntemi bir dosya yolu, Stream, Bitmap veya IronSoftware.Drawing.AnyBitmap kabul eder ve bir BarcodeResults koleksiyonu döndürür:

using IronBarCode;

// Read all barcodes from a scanned document image
BarcodeResults results = BarcodeReader.Read("scanned-document.png");

// Iterate over every detected barcode
foreach (BarcodeResult result in results)
{
    string value = result.Value;
    BarcodeEncoding type = result.BarcodeType;
    Console.WriteLine($"Detected {type}: {value}");
}

using IronBarCode;

// Read all barcodes from a scanned document image
BarcodeResults results = BarcodeReader.Read("scanned-document.png");

// Iterate over every detected barcode
foreach (BarcodeResult result in results)
{
    string value = result.Value;
    BarcodeEncoding type = result.BarcodeType;
    Console.WriteLine($"Detected {type}: {value}");
}

Imports IronBarCode

' Read all barcodes from a scanned document image
Dim results As BarcodeResults = BarcodeReader.Read("scanned-document.png")

' Iterate over every detected barcode
For Each result As BarcodeResult In results
    Dim value As String = result.Value
    Dim type As BarcodeEncoding = result.BarcodeType
    Console.WriteLine($"Detected {type}: {value}")
Next

Okuyucu, döndürme, eğrilik, gürültü, düşük kontrast ve perspektif bozulmasını düzeltmek için resimleri otomatik olarak önceden işler. Bu, ham tarayıcı çıktısını doğrudan kendiniz önceden işlemeden geçebileceğiniz anlamına gelir.

using IronBarCode;

var options = new BarcodeReaderOptions
{
    // Balance accuracy and processing time
    Speed = ReadingSpeed.Balanced,

    // Detect multiple barcodes in one pass
    ExpectMultipleBarcodes = true,

    // Limit the search to 1D formats for faster processing
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
};

// Read from a multi-page PDF warehouse inventory report
var results = BarcodeReader.Read("warehouse-inventory.pdf", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    // Balance accuracy and processing time
    Speed = ReadingSpeed.Balanced,

    // Detect multiple barcodes in one pass
    ExpectMultipleBarcodes = true,

    // Limit the search to 1D formats for faster processing
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
};

// Read from a multi-page PDF warehouse inventory report
var results = BarcodeReader.Read("warehouse-inventory.pdf", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read from a multi-page PDF warehouse inventory report
Dim results = BarcodeReader.Read("warehouse-inventory.pdf", options)

Barkod Görünümü Nasıl Özelleştirilir?

IronBarcode, kaydetmeden önce oluşturulan bir barkodun her görsel yönünü kontrol etmenizi sağlar. Renkleri, yazı tiplerini, kenar boşluklarını ve açıklama metnini programatik olarak ayarlayabilirsiniz. Bu, markalı etiketler veya etiket düzeninin kesin şartnameler izlediği düzenlenmiş sektörler için barkod oluştururken faydalıdır.

API, akıcı bir desen izler: barkodu oluşturun, stil metodlarını çağırın, sonra kaydedin. Tüm stil özellikleri, çıktıyı hemen etkiler ve ayrı bir render adımına gerek yoktur. Mevcut özelliklerin tam listesi için stil ve açıklama örneklerine bakın.

PDF Belgelerinde Barkodlar Nasıl İşlenir?

IronBarcode, PDF dosyalarına gömülü barkodları, resim dosyalarını okuduğu gibi okur. Bir PDF yolunu BarcodeReader.Read() ile iletin ve kütüphane her sayfadan otomatik olarak barkodları çıkarır. Fatura PDF'lerinin GS1-128 barkodları içerdiği hesaplar departmanı iş akışları ve gönderi bildirgelerinin PDF eki olarak dağıtıldığı lojistik sistemleri için değerlidir.

IronBarcode'yi bir IronPDF ile birlikte belge oluşturma için kullanarak barkodları doğrudan PDF sayfalarına da yazabilirsiniz. Yaygın bir model, insan tarafından okunabilir adres bloğu ve takip numarası için taranabilir bir Code 128 barkodu içeren bir gönderi etiketi PDF'si oluşturmaktır.

PDF barkod iş akışları hakkında daha fazla bilgi için, IronBarcode öğretici bölümü fatura işleme, toplu etiket yazdırma ve belge arşivlemeyi kapsayan uçtan uca örnekler sağlar.

Barkodlar ASP.NET Core API'lerine Nasıl Entegre Edilir?

Bir ASP.NET Core denetleyici uç noktasından barkod resmi döndürmek, dinamik etiketler gösteren web portalları için yaygın bir gereksinimdir. IronBarcode'un base64 çıktısı bunu doğrudan yapar:

using IronBarCode;

// In an ASP.NET Core controller action
public IActionResult GetBarcodeImage(string productId)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128);
    barcode.ResizeTo(400, 100);
    barcode.AddBarcodeValueTextBelowBarcode();

    // Return the barcode as a PNG image response
    byte[] imageBytes = barcode.ToJpegBinaryData();
    return File(imageBytes, "image/jpeg");
}

using IronBarCode;

// In an ASP.NET Core controller action
public IActionResult GetBarcodeImage(string productId)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128);
    barcode.ResizeTo(400, 100);
    barcode.AddBarcodeValueTextBelowBarcode();

    // Return the barcode as a PNG image response
    byte[] imageBytes = barcode.ToJpegBinaryData();
    return File(imageBytes, "image/jpeg");
}

Imports IronBarCode

' In an ASP.NET Core controller action
Public Function GetBarcodeImage(productId As String) As IActionResult
    Dim barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128)
    barcode.ResizeTo(400, 100)
    barcode.AddBarcodeValueTextBelowBarcode()

    ' Return the barcode as a PNG image response
    Dim imageBytes As Byte() = barcode.ToJpegBinaryData()
    Return File(imageBytes, "image/jpeg")
End Function

Bu yaklaşım, herhangi bir ön uç çerçevesiyle çalışır. Tarayıcı bir standart görüntü yanıtı alır ve bunu bir <img> etiketinde görüntüler. Yüksek trafikli uç noktalar için, barkodları bir kez oluşturun ve byte dizisini önbelleğe alın, çünkü aynı ürün kimliği her zaman aynı barkod görüntüsünü üretir.

IronBarcode API referansı, yüksek çözünürlüklü barkodlar için büyük byte dizileri ayırmaktan kaçınan akış çıktısı dahil tüm mevcut yöntemleri belgelemektedir.

IronBarcode Barkod Doğrulaması ve Hata Düzeltmesini Nasıl Yapıyor?

Barkod standartları, sıkı kodlama kuralları ve kontrol kodu gereksinimlerini tanımlar. Code 128, ağırlıklı bir mod 103 kontrol toplamı kullanır. EAN-13, mod 10 kullanır. QR kodları, barkodun %30'u örtbas edilmiş veya hasar görmüş olsa bile kısmi veri kurtarmayı sağlayan Reed-Solomon hata düzeltmesi içerir.

IronBarcode, bu kuralları otomatik olarak uygular. BarcodeWriter.CreateBarcode() çağrıldığında, kütüphane verilerin sembolojinin karakter seti ve uzunluk kısıtlamalarına uyduğunu doğrular, ardından kodunuzdan başka bir adım gerekmeden doğru kontrol toplamını hesaplar ve ekler. Bu, tarayıcıların reddedeceği geçersiz barkodların üretilmesini önler.

Okuma tarafında ise, kütüphane, hatalı bölümlerde hata düzeltmesi yapar, bu da demektir ki, kısmen yırtılmış, bulanık veya düşük çözünürlükte basılmış bir barkoddan doğru değeri sıklıkla kurtarabilir. Bu davranış, perakende ve lojistik GS1 barkod standartları uyumluluğu için özellikle önemlidir.

Barkod hata düzeltmesinin spesifikasyon düzeyinde nasıl çalıştığı hakkında daha fazla bilgi için, ISO/IEC barkod standartları belgeleri yetkili teknik referansı sağlar.

Yaygın Barkod Entegrasyon Senaryoları Nelerdir?

Her senaryo farklı konfigürasyon seçimlerinden yararlanır. IronBarcode örnek galerisi, yukarıdaki tüm senaryolar için çalıştırılabilir kod sağlar.

Sıradaki Adımlarınız Neler?

Barkod entegrasyonu, aksi takdirde haftalar sürecek özel geliştirme çabasını birkaç saatlik bir konfigürasyon işlemine dönüştürür. IronBarcode, kodlama kuralları, kontrol toplamları, görüntü ön işleme ve hata düzeltmesini halleder, böylece ekibiniz barkod iş akışlarını çevreleyen iş mantığına odaklanabilir ve kendi başına barkod mekaniklerine odaklanmaz.

İleriye gitmek için:

1. Paket kurulumunu yapın: dotnet add package BarCode veya Install-Package BarCode Paket Yöneticisi Konsolunda
2. Hızlı başlatmayı deneyin: barkod hızlı başlatma örneği, 20 satırdan az kodla oluşturmayı ve okumayı adım adım gösterir
3. Simgemleri keşfedin: desteklenen barkod türleri referansı tüm kodlamak formatlarıyla kullanım kılavuzu sağlar
4. Fiyatları gözden geçirin: IronBarcode lisanslama seçenekleri, tek geliştirici, ekip ve OEM yeniden dağıtımı kullanım durumlarını kapsar
5. Ücretsiz bir deneme başlatın: Kendi uygulamanızda tam özellik setini değerlendirmek için 30 günlük ücretsiz deneme lisansı indirin

Kurumsal lisanslama, yüksek hacimli dağıtımlar veya teknik entegrasyon zorlukları hakkında sorularınız için IronBarcode destek ekibi yardımcı olmak için hazırdır.

Barkod standartları ve spesifikasyonlarına ilişkin dış referanslar:

• GS1 barkod standartları - perakende ve lojistik barkod spesifikasyonlarının küresel otoritesi
• ISO/IEC barkod standartları komitesi - 1D ve 2D barkod simgeleri için uluslararası standartlar
• C# için Stack Overflow'da barkod S&A - .NET'de barkod uygulaması üzerine topluluk tartışmaları