IRONSOFTWAREHOME
IRONBARCODE KULLANARAK

ASP.NET Core Web Uygulamalarında Barkodlar Üretin

Curtis Chau
Curtis Chau
Updated: 27 Şubat 2026

Bir ASP.NET web uygulamasına barkod üretimini entegre etmek, envanter yönetimi, ürün takibi ve belge otomasyonu için güçlü yetenekler açar. Bu öğretici, IronBarcode kullanarak bir .NET Core projesinde barkodların nasıl oluşturulacağını gösterir -- 30'dan fazla formatı destekleyen bir barkod kütüphanesi, QR Kod, Data Matrix, Code 128 ve UPC A dahil.

Aşağıdaki hızlı örnek, bir MVC denetleyici işlemi içindeki bir Code 128 barkodunun nasıl oluşturulacağını ve PNG görüntüsü olarak döndürüleceğini gösterir:

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

public IActionResult GenerateBarcode(string data)
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
    barcode.ResizeTo(400, 120);
    barcode.AddBarcodeValueTextBelowBarcode();
    byte[] barcodeBytes = barcode.ToPngBinaryData();
    return File(barcodeBytes, "image/png");
}

Ücretsiz denemenizi başlatın ve aşağıda verilen tamamlanmış eğitim kod örnekleriyle ilerleyin.

.NET Core Projesine Barkod Kütüphanesi Nasıl Yüklenir?

ASP.NET Core web uygulamasına barkod üretme yeteneklerini eklemek, IronBarcode NuGet paketini yüklemeyi gerektirir. Visual Studio'yu açın ve Paket Yöneticisi Konsolu'nu kullanarak bağımlılıkları yükleyin:

PM > Install-Package BarCode

Paket, .NET Core 6, 7, 8, 10 ve daha yeni sürümlerle uyumludur, ayrıca .NET Framework 4.6.2+ ile uyumludur. Kütüphane, tüm bağımlılıkları otomatik olarak yönetir, ek barkod yazı tipleri veya sistem yapılandırması gerektirmez. Yüklendikten sonra, denetleyici veya hizmet dosyasına ad alanı referansı ekleyin:

using IronBarCode;

Desteklenen .NET Sürümleri ve Platformlar Nelerdir?

IronBarcode, tüm modern .NET çalışma zamanlarını hedefler:

  • .NET 10, 9, 8, 7, 6 - tamamen desteklenen LTS ve STS sürümleri
  • .NET Framework 4.6.2+ - eski uygulama desteği
  • Dağıtım hedefleri - Windows, Linux, macOS, Docker, Azure, AWS
  • Mobil hedefler - .NET MAUI aracılığıyla Android ve iOS

Harici GD kütüphaneleri, yerli kodekler veya barkod yazı tipi kurulumları gerekli değildir. Kütüphane tamamen kendi kendine yetkindir ve tüm kodlama mantığını dahili olarak çözer.

Ad Alanını Denetleyiciye Nasıl Ekleriz?

NuGet paketini kurduktan sonra, barkod oluşturmanın gerektiği her controller, service veya Razor Page modelinin üst kısmında IronBarCode isim alanına referans verin:

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

Bu tek using yönergesi, barkod oluşturma ve okuma için hem BarcodeWriter, QRCodeWriter, BarcodeReader hem de tüm destekleyici türlere erişim sağlar.

ASP.NET Core Web Uygulamasında Barkodlar Nasıl Üretilir?

MVC controller'da barkod oluşturmak, IronBarcode'dan BarcodeWriter sınıfını içerir. Aşağıdaki örnek, bir kullanıcının sağladığı URL veya metne dayalı olarak bir Code 128 barkodu oluşturan tam bir denetleyici işlemini gösterir:

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

public class BarcodeController : Controller
{
    public IActionResult GenerateBarcode(string data)
    {
        // Generate barcode from input data
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
            data,
            BarcodeWriterEncoding.Code128);
        barcode.ResizeTo(400, 120);
        barcode.AddBarcodeValueTextBelowBarcode();
        // Return as image for display in browser
        byte[] barcodeBytes = barcode.ToPngBinaryData();
        return File(barcodeBytes, "image/png");
    }
}

Barkod Görüntüsü Çıktısı

ASP .NET Barkod Oluşturma: Web Uygulamanız için Bir Barkod Üretici Oluşturun: Görüntü 1 - Oluşturulan Barkod

