C#'ta Metinden Barkod Oluşturun: IronBarcode ile Tam Eğitim

IronBarcode'u .NET Projesine Nasıl Yükleriz?

IronBarcode'un yüklenmesi, Visual Studio içindeki .NET CLI veya NuGet Paket Yöneticisi kullanılarak birkaç saniye sürer.

Seçenek 1 -- .NET CLI (NET 10 için önerilen):

dotnet add package Barcode

dotnet add package Barcode

Seçenek 2 -- Visual Studio'daki NuGet Paket Yöneticisi Konsolunda:

Install-Package BarCode

Alternatif olarak, NuGet Paket Yöneticisi GUI'sinde "IronBarcode" arayın ve resmi paketi yükleyin. Kütüphane, .NET Framework 4.6.2+ ve .NET 5'ten .NET 10'a kadar olan modern .NET iş yükleriyle uyumluluğu garanti eder.

Kurulumdan sonra, çubuk kodları oluşturan veya okuyan her dosyanın en üstüne tek bir using yönergesi ekleyin:

using IronBarCode;

using IronBarCode;

Imports IronBarCode

Bu yönerge, BarcodeWriter, BarcodeReader, BarcodeEncoding ve bu kılavuzda ele alınan diğer genel türleri açığa çıkarır.

C#'da Basit Bir Barkod Nasıl Oluşturulur?

BarcodeWriter.CreateBarcode yöntemi, çubuk kodu üretimi için giriş noktasıdır. Kodlamak istediğiniz dizeyi ve bir BarcodeEncoding değerini iletin, böylece kaydetmeye veya daha fazla işlemeye hazır bir GeneratedBarcode nesnesi geri alırsınız.

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

Imports IronBarCode

' Generate a Code 128 barcode from a product SKU string
Dim productCode As String = "SKU-78432-A"
Dim barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128)
barcode.SaveAsPng("product_barcode.png")

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

Imports IronBarCode

' Specify width and height in pixels for the barcode image
Dim productCode As String = "SKU-78432-A"
Dim barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120)
barcode.SaveAsPng("product_barcode_sized.png")

IronBarcode Hangi Barkod Biçimlarını Destekler?

IronBarcode, farklı kullanım durumları için 20'den fazla barkod türünü destekler. Doğru formatın seçilmesi, uygun tarama ve uygulama için yeterli veri kapasitesi sağlar.

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

Imports IronBarCode

Dim url As String = "https://ironsoftware.com/csharp/barcode/"
Dim numericId As String = "0123456789012"

' QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode) _
    .SaveAsPng("qrcode.png")

' UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA) _
    .SaveAsPng("upc_barcode.png")

' PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417) _
    .SaveAsJpeg("pdf417_barcode.jpeg")

C#'da Barkod Görüntülerini Özelleştirme ve Stil Verme Nasıl Yapılır?

Temel barkod oluşturmanın ötesinde, IronBarcode, dış bir görüntü işleme kütüphanesine ihtiyaç duymadan renkleri ayarlamak, açıklamalar eklemek ve barkod görüntülerini yeniden boyutlandırmak için akıcı bir stil API'ı sunar.

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

Imports IronBarCode
Imports IronSoftware.Drawing

Dim orderNumber As String = "ORD-2024-00542"
Dim styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128)

' Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue)
styledBarcode.ChangeBackgroundColor(Color.White)

' Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", New Font("Arial", 12), Color.Black, 5)
styledBarcode.AddBarcodeValueTextBelowBarcode(New Font("Arial", 10), Color.Gray, 5)

' Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150)
styledBarcode.SaveAsPng("styled_order_barcode.png")

Veritabanı Verilerinden Birden Çok Barkod Nasıl Oluşturulur?

Gerçek dünya uygulamaları, ürün katalogları, stok yenileme çalışmaları veya sipariş sevkiyat iş akışları gibi öğe koleksiyonları için sık sık barkod oluşturma gerektirir. IronBarcode, ek yapılandırma gerektirmeyen toplu işlem yapar.

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

Imports IronBarCode

' Data sourced from a database query result
Dim productIds As New List(Of String) From {
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
}

' Generate one barcode image per product ID
For Each productId As String In productIds
    Dim barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100)
    barcode.SaveAsPng($"barcodes/{productId}.png")
Next

Barkodları Farklı Dosya Biçimlarında Nasıl Kaydeder ve Dışa Aktarırsınız?

GeneratedBarcode, iş uygulamalarında kullanılan en yaygın görüntü formatlarını kapsayan bir dizi kaydetme yöntemi sunar:

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(ImageFormat.Png).ToArray();

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(ImageFormat.Png).ToArray();

Imports IronBarCode

Dim value As String = "EXPORT-TEST-001"
Dim barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120)

' Save to disk in multiple formats
barcode.SaveAsPng("barcode.png")       ' Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg")      ' Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif")       ' Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff")     ' Multi-page archival format
barcode.SaveAsBmp("barcode.bmp")       ' Uncompressed bitmap

' Export as a byte array for in-memory operations (API responses, database storage)
Dim pngBytes As Byte() = barcode.ToStream(ImageFormat.Png).ToArray()

Doğru formatı seçmek, aşağı akış tüketicisine bağlıdır. PNG, baskıya hazır etiketler ve belgeler için iyi çalışır. JPEG, depolama boyutunun bir kısıt olduğu uygulamalar için uygundur. Barkodları doğrudan PDF belgelerine gömme için, IronBarcode, barkod görüntülerini programlı olarak damgalamak veya eklemek için IronPDF ile entegre olur.

