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 seçin ve ardından Konsol Uygulaması/Windows Form/WPF Uygulaması seçeneğini seçin. Barkodlar her tür uygulamada da kullanılabilir. Daha sonra, bunları Webform/MVC/MVC Core gibi uygulamalarla kullanabilirsiniz.

Yeni projenizi yapılandırın

Proje adını girin ve Visual Studio'daki uygun metin kutusuna dosya yolunu seçin. Sonra, Oluştur butonuna tıklayın ve ayrıca gerekli .NET Framework'ü seçin. Proje şimdi seçilen uygulama için yapıyı oluşturacak. Eğer Konsol Uygulaması seçtiyseniz, artık kodu girebileceğiniz ve uygulamayı oluşturup/çalıştırabileceğiniz program.cs dosyası açılacaktır.

2. IronBarcode NuGet Paketini Kurun

Şimdi Visual Studio'daki Çözüm Gezgini'ne gidin ve projeye sol tıklayın. Açılan menüden menüden NuGet Paket Yöneticisi'ni seçin ve anahtar kelime olarak 'Barcode' arayın. NuGet Paket iletişim kutusunda ilk sonucu seçin ve yükleme seçeneğine tıklayın.

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

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

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

Install-Package IronQR

NuGet Paket Yöneticisi Konsolu

Barcode Reader SDK'nın en son sürümü 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 tüm DLL dosyalarını indirecek ve ayrıca mevcut projede bir .NET proje referansı olarak DLL dosyasının referansını ekleyecektir.

Visual Studio projesi artık kod ile kullanıma hazırdır.

3. Referans Ekleme

Aşağıda gösterildiği gibi koda IronBarCode referansını ekleyin, böylece .NET Core'da IronBarcode kütüphanesinde mevcut fonksiyonları kullanabilirsiniz. Barkod okuyucu kontrolü, QR kodlarını okuma, bileşenler, QR kodu türleri desteği ve barkod okuyucu SDK uyumluluğu hakkında daha fazla bilgi edinmek için lütfen şu 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ını 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ü, bir Read veya ReadAsync fonksiyonu ile 15 farklı barkod türünü tarama yeteneği sunar. IronBarcode kutuphanesi ile QR kodlarını/bar kodlarını çeşitli kaynaklardan okuma imkanı tanır:

• Dize
• Akış
• Görüntü
• Bitmap

5. String Kullanarak Barkodu Okuyun

QR kodları ve barkod görüntüleri, .NET barkod okuyucu kitaplığı ile kolayca okunabilir. Read yöntemi, QR kodu görüntülerini tarayacak ve QR kodları ile barkodları metne çevirecek statik bir fonksiyondur. Bit eşlem, PNG dosyaları, JPEG, TIFF vb. gibi çeşitli türlerde görüntü dosyalarını kabul eder.

Bu Read fonksiyonu, görüntüden QR kodu/barkod verilerini çıkarır ve sonucu BarcodeResult nesnesi olarak döndürür. Eğer resim dosyası kod tarafından tanınmazsa, null dönecektir.

BarcodeResult aşağıdaki değerlere sahiptir:

• BarkodTürü
• Değer
• Metin
• İkili değer

BarcodeType bir enumeration veri türüdür ve verilen giriş görüntüsünün barkod türünü döndürür. IronBarcode tarafından desteklenen yirmi iki barkod türü vardır. Verilen giriş görüntüsüne uygulanmış barkod türünü döndürecektir.

Değer ve metin de BarcodeResult üzerine kullanılabilir nesne türü değerlerdir. Hem değer hem de metin, barkodun dize değerini döndüren dize veri türleridir. Read yöntemi, QR kodları ve barkodları okuyacak ve verilen barkod görüntüsünün dize değerini değer/metin olarak alacaktır. İkili değer bayt veri türüdür ve verilen görüntünün baytını döndürür. Aşağıda, herhangi bir .NET Windows Forms veya .NET Standard Uygulamalarında kullanılabilecek 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, QR kodlarını ve barkodlarını .NET barkod okuyucu kitaplığı kullanarak nasıl okuyacağınızı gösterir. Kod, sistemi bir Bitmap nesnesine dosya eşleştirerek kullanması oldukça basittir. Ayrıca, görüntüden QR kodunu/barkodu çözer ve sonucu nesne içinde gösterir. Kodda taranması için sağlanan QR kodları/barkodlar aşağıda verilmiştir.

Barkod girişi

6. Bir TIFF Görüntüsünden Birden Fazla Barkodu Okuyun

.NET barkod okuyucu kontrolü, çoklu QR kodları/barkodları aynı Read yöntemi kullanarak bir görüntü dosyasından okumaya olanak tanır, bu da kullanımı çok kolaydır.

Aşağıda, bir görüntüden birden fazla QR kodu okuma örnek kodu verilmiştir:

// 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 görüntülerinden çıkarılır. .NET barkod okuyucu, sistemdeki görüntüden QR kodlarını tarar ve sonucu bir dizi olarak döndürür. Yukarıdaki kodda, Code128 için barkod yalnızca taranan türdür. Görüntüde başka barkodlar varsa, bunlar göz ardı edilecektir.

7. PDF'ten QR Kodu ve Barkodları Okuma

Bu bölüm, PDF belgelerinden QR kodunu nasıl okuyacağınızı gösterir. QR kodu kütüphanesi, mevcut tüm QR kodları için tüm sayfaları ve dosyaları tarar veya belirli bir barkod türüne odaklanır. IronBarcode kullanıldığında, kütüphane, standart bir barkod okuyucu için gerekli tüm DLL'leri sağlar, bu nedenle .NET proje referansı olarak başka bir DLL eklemenize gerek yoktur.

Aşağıda, PDF'den QR kodu/barkod okuma örnek kodu verilmiştir.

// 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ıda, PDF dosyasından QR kodları/barkodları okumak için basit bir ReadPdf yöntemi ile örnek kod bulunmaktadır. Ayrıca, her barkod ve türü için detaylı sonuçlar sağlayabilir.

Sonuç

.NET Barkod okuyucular, QR kodlarını okumak veya QR kodları ve barkodları basit adımlarla kodlamak/oluşturmak için basit ve kolay bir yol sağlar. IronBarcode DLL, .NET Windows Forms Uygulamaları, Mobil Uygulamalar, Web Uygulamaları, MAUI ve Blazor gibi ortamlar üzerinde .NET Framework veya .NET Standard kullanarak kullanılabilir. Ayrıca, IronBarcode, barkod okuma hızını artırmak için kırpma bölgeleri veya çoklu iş parçacığı (multi-threading) ve ML modelinin doğruluğu gibi birçok özelleştirme seçeneği sunar. IronBarcode, ücretsiz bir deneme anahtarı sunar veya şu anda Iron Software'den beş ürünü sadece iki fiyatına alabilirsiniz.

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

Ayrıca bir zip dosyası projesi indirebilirsiniz.