BarcodeWriter.CreateBarcode() yöntemi, barkod verilerini ilk parametre ve kodlama formatını ikinci parametre olarak alır. Bu yaklaşım, kullanıcı girdilerine veya veritabanı değerlerine dayalı olarak barkodları dinamik olarak oluşturur.

Bir proje klasörüne barkod resimlerini kaydetmek için SaveAsImage() yöntemini kullanın:

barcode.SaveAsImage("wwwroot/images/generated-barcode.png");

Kütüphane, PNG, GIF, BMP, SVG ve JPEG dahil olmak üzere birden fazla çıktı formatını destekler. Barcodselerleri doğrudan web sayfalarına gömülmüş olarak HTML olarak dışa aktarabilirsiniz.

Barkodu Dosya İndirimi Olarak Nasıl Döndürürsünüz?

Yanıt içerisinde barkodu satır içi bir resim yerine indirilebilir bir dosya olarak döndürmek için Content-Disposition başlığını ayarlayın:

public IActionResult DownloadBarcode(string data)
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
    barcode.ResizeTo(400, 120);
    byte[] pdfBytes = barcode.ToPdfBinaryData();
    return File(pdfBytes, "application/pdf", "barcode.pdf");
}

Bu model, gönderim etiketi üretimi, ürün etiketleme iş akışları ve son kullanıcının bir barkod belgesini doğrudan kaydetmesi veya yazdırması gereken her senaryoda kullanışlıdır.

Web Uygulamaları İçin Desteklenen Barkod Türleri Nelerdir?

IronBarcode 30'dan fazla formatı destekler. En sık kullanılan türlerin nasıl oluşturulacağına dair detaylar burada:

QR Kod Oluşturma

// Create QR Code with custom size
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode(
    "https://example.com/product/12345",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("product-qr.png");

QR Kod Çıkışı

ASP .NET Barkod Oluşturma: Web Uygulamanız için Bir Barkod Üretici Oluşturun: Görüntü 2 - ASP .NET Barkod Oluşturma ile İlgili 6 Resimden 2. Resim

QR Kod üretimi, okunabilir kalırken kodun ne kadarının zarar görebileceğini belirleyen hata düzeltme seviyelerini destekler. Fiziksel aşınma beklendiği yerlerde basılı QR kod uygulamaları için Orta veya Yüksek kullanın. QR Kod özelleştirme seçenekleri hakkında daha fazla bilgi edinin.

Data Matrix ve Diğer 2D Formatları

// Create Data Matrix barcode
GeneratedBarcode dataMatrix = BarcodeWriter.CreateBarcode(
    "DMX-2024-001",
    BarcodeWriterEncoding.DataMatrix);
dataMatrix.SaveAsGif("datamatrix.gif");

Data Matrix Çıkışı

ASP .NET Barkod Oluşturma: Web Uygulamanız için Bir Barkod Üretici Oluşturun: Görüntü 3 - Oluşturulan Veri Matrisi

Data Matrix barkodları, kompakt, yüksek yoğunluklu kodlama gerektiren senaryolarda mükemmeldir. Kütüphane ayrıca PDF417, Aztec ve MaxiCode formatlarını da üretir. Bu 2D barkod türleri, doğrusal formatlardan önemli ölçüde daha fazla veri saklarken güvenilir tarama doğruluğunu korur.

Doğrusal Barkodlar (UPC, EAN, Code 39)

// Create UPC-A barcode for retail products
GeneratedBarcode upcBarcode = BarcodeWriter.CreateBarcode(
    "012345678905",
    BarcodeWriterEncoding.UPCA);
upcBarcode.SaveAsPng("upc-barcode.png");

Çıktı

ASP .NET Barkod Oluşturma: Web Uygulamanız için Bir Barkod Üretici Oluşturun: Görüntü 4 - Oluşturulan barkod

UPC A ve EAN barkodları, barkod oluşturma sürecinde kodlama hatalarını önleyen otomatik çek kontrolü içerir. Desteklenen formatların tam listesini görmek için barkod format referansına bakın.

Barkod Görüntüleri Nasıl Özelleştirilir ve Stil Edilir?

Web uygulaması için barkodları stilize etmek, renkleri, yazı tiplerini, kenar boşluklarını ayarlamayı ve açıklama eklemeyi içerir. Akıcı API, özelleştirmeyi kolaylaştırır:

GeneratedBarcode styledBarcode = BarcodeWriter.CreateBarcode(
    "STYLED-2024",
    BarcodeWriterEncoding.Code128);
// Apply styling
styledBarcode.ResizeTo(450, 150);
styledBarcode.SetMargins(20);
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:");
styledBarcode.AddBarcodeValueTextBelowBarcode();
// Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png");
styledBarcode.SaveAsPdf("styled-barcode.pdf");

Stilize Edilmiş Barkod Görüntüsü

ASP .NET Barkod Oluşturma: Web Uygulamanız için Bir Barkod Üretici Oluşturun: Görüntü 5 - Stilize edilmiş çıktı barkodu

SetMargins() yöntemi, barkodun etrafına daha iyi tarayıcı okunabilirliği için boşluk ekler. Açıklama metni için yazı tipi ayarlarını ayarlayabilir, yazı tipi ailesini ve yazı tipi boyutunu değiştirebilir ve barkod stilini geniş ölçüde özelleştirebilirsiniz. Kütüphane, harici barkod yazı tipleri gerektirmeden sistem yazı tiplerini kullanarak metni oluşturur.

Barkodu Razor Görünümüne Doğrudan Nasıl Gömülür?

ASP.NET MVC görünümleri için, dosyaları diske kaydetmeden doğrudan HTML içine gömmek için barcodesleri Base64 dizeleri olarak üretin:

public IActionResult DisplayBarcode()
{
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
        "INV-2024-0042",
        BarcodeWriterEncoding.Code128);
    string base64Image = barcode.ToDataUrl();
    ViewBag.BarcodeImage = base64Image;
    return View();
}