ToStream aşırı yüklemesi, diske yazmanın istenmediği web API'leri ve bulut işlevlerinde özellikle değerlidir. Bayt dizisi, bir veri tabanı BLOB sütununda saklanabilir, bulut depolama alanına yüklenebilir veya herhangi bir ara dosya olmadan doğrudan bir HTTP yanıtına aktarılabilir.

Veriyi Kodlamadan Önce Nasıl Doğrularsınız?

Her dize, her barkod formatı için geçerli değildir. UPC-A tam olarak 12 adet sayısal rakam gerektirir, EAN-13 ise 13 gerektirir ve bazı 1D formatları sınırlı bir ASCII dizisinin dışındaki karakterleri reddeder. Geçersiz veriyi CreateBarcode göndermek bir IronBarCodeEncodingException oluşturur. Çağrıyı bir try/catch bloğunda sararak ve girdileri önceden doğrulayarak üretimde işlenmemiş istisnaları önler:

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

Imports IronBarCode

Function TryCreateBarcode(value As String, encoding As BarcodeEncoding, outputPath As String) As Boolean
    If String.IsNullOrWhiteSpace(value) Then
        Console.WriteLine("Value must not be empty.")
        Return False
    End If

    Try
        Dim barcode = BarcodeWriter.CreateBarcode(value, encoding)
        barcode.SaveAsPng(outputPath)
        Return True
    Catch ex As IronBarCodeEncodingException
        Console.WriteLine($"Encoding failed: {ex.Message}")
        Return False
    End Try
End Function

' Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png")   ' succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png")  ' encoding exception

Bir Dizgi Değerinden Barkodu Geri Nasıl Okursunuz?

Birçok sistemde barkod oluşturmak, iş akışının sadece yarısıdır. çubuk kod okuma API'si, bir görüntüyü orijinal dizgeye geri çözmek için BarcodeReader.Read kullanır.

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Biçim detected: {result.BarcodeType}");
}

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Biçim detected: {result.BarcodeType}");
}

Imports IronBarCode

' Read all barcodes from an image file
Dim results = BarcodeReader.Read("product_barcode.png")

For Each result In results
    ' Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}")
    Console.WriteLine($"Biçim detected: {result.BarcodeType}")
Next

Bu, yuvarlak-trip barkod iş akışlarını -- bir ürün kaydından barkod oluşturma, disk veya bir etiket yazıcı kuyruğuna kaydetme, daha sonra fiziksel etiketi tarama ve kaydı görmek için değeri kod çözme -- oluşturmayı kolaylaştırır. PDF dosyalarından barkodları okuma veya canlı kamera akımlarında, IronBarcode, aynı basit API ile özel yöntemler sunar.

IronBarcode ASP.NET Core Web API'lerinde Nasıl Kullanılır?

IronBarcode, ASP.NET Core kontrolcülerinde ve minimal API işleyicilerde çalışır. En yaygın desen, tarayıcıda renderlama için bir dosya sonucu veya base64 kodlu veri URI olarak bir barkod görüntüsü döndürür.

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(ImageFormat.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(ImageFormat.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc

Dim builder = WebApplication.CreateBuilder(args)
Dim app = builder.Build()

' Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", Function(value As String)
                                   Dim barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120)
                                   Dim imageBytes As Byte() = barcode.ToStream(ImageFormat.Png).ToArray()
                                   Return Results.File(imageBytes, "image/png")
                               End Function)

app.Run()

Uç nokta, URL yolunda geçirilen herhangi bir değer için talebe bağlı bir barkod oluşturur. Üretim dağıtımları için, aynı barkod değerine yönelik tekrarlayan isteklerin görüntüyü yeniden oluşturmamasını sağlamak için önbellekleme ekleyin. Bağımlılık enjeksiyonu ve yanıt önbellekleme dahil olmak üzere daha ayrıntılı bir adım adım kılavuz için tam ASP.NET barkod oluşturma öğreticisine bakın.

Sonraki Adımlarınız Neler?

C# dilinde string verilerden barkod oluşturmak IronBarcode ile kolaydır. Akıcı API, barkod kodlamasının karmaşıklığını yönetirken özelleştirme ve toplu işleme için esneklik sağlar. Hedefiniz envanter için basit Code 128 barkodları veya mobil uygulamalar için QR kodları olsun, IronBarcode, .NET uygulamaları için güvenilir barkod işlevselliği sunar.

Daha ileri gitmek için:

• IronBarcode'u indirin ve bu kılavuzdan kod örneklerini yerel olarak çalıştırın
• Bir lisans satın alın üretim dağıtımı için -- lisanslar ücretsiz deneme süresi ile başlar
• Dokümantasyonu gözden geçirin API referansı, gelişmiş yapılandırma ve platforma özel notlar için
• Kod örneklerini keşfedin QR kod üretimi, barkod tarama, PDF entegrasyonu ve daha fazlasını kapsayan
• ASP.NET barkod entegrasyonu -- MVC görünümleri ve Razor Sayfaları'nda barkod renderingi için tam kılavuz
• Barkod tarayıcı entegrasyonu -- C# dilinde görüntülerden, PDF'lerden ve USB tarayıcılardan barkod okuma

Şimdi IronBarcode ile başlayın.

Ücretsiz Başlayın