ASP .NET'te QR Kodu Nasıl Tarama

ASP.NET'te QR Kod Nasıl Taralır

1. Visual Studio kullanarak bir ASP.NET projesi oluşturun.
2. Paket Yöneticisi'nden IronQR kütüphanesini kurun.
3. QR Resmini yükleyin ve QR'yi okuyun.
4. Gelişmiş QR Kod okuyun.

QR Kodlarını Anlamak ve Kullanım Alanları

QR (Quick Response) kodları, genellikle akıllı telefonlar veya özel tarayıcı cihazlarla taranan, URL'lerden iletişim bilgilerine kadar değişen bilgileri depolayabilen iki boyutlu barkodlardır. Web uygulamalarında, QR kodları aşağıdakiler gibi çeşitli amaçlara hizmet edebilir:

• Hızlı web sitesi erişimi: Kullanıcıları bir URL yazmaya gerek olmadan belirli bir web adresine yönlendirme.
• Etkinlik biletleme: Etkinlik erişimi için biletlerdeki QR kodlarını doğrulama.
• Ödeme sistemleri: QR kodunu tarayarak kolay ödeme yapma imkanı.
• Ürün bilgisi: Ürünler hakkında ek bilgi sunma.

IronQR Tanıtımı

IronQR, güçlü işlevsellik ve kullanım kolaylığını göz önünde bulundurarak tasarlanmış, QR kodu oluşturma ve tarama için bir .NET kütüphanesidir. Bu çok yönlü kütüphane, sadece QR kodlarını yönetmekle kalmaz, aynı zamanda diğer barkod türlerini de yöneten, .NET ekosisteminde çalışan geliştiriciler için tercih edilen bir seçenektir. IronQR kütüphanesini bir ASP.NET uygulamasına entegre ederek QR kodunun taranmasını sağlayacağız.

IronQR'nin Temel Avantajları ve Özellikleri

1. QR Kodları Okuma: IronQR, jpg, png, svg, bmp, gif, tif, tiff ve daha fazlası dahil olmak üzere çeşitli resim formatlarından QR kodlarını okuyabilir. Ayrıca çok sayfalı resimleri ve özel QR algılama modellerini de destekler. Çıktı veri formatları, metinleri, URL'leri, koordinatları ve daha fazlasını içerir.

2. QR Kodları Yazma: QR kodları üretebilir ve bunları resimler (jpg, png, gif, tiff, bmp), akışlar olarak kaydedebilir veya mevcut PDF'lere damgalayabilirsiniz. Metin, URL, bayt ve numaralar gibi verileri kodlayabilir ve QR kodları üretebilirsiniz. QR kodu stillerini yeniden boyutlandırarak, kenar boşluklarını ayarlayarak, yeniden renklendirerek ve logolar ekleyerek özelleştirin.

3. Hata Yönetimi ve Düzeltme: IronQR, ayrıntılı hata mesajları ve özel QR hata düzeltme sağlar. Hata toleransını garanti eder ve null kontrolü ve kontrol toplamlarını destekler.

4. Gelişmiş Makine Öğrenimi Modeli: IronQR, QR kodu tanıma için gelişmiş bir Makine Öğrenimi Modeli kullanır. Bu model, mobil, masaüstü ve bulut ortamları da dahil olmak üzere çeşitli platformlarda doğru ve güvenilir QR kodu okumayı sağlar.

5. Çapraz Platform Uyumluluğu: IronQR, çeşitli .NET sürümlerinde (örn. .NET Core (8, 7, 6, 5 ve 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+)) çalışan ve C#, F#, ve VB.NET için tasarlanmıştır.

6. Web (Blazor ve WebForms), mobil (Xamarin ve MAUI), masaüstü (WPF ve MAUI) ve konsol uygulamaları dahil olmak üzere farklı proje türlerini destekler.

7. Geniş QR Kod Desteği: IronQR, çok çeşitli QR kodları ve diğer türdeki barkodları yönetmede üstünlük sağlar. Standart QR kodları, Mikro QR kodları, bir QR kod barkod görüntüsü veya Aztec veya Data Matrix gibi belirli formatlarla uğraşırken, IronQR sizi kapsar. IronQR ayrıca QR kodu barkodlarını okuma işlevselliğini destekler.

IronQR, ofis belgeleri, PDF düzenleme, OCR ve daha fazlası için çeşitli araçlar içeren .NET API ürünleridir.

Adım 1: Visual Studio Kullanarak Yeni Bir ASP.NET Projesi Oluşturun

Aşağıda gösterildiği gibi yeni bir Proje oluşturun ve MVC şablonunu seçin:

Sonraki adımda, proje adı ve konumunu belirtmelisiniz.