Görüntülenen Barkod

ASP .NET Barkod Oluşturma: Web Uygulamanız için Bir Barkod Üretici Oluşturun: Görüntü 6 - Tarayıcımızda görüntülenen barkod

Razor görünümünde, bunu bir <div> öğesi içinde görüntüleyin:

<div class="barcode-container">
    <img src="@ViewBag.BarcodeImage" alt="Generated Barcode" />
</div>
<div class="print-actions">
    <button onclick="window.print()">Print Barcode</button>
</div>
HTML

Bu yaklaşım, dosya sistemine barkod görüntüleri kaydetme gereğini ortadan kaldırarak web hizmetini durumsuz tutar. tam API referansı, tüm kullanılabilir yöntemleri ve özellikleri belgeler.

ASP.NET Core'da Barkodlar Nasıl Okunur ve Tarar?

Yüklenen resimlerden veya dosya akışlarından barkod okuma BarcodeReader sınıfı tarafından gerçekleştirilir. Bu işlem, alım iş akışları, iade işlemleri ve taranmış barkodun sunucu dışında çözülmesi gereken her senaryoda kullanışlıdır:

using IronBarCode;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

public class BarcodeScanController : Controller
{
    public IActionResult ScanBarcode(IFormFile uploadedImage)
    {
        using var stream = uploadedImage.OpenReadStream();
        var results = BarcodeReader.Read(stream);
        if (results.Count > 0)
        {
            string decodedValue = results[0].Value;
            return Ok(new { barcode = decodedValue });
        }
        return BadRequest("No barcode detected in image.");
    }
}

BarcodeReader.Read() yöntemi dosya yolları, akışlar ve System.Drawing.Bitmap nesnelerini kabul eder. Barkod formatını otomatik olarak algılar ve her biri çözülen değeri, format tipini ve görüntüdeki konumunu içeren bir BarcodeResult nesne koleksiyonu döndürür. Bir görüntüde birden fazla barkod bulunduğunda - örneğin bir depo rafı fotoğrafında - okuyucu tüm tespit edilen değerleri koleksiyonda döndürür, sadece ilkini değil.

Performans da yüksek hacimli ASP.NET uygulamaları için dikkate alınmaya değerdir. Okuyucu, ilgi alanı taramasını destekler, analizden önce görüntüyü belirli bir piksel dikdörtgenine kırpar. Barkodların görüntünün bilinen bir alanında her zaman yer aldığı senaryolarda işlem süresini önemli ölçüde azaltır.

