C# QR Kodu Okuyucu (Adım Adım Eğitici)

1. Yeni Bir Proje Oluşturma

Visual Studio'yu açın ve Dosya menüsüne gidin. Yeni Proje'yi seçin ve ardından Konsol Uygulaması/Windows Forms/WPF Uygulaması seçin. Barkodlar, tüm uygulama türlerinde de kullanılabilir. Ayrıca, onları Webform/MVC/MVC Core gibi uygulamalarla da kullanabilirsiniz.

Yeni projenizi yapılandırın

Proje adını girin ve Visual Studio'daki uygun metin kutusunda dosya yolunu seçin. Ardından, Oluştur düğmesine tıklayın ve gereken .NET Framework'ü seçin. Proje, seçilen uygulama için artık yapıyı oluşturacaktır. Eğer Konsol Uygulaması seçtiyseniz, şimdi kodu girebileceğiniz ve uygulamayı derleyip çalıştırabileceğiniz program.cs dosyası açılacaktır.

2. IronBarcode NuGet Paketini Yükleyin

Şimdi Visual Studio'da Solution Explorer'a gidin ve projeyi sol tıklayın. Açılan menüden NuGet Paket Yöneticisi'ni menüden seçin ve anahtar kelime olarak "Barcode" arayın. NuGet Paket diyaloğunda ilk sonucu seçin ve yükleme seçeneğine tıklayın.

IronBarcode kütüphanesini NuGet Paket Yöneticisinden Yükleyin

Alternatif olarak, Visual Studio'da şu talimatları izleyin: Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu

Paket Yöneticisi Konsolu sekmesini açın. Aşağıdaki satırı yazın:

Install-Package IronQR

NuGet Paket Yöneticisi Konsolu

Barkod Okuyucu SDK'sının en son versiyonu hakkında daha fazla bilgi edinmek için aşağıdaki bağlantıya gidin.

https://www.nuget.org/packages/Barcode

Sonraki adımda, paket DLL dosyalarını indirecek ve ayrıca .NET proje referansı olarak geçerli projeye DLL dosyası referansını ekleyecektir.

Visual Studio projesi kodla kullanıma hazır.

3. Referans Ekleme

.NET Core'da IronBarcode kütüphanesinde mevcut olan fonksiyonları kullanmayı sağlayarak, aşağıda gösterildiği gibi koda IronBarCode referansı ekleyin. Barkod okuyucu kontrolü, QR kodlarını okuma, bileşenler, QR kod türleri için destek ve barkod okuyucu SDK'sının çevrimliliği hakkında daha fazla bilgi için bu bağlantıya bakın: https://ironsoftware.com/csharp/barcode/

using IronBarCode;

using IronBarCode;

Imports IronBarCode

4. Bir Barkod Örneği Oluşturma

BarcodeReader QR kodları okumak/oluşturmak için kullanılan statik sınıftır. Statik sınıf BarcodeReader için herhangi bir nesne örneği oluşturmadan kullanılabilir. Barkod okuyucu kontrolü, Read veya ReadAsync tek bir fonksiyon kullanarak 15 tür barkod tarama özelliğine sahiptir. IronBarcode kütüphanesi, çeşitli kaynaklardan QR kodlarının/barkodların okunmasına olanak sağlar:

• String
• Akış
• Resim
• Bitmap

5. String Kullanarak Barkodu Okuyun

.NET barkod okuyucu kütüphanesi ile QR kodlarını ve barkod resimlerini kolayca okuyabilirsiniz. Read metodu, QR kod resimlerini tarayan ve QR kodları ve barkodlarını metne dönüştüren statik bir fonksiyondur. Bitmap, PNG dosyaları, JPEG, TIFF gibi çeşitli resim dosyalarını kabul eder.

Bu Read işlevi, resimden QR kodu/barkod verilerini çıkartır ve sonucu BarcodeResult nesnesi olarak getirir. Eğer resim dosyası kod tarafından tanınmazsa, null döndürür.

BarcodeResult şu değerlere sahiptir:

• Barcode Türü
• Değer
• Metin
• İkili değer

BarcodeType bir enum veri tipidir ve verilen giriş resminin barkod türünü döndürür. IronBarcode tarafından desteklenen yirmi iki barkod türü vardır. Uygulanan barkod türünü, verilen giriş resmine göre döndürecektir.

Değer ve metin, ayrıca BarcodeResult üzerinde mevcut olan nesne tipi değerlerdir. Hem değer hem de metin, barkodun string değerini döndüren string veri tipleridir. Read metodu, QR kodları ve barkodlarını okuyarak verilen barkod resminin string değerini değer/metin olarak alır. Binary value, bayt veri türü olup, verilen resim byte'ını döndüren bir türdür. Aşağıda, herhangi bir .NET Windows Forms veya .NET Standard'ı uygulamalarında kullanılmak üzere hızlı yanıt kodu bulunmaktadır.

// Read a barcode from an image file
BarcodeResult result = BarcodeReader.Read("test.bmp");
// Check if the result is not null and matches the expected text
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}

// Read a barcode from an image file
BarcodeResult result = BarcodeReader.Read("test.bmp");
// Check if the result is not null and matches the expected text
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}

' Read a barcode from an image file
Dim result As BarcodeResult = BarcodeReader.Read("test.bmp")
' Check if the result is not null and matches the expected text
If result IsNot Nothing AndAlso result.Text = "https://ironsoftware.com/csharp/barcode" Then
	System.Console.WriteLine("Success")
End If

Yukarıdaki kod, .NET barkod okuyucu kütüphanesi kullanarak QR kodlarını ve barkodları nasıl okuyacağınızı göstermektedir. Kodun kullanımı basittir, sistemden bir dosyayı bir Bitmap nesnesine eşler. Aynı zamanda resimden QR kodu/barkodu çözümleyip sonucu nesne içinde gösterir. Aşağıda, kodda sağlanan QR kodları/barkodlar, kodlanmış verileri taramak için bulunmaktadır.

Barkod girdi

6. TIFF Resiminden Birden Çok Barkod Okuma

.NET barkod okuyucu kontrolü, çoklu QR kodları/barkodları bir resim dosyasından aynı Read metodunu kullanarak okumaya izin verir, bu kullanımı çok kolaydır.

Aşağıda, görüntüden birden fazla QR kodu okuma için örnek kod bulunmaktadır:

// Configure barcode reader options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

// Read multiple barcodes from a TIFF image
BarcodeResult[] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);

// Configure barcode reader options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

// Read multiple barcodes from a TIFF image
BarcodeResult[] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);

' Configure barcode reader options
Dim options As New BarcodeReaderOptions() With {
	.ExpectBarcodeTypes = BarcodeEncoding.Code128,
	.ExpectMultipleBarcodes = True
}

' Read multiple barcodes from a TIFF image
Dim multiFrameResults() As BarcodeResult = BarcodeReader.Read("Multiframe.tiff", options)

Yukarıdaki kodda, QR kodları TIFF QR kodu resimlerinden çıkarılır. .NET barkod okuyucu, sistemden QR kodlarını resimden tarar ve sonucu bir dizi olarak döndürür. Yukarıdaki kodda, Code128 için olan barkod sadece taranan türdür. Resimde bulunan başka barkodlar varsa, onlar gözardı edilecektir.

7. QR Kod ve Barkodları PDF Dosyasından Okuma

Bu bölüm, PDF belgelerinden QR kodlarını nasıl okuyacağınızı göstermektedir. QR kod kütüphanesi, mevcut tüm QR kodları için tüm sayfaları ve dosyaları tarayacak veya belirli bir barkod türüne odaklanacak. IronBarcode kullanırken, kütüphane standart bir barkod okuyucusu için gereken tüm ilgili DLL dosyalarını sağlar, böylece başka bir DLL dosyasını .NET proje referansı olarak dahil etmeniz gerekmez.

Aşağıda, PDF'den QR kodları/barkodları okumak için kullanılabilecek örnek kod bulunmaktadır.

// Read barcodes from each page of a PDF document
PagedBarcodeResult[] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Process results for each page
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte[] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}

// Read barcodes from each page of a PDF document
PagedBarcodeResult[] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Process results for each page
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte[] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}

' Read barcodes from each page of a PDF document
Dim pagedResults() As PagedBarcodeResult = BarcodeReader.ReadPdf("MultipleBarcodes.pdf")
' Process results for each page
For Each pageRes As PagedBarcodeResult In pagedResults
	Dim pageNumber As Integer = pageRes.PageNumber
	Dim value As String = pageRes.Value
	Dim img As Bitmap = pageRes.BarcodeImage
	Dim barcodeType As BarcodeEncoding = pageRes.BarcodeType
	Dim binary() As Byte = pageRes.BinaryValue
	Console.WriteLine(pageRes.Value)
Next pageRes

Yukarıdaki, basit bir ReadPdf metodu kullanarak bir PDF dosyasından QR kodlarını/barkodlarını okumak için örnek koddur. Ayrıca, her barkod ve türü için ayrıntılı sonuçları da sağlayabilir.

Sonuç

.NET Barkod okuyucuları, QR kodları veya barkodları okuma/çözümleme/oluşturma işlemlerini basit adımlarla gerçekleştirmenin kolay ve basit bir yolunu sunar. IronBarcode DLL, .NET Windows Forms Uygulamaları, Mobil Uygulamalar, Web Uygulamaları, MAUI ve Blazor gibi çeşitli ortamlarda .NET Framework veya .NET Standard kullanılarak kullanılabilir. Ayrıca, IronBarcode, kesme bölgeleri veya çoklu iş parçacığı ve ML modelinin doğruluğu gibi barkod okuma hızını artırmak için geniş bir özelleştirme seçenekleri sunar. IronBarcode, ücretsiz bir deneme anahtarı sunar veya şu anda Iron Software'dan sadece iki ürün fiyatına beş ürün satın alabilirsiniz.

Daha fazla bilgi için lisans sayfasını ziyaret edin.

zip dosya projesi de indirebilirsiniz.