.NET sürümünü seçin.

Oluştur düğmesine tıklamak aşağıdaki kod ve projeyi oluşturacaktır.

Adım 2: Visual Studio Paket Yöneticisi'nden IronQR Kütüphanesini Kurun

Aşağıda gösterildiği gibi Visual Studio paket yöneticisinden IronQR kütüphanesini kurun:

IronQR aynı zamanda NuGet Paket Yöneticisi kullanılarak da kurulabilir.

Adım 3: QR Resmini Yükle ve QR Resmini Oku

Şimdi bir QR kodu uygulaması oluşturalım.

// Import necessary namespaces
using System.ComponentModel.DataAnnotations;

namespace IronQRScannerAsp.Models
{
    public class QRCodeModel
    {
        // Property to hold the uploaded QR code image
        [Display(Name = "Select QR Image")]
        public IFormFile QRCodeImage { get; set; }
    }
}

// Import necessary namespaces
using System.ComponentModel.DataAnnotations;

namespace IronQRScannerAsp.Models
{
    public class QRCodeModel
    {
        // Property to hold the uploaded QR code image
        [Display(Name = "Select QR Image")]
        public IFormFile QRCodeImage { get; set; }
    }
}

' Import necessary namespaces
Imports System.ComponentModel.DataAnnotations

Namespace IronQRScannerAsp.Models
	Public Class QRCodeModel
		' Property to hold the uploaded QR code image
		<Display(Name := "Select QR Image")>
		Public Property QRCodeImage() As IFormFile
	End Class
End Namespace

// Import necessary namespaces
using IronQr;
using IronQRScannerAsp.Models;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

namespace IronQRScannerAsp.Controllers
{
    // Controller to handle QR code scanning functionalities
    public class QrCodeController : Controller
    {
        private readonly IWebHostEnvironment _environment;

        // Constructor for dependency injection of the hosting environment
        public QrCodeController(IWebHostEnvironment environment)
        {
            _environment = environment;
        }

        // Displays the initial View
        public IActionResult Index()
        {
            ViewBag.QrCodeText = "Text";
            return View();
        }

        // Handles the POST request to scan a QR code
        [HttpPost]
        public IActionResult ScanQRCode(QRCodeModel qrImage)
        {
            string path = Path.Combine(_environment.WebRootPath, "ScanQRCode");
            if (!Directory.Exists(path))
            {
                Directory.CreateDirectory(path);
            }

            // Define the file path for saving the uploaded QR image
            string filePath = Path.Combine(_environment.WebRootPath, "ScanQRCode/qrcode.png");
            using (var stream = System.IO.File.Create(filePath))
            {
                qrImage.QRCodeImage.CopyTo(stream); // Save uploaded image to server
            }

            // Open the asset to read a QR Code from
            var bitmap = AnyBitmap.FromFile(filePath);

            // Load the asset into QrImageInput
            QrImageInput imageInput = new QrImageInput(bitmap);

            // Create a QR Reader object
            QrReader reader = new QrReader();

            // Read the Input and get all embedded QR Codes
            IEnumerable<QrResult> results = reader.Read(imageInput);

            // Display scanned text and image on the view
            ViewBag.QrCodeText = results.First().Value;
            string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}" + "/ScanQRCode/qrcode.png";
            ViewBag.QrCodeUri = imageUrl;

            return View();
        }
    }
}

// Import necessary namespaces
using IronQr;
using IronQRScannerAsp.Models;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

namespace IronQRScannerAsp.Controllers
{
    // Controller to handle QR code scanning functionalities
    public class QrCodeController : Controller
    {
        private readonly IWebHostEnvironment _environment;

        // Constructor for dependency injection of the hosting environment
        public QrCodeController(IWebHostEnvironment environment)
        {
            _environment = environment;
        }

        // Displays the initial View
        public IActionResult Index()
        {
            ViewBag.QrCodeText = "Text";
            return View();
        }

        // Handles the POST request to scan a QR code
        [HttpPost]
        public IActionResult ScanQRCode(QRCodeModel qrImage)
        {
            string path = Path.Combine(_environment.WebRootPath, "ScanQRCode");
            if (!Directory.Exists(path))
            {
                Directory.CreateDirectory(path);
            }

            // Define the file path for saving the uploaded QR image
            string filePath = Path.Combine(_environment.WebRootPath, "ScanQRCode/qrcode.png");
            using (var stream = System.IO.File.Create(filePath))
            {
                qrImage.QRCodeImage.CopyTo(stream); // Save uploaded image to server
            }

            // Open the asset to read a QR Code from
            var bitmap = AnyBitmap.FromFile(filePath);

            // Load the asset into QrImageInput
            QrImageInput imageInput = new QrImageInput(bitmap);

            // Create a QR Reader object
            QrReader reader = new QrReader();

            // Read the Input and get all embedded QR Codes
            IEnumerable<QrResult> results = reader.Read(imageInput);

            // Display scanned text and image on the view
            ViewBag.QrCodeText = results.First().Value;
            string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}" + "/ScanQRCode/qrcode.png";
            ViewBag.QrCodeUri = imageUrl;

            return View();
        }
    }
}

' Import necessary namespaces
Imports IronQr
Imports IronQRScannerAsp.Models
Imports IronSoftware.Drawing
Imports Microsoft.AspNetCore.Mvc

Namespace IronQRScannerAsp.Controllers
	' Controller to handle QR code scanning functionalities
	Public Class QrCodeController
		Inherits Controller

		Private ReadOnly _environment As IWebHostEnvironment

		' Constructor for dependency injection of the hosting environment
		Public Sub New(ByVal environment As IWebHostEnvironment)
			_environment = environment
		End Sub

		' Displays the initial View
		Public Function Index() As IActionResult
			ViewBag.QrCodeText = "Text"
			Return View()
		End Function

		' Handles the POST request to scan a QR code
		<HttpPost>
		Public Function ScanQRCode(ByVal qrImage As QRCodeModel) As IActionResult
			Dim path As String = System.IO.Path.Combine(_environment.WebRootPath, "ScanQRCode")
			If Not Directory.Exists(path) Then
				Directory.CreateDirectory(path)
			End If

			' Define the file path for saving the uploaded QR image
			Dim filePath As String = System.IO.Path.Combine(_environment.WebRootPath, "ScanQRCode/qrcode.png")
			Using stream = System.IO.File.Create(filePath)
				qrImage.QRCodeImage.CopyTo(stream) ' Save uploaded image to server
			End Using

			' Open the asset to read a QR Code from
			Dim bitmap = AnyBitmap.FromFile(filePath)

			' Load the asset into QrImageInput
			Dim imageInput As New QrImageInput(bitmap)

			' Create a QR Reader object
			Dim reader As New QrReader()

			' Read the Input and get all embedded QR Codes
			Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

			' Display scanned text and image on the view
			ViewBag.QrCodeText = results.First().Value
			Dim imageUrl As String = $"{Me.Request.Scheme}://{Me.Request.Host}{Me.Request.PathBase}" & "/ScanQRCode/qrcode.png"
			ViewBag.QrCodeUri = imageUrl

			Return View()
		End Function
	End Class
End Namespace

Kod Açıklaması

Verilen kod parçası, IronQR kütüphanesini kullanarak QR kod tarama işlevselliklerini ele almak için tasarlanmış QrCodeController adlı bir ASP.NET Core MVC denetleyicisi içindir. İşte kodun ne yaptığına dair kısa açıklama:

Kontrolör Sınıfına Görünüm Ekle

Yeni bir görünüm ekleyin, QrCodeController sınıfındaki CreateQRCode eylem metoduna sağ tıklayın.

"Görünüm Ekle" seçeneğini, ardından "Razor Görünüm" seçeneğini seçin. "Ekle"ye tıklayın.

Daha sonra "Oluştur" şablonunu ve daha önce oluşturulmuş Model sınıfını seçin.

Şimdi, görünüm sınıfındaki kodu aşağıda gösterilenle değiştirin.

@model IronQRScannerAsp.Models.QRCodeModel

@{
    ViewData["Title"] = "ScanQRCode";
}

<h1>ScanQRCode</h1>
<h4>QRCodeModel</h4>
<hr />
<div class="row">
    <div class="col-md-14">
        <form asp-action="ScanQRCode" enctype="multipart/form-data">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label for="QRCodeImage">Select QR Image:</label>
                <input asp-for="QRCodeImage" class="form-control" type="file" />
            </div>
            <div class="form-group">
                <input type="submit" value="Upload" class="btn btn-primary" />
            </div>
        </form>
    </div>
</div>
<div>
    <h3>Scanned Text:</h3>
    <h4>@ViewBag.QrCodeText</h4>
    @if (ViewBag.QrCodeUri != null)
    {
        <img src="@ViewBag.QrCodeUri" class="img-thumbnail" />
    }
</div>
<div>
    <a asp-action="Index">Clear</a>
</div>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

Şimdi Program.cs içinde yukarıdaki görünümü varsayılan rota yapmak için aşağıdaki kodu değiştirin:

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=Index}");

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=Index}");

app.MapControllerRoute(name:= "default", pattern:= "{controller=QrCode}/{action=Index}")

Bu işlemi varsayılan rotayı HomeController'dan bizim QrCode Denetleyicisine değiştirir.

URL ile birlikte Giriş Resim: https://ironsoftware.com/csharp/qr/.

Çıktı

Sayfada, bir QR kod resmi seçin ve QR kodunu çözmek için yüklemeye tıklayın. Bu uygulama aynı zamanda bir video beslemesinden okumak ve sonuçları göstermek için de değiştirilebilir.

Adım 4: Gelişmiş QR Kodu Okuma

Gelişmiş QR kodlarını okumak için, IronQR aşağıdaki ayarları sağlar.

// Import necessary namespaces
using IronQr;
using IronSoftware.Drawing;
using IronQr.Enum;
using System.Collections.Generic;

// Load an image file as a bitmap
var inputBmp = AnyBitmap.FromFile("QrImage.png");

// Use Auto => Machine Learning Scan
QrImageInput scan_ML_and_normal = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results1 = new QrReader().Read(scan_ML_and_normal);

// Use Machine Learning Scan - High Speed
QrImageInput scan_ML_only = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results2 = new QrReader().Read(scan_ML_only);

// Use Scan without Machine Learning
QrImageInput scan_normal_only = new QrImageInput(inputBmp, QrScanMode.OnlyBasicScan);
IEnumerable<QrResult> results3 = new QrReader().Read(scan_normal_only);

// Import necessary namespaces
using IronQr;
using IronSoftware.Drawing;
using IronQr.Enum;
using System.Collections.Generic;

// Load an image file as a bitmap
var inputBmp = AnyBitmap.FromFile("QrImage.png");

// Use Auto => Machine Learning Scan
QrImageInput scan_ML_and_normal = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results1 = new QrReader().Read(scan_ML_and_normal);

// Use Machine Learning Scan - High Speed
QrImageInput scan_ML_only = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results2 = new QrReader().Read(scan_ML_only);

// Use Scan without Machine Learning
QrImageInput scan_normal_only = new QrImageInput(inputBmp, QrScanMode.OnlyBasicScan);
IEnumerable<QrResult> results3 = new QrReader().Read(scan_normal_only);

' Import necessary namespaces
Imports IronQr
Imports IronSoftware.Drawing
Imports IronQr.Enum
Imports System.Collections.Generic

' Load an image file as a bitmap
Private inputBmp = AnyBitmap.FromFile("QrImage.png")

' Use Auto => Machine Learning Scan
Private scan_ML_and_normal As New QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel)
Private results1 As IEnumerable(Of QrResult) = (New QrReader()).Read(scan_ML_and_normal)

' Use Machine Learning Scan - High Speed
Private scan_ML_only As New QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel)
Private results2 As IEnumerable(Of QrResult) = (New QrReader()).Read(scan_ML_only)

' Use Scan without Machine Learning
Private scan_normal_only As New QrImageInput(inputBmp, QrScanMode.OnlyBasicScan)
Private results3 As IEnumerable(Of QrResult) = (New QrReader()).Read(scan_normal_only)

En son ML teknolojisinden yararlanarak, QR kodu okuyucusunu yeni zirvelere taşıdık. Karmaşık koşullar altında bile QR kodlarını çözmede uygulamaların doğruluğunu ve verimliliğini artıran sofistike ML modeli. Durağan görüntülerden, video akışlarından veya canlı kamera beslemelerinden QR kodlarını okuma ister, ML destekli çözüm gereken bilgiyi hızlı ve güvenilir bir şekilde sağlar. Bu yenilik, veri alımını daha sorunsuz hale getirir ve potansiyel tehditleri işaret ederek gerçek QR kodlarını tanıyarak güvenliği artırır. ML teknolojimizle, QR kodu tarama yeteneklerinizin öncü olduğundan emin olarak, kullanıcılarınıza sorunsuz ve güvenli bir deneyim sunar.

Lisans (Deneme Mevcuttur)

Geliştiriciler buradan IronQR deneme lisansı alabilirler. Anahtar appSettings.json içine yerleştirilmelidir.

{
  "IronQr.License.LicenseKey": "My Key"
}

Sonuç

Bu makalede, IronQR kullanarak ASP.NET Core'da QR kodlarının nasıl taranacağını inceledik. QR kodu tarama özelliği eklemeyi kolaylaştırarak web uygulamalarının etkileşimli ve kullanıcı dostu olması için bir ASP.NET uygulamasına IronQR'yi entegre etmek kolay bir işlemdir. IronQR'nin güçlü özellikleri ve kullanım kolaylığı, barkodla ilgili işlevsellikleri uygulamak isteyen geliştiriciler için mükemmel bir seçimdir.