Düşük kaliteli görüntüler için karşıtlığı ayarlamak veya algılama hassasiyetini ayarlamak gibi gelişmiş senaryolar için, barkod okuma dokümantasyonuna başvurun.

Barkodları ASP.NET'te PDF Olarak Nasıl Dışa Aktarırsınız?

Gemi etiketleri, depo etiketleri ve uyumluluk belgeleri için doğrudan PDF belgelerine gömülü barkodlar üretmek yaygın bir gereksinimdir. IronBarcode doğrudan PDF formatına kaydetmeyi destekler:

GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
    "SHIP-2024-99471",
    BarcodeWriterEncoding.Code128);
barcode.ResizeTo(500, 150);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.SaveAsPdf("shipping-label.pdf");

Çok barkodlu PDF belgeleri için - örneğin bir ürün etiketleri sayfası - her barkodu ayrı ayrı üreterek ve bir PDF kütüphanesi kullanarak birleştirin. IronPDF entegrasyon kılavuzu önceden tasarlanmış etiket düzenlerine barkod eklemek için mevcut PDF şablonlarına barkodları nasıl damgalayacağınızı açıklar.

SaveAsPdf() yöntemi ayrıca çıktı boyutlarını da alır, böylece oluşturulan PDF sayfası, etiket yazıcılarının gerektirdiği fiziksel etiket boyutuyla eşleşir.

Barkod Oluşturma Hataları ve Doğrulama Nasıl Yönetilir?

Barkod kodlama kuralları formatlarına göre değişir. Örneğin, UPC-A tam olarak 11 veya 12 basamak, EAN-13 tam olarak 12 veya 13 basamak gerektirir ve Code 128, standart boyutlarda okunabilir çıkış için 48 karakterlik pratik bir sınıra sahiptir. Geçersiz veri iletmek bir IronBarCodeEncoderException hatası oluşturur.

Kodlama hatalarını denetleyici işlemlerinde açıkça yönetin:

public IActionResult SafeGenerate(string data, string format)
{
    try
    {
        var encoding = Enum.Parse<BarcodeWriterEncoding>(format, true);
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, encoding);
        return File(barcode.ToPngBinaryData(), "image/png");
    }
    catch (IronBarCodeEncoderException ex)
    {
        return BadRequest($"Encoding error: {ex.Message}");
    }
    catch (ArgumentException ex)
    {
        return BadRequest($"Unknown format: {ex.Message}");
    }
}

Üretim kullanımı için CreateBarcode() çağrılmadan önce giriş veri uzunluğunu ve karakter setini doğrulayın. IronBarcode belgelendirmesi, her desteklenen barkod türü için format özgü kodlama kısıtlamaları sağlar.

Sonraki Adımlarınız Neler?

IronBarcode ile bir ASP.NET barkod oluşturucu oluşturmak, .NET Core web uygulamalarında barkod imgeleri oluşturmak, stillendirmek ve dışa aktarmak için güvenilir bir çözüm sunar. Kütüphane, karmaşık kodlama standartlarını otomatik olarak yönetirken, geliştirici dostu bir API ile kapsamlı özelleştirme sunar. Mobil tarama için QR kodları üretmek, endüstriyel uygulamalar için Data Matrix barkodları ya da perakende için UPC kodları oluşturmak arasındaki fark gözetmeksizin, IronBarcode ASP.NET MVC denetleyicileri ve Razor sayfaları ile doğrudan entegre olur.

Daha fazla ileri gitmek için şu kaynakları inceleyin:

Ücretsiz değerlendirme süresi boyunca tam özellik setini test edebilirsiniz. Üretim dağıtımı ve ticari kullanım için, proje gereksinimleriniz için uygun lisansı seçmek üzere lisans seçeneklerini görüntüleyin. Kütüphane bitmap ve vektör çıktıları destekler, her sürüm Windows, Linux, Android ve iOS dağıtım hedefleri arasında uyumluluğu korur.

Sorular için, .NET için alternatif barkod kütüphanelerine karşı testler veya kurumsal entegrasyon desteği için, IronBarcode destek portalını ziyaret edin.

İlk Adım:
arrow pointer
Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...
Daha Fazla Oku

İlgili Makaleler

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Ücretsiz Canlı Demo rezervasyonu yapın
Booking Badge

Dünya Çapında Milyonlarca Mühendisin Güvendiği

Iron Software müşteri logoları
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez