QR Kodu .NET Core: C#'ta QR Kodları Okuyun ve Oluşturun

QR Kod Kütüphanesi Nasıl Yüklenir?

IronQR'yi NuGet ile yüklemek saniyeler alır. Visual Studio'yu açın, Tools > NuGet Package Manager > Manage NuGet Packages for Solution bölümüne gidin, IronQR'yi arayın ve Install'a tıklayın. Paket, minimal bağımlılıklara sahiptir ve kutudan çıktığı gibi Windows, macOS ve Linux'u hedeflemektedir.

Install-Package IronQR

IronQR, .NET Core 6, 7, 8, 9 ve 10 yanı sıra .NET Framework 4.6.2 ve sonrası sürümleri hedefler. Çapraz platform projeleri için, SkiaSharp entegrasyonu, Windows dışı çalışma zamanlarında görüntü işleme işlemlerini yönetir. Kütüphane, ASP.NET Core web uygulamaları, konsol uygulamaları ve masaüstü çözümleri ile ek bir çalışma zamanı yapılandırması gerektirmeden çalışır. Kurulumdan sonra, tüm gerekli genişletme yöntemleri ve türleri hemen kullanılabilir hale gelir.

Bir Resimden Temel bir QR Kodunu Nasıl Okursunuz?

Görüntü dosyalarından QR kod verilerini okumak sadece birkaç satır kod gerektirir. QrReader sınıfı, resim kalitesini değerlendiren ve doğru segment modunu otomatik olarak seçen gelişmiş bir makine öğrenim modeli kullanır, bu da giriş resmi ideal olmasa bile size doğru sonuçlar verir.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

Imports IronQr
Imports IronSoftware.Drawing

' Load image containing QR code
Dim inputBmp = AnyBitmap.FromFile("qr-sample.png")
' Create QrImageInput from the bitmap
Dim imageInput As New QrImageInput(inputBmp)
' Initialize QR Reader with ML model
Dim reader As New QrReader()
' Read and decode all QR codes in the image
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)
' Output decoded text strings
For Each qrCode In results
    Console.WriteLine($"QR Code Value: {qrCode.Value}")
    Console.WriteLine($"URL: {qrCode.Url}")
Next

Gelişmiş QR Kodu Verilerini Nasıl Çıkartırsınız?

IronQR, temel değer kod çözmenin ötesinde, her taranan sembolden koordinatlar, ham veri segmentleri ve modül seviyesinde bilgileri ortaya çıkarır. Bu, bir QR kodunun sayfada tam olarak nerede göründüğünü bilmeniz gereken belge işleme iş akışları veya tek bir görüntüde birden fazla kodu ele alması gereken uygulamalar için esastır.

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

Imports IronQr
Imports IronSoftware.Drawing

Dim inputBmp = AnyBitmap.FromFile("document-with-qr.png")
Dim imageInput As New QrImageInput(inputBmp)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

For Each qrCode In results
    ' Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}")
    ' Get corner coordinate positions
    For Each point As PointF In qrCode.Points
        Console.WriteLine($"Position: {point.X}, {point.Y}")
    Next
Next

Hata Düzeltme Seviyeleri QR Kod Kalitesini Nasıl Etkiler?

Hata düzeltme, bir QR tarayıcının kodun bir kısmı örtüldüğünde, kötü yazdırıldığında veya fiziksel olarak zarar gördüğünde bile orijinal verileri kurtarmasını sağlayan mekanizmadır. QR Kod standardı, her biri depolama kapasitesini hasar toleransına karşı takas eden dört seviyeyi tanımlar -- Düşük (L), Orta (M), Çeyrek (Q) ve Yüksek (H).

QR kodları oluştururken, daha yüksek bir hata düzeltme seviyesi belirtmek, çıktıların gerçek tarama koşullarında dayanıklılığını sağlar:

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Uluslararası Karakterlerle QR Kodları Nasıl Oluşturursunuz?

IronQR, tam kapsamlı QR kodlama modlarını destekler: sayısal, alfasayısal, byte ve Kanji. Japonca metin ve diğer Unicode içeriği için, kütüphane en yerden/verimli kodlamayı otomatik olarak seçer:

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Generate QR that encodes Japanese Unicode text
Dim japaneseQr As QrCode = QrWriter.Write("こんにちは世界")
' The library selects Kanji mode automatically
Dim qrImage As AnyBitmap = japaneseQr.Save()
qrImage.SaveAs("japanese-qr.png")

Yapılandırılmış QR Verileri İçin Yük Üreteçleri Nasıl Kullanılır?

Düz bir URL'yi kodlayan bir QR kodu basit bağlantı paylaşımı için işe yarar, ancak birçok uygulama, yapılandırılmış verileri kodlamaya ihtiyaç duyar -- WiFi kimlik bilgileri, vCard formatında iletişim kartları veya etkinlik verileri. Bu yükleri elle biçimlendirmek hataya açıktır; Eksik bir noktalı virgül veya hatalı alan sırası, tarayıcıların veriyi yanlış yorumlamasına neden olacaktır.

IronQR, bu yapılandırılmış dizeleri doğru bir şekilde oluşturan yük yardımcıları sağlar:

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

Imports IronQr
Imports IronSoftware.Drawing

' Generate QR code with URL payload
Dim urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")
' Save QR as PNG image file
Dim qrImage As AnyBitmap = urlQrCode.Save()
qrImage.SaveAs("url-qr-code.png")
Console.WriteLine("QR code generated successfully.")

QR Kodu Görünümünü Nasıl Özelleştirirsiniz?

IronQR, üretilen kodların görsel görünümü üzerinde kontrol sahibi olmanızı sağlayarak taranabilirlikten ödün vermez. Ön plan ve arka plan renklerini değiştirebilir, özel markalama uygulayabilir veya bir logoyu merkezin sessiz bölgesine yerleştirebilirsiniz.

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Define custom colors for the QR code
Dim darkColor As Color = Color.FromArgb(30, 30, 120) ' Deep navy foreground
Dim lightColor As Color = Color.White

Dim options As New QrOptions(QrErrorCorrectionLevel.High, maxVersion:=20) With {
    .BackgroundColor = lightColor,
    .Color = darkColor,
    ' Embed a logo image into the QR center
    .Logo = AnyBitmap.FromFile("logo.png")
}

Dim styledQr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options)
Dim output As AnyBitmap = styledQr.Save()
output.SaveAs("branded-qr.png")

Bir logoyu gömmek, etkin veri alanını azaltır, bu nedenle kütüphane, bir logo sağlandığında hata düzeltme seviyesiHgerektirir. Merkezdeki ayrılmış sessiz bölge,Hseviyesinin geri kazanım kapasitesi dahilinde olan kod yüzeyinin yaklaşık %30'unu kapsar. Kütüphane, bu kısıtlamayı otomatik olarak uygular -- eğer bir logo ile birlikte düşük bir hata düzeltme seviyesi ayarlarsanız, IronQR hatalı taranan bir kod üretmek yerine açıklayıcı bir mesajla bir istisna oluşturur.

ASP.NET Core uygulamaları için, ASP.NET Core QR kodu oluşturma eğitimi, oluşturulan QR kodlarını bir controller action'dan resim cevabı olarak nasıl sunabileceğinizi gösterir. Çıkış akışı, yanıtı doğrudan ara dosya I/O olmadan yazar ve bu, yüksek trafikli uç noktalar için gecikmeyi düşük tutar.

ASP.NET Core Uygulamasında QR Kodları Nasıl Okursunuz?

Yüklenen resimlerden, belge işleme hatlarından veya otomatik denetim sistemlerinden sunucu tarafında QR kodları taramak, okuma API'sinin yaygın bir kullanım durumudur. ASP.NET QR kodu tarayıcı kılavuzu, tam denetleyici ve servis kurulumunu kapsar, ancak çekirdek okuma deseni, bir konsol uygulamasıyla aynıdır:

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/qr")>
Public Class QrScanController
    Inherits ControllerBase

    <HttpPost("scan")>
    Public Function Scan(imageFile As IFormFile) As IActionResult
        Using stream = imageFile.OpenReadStream()
            Dim bitmap = AnyBitmap.FromStream(stream)
            Dim imageInput = New QrImageInput(bitmap)
            Dim reader = New QrReader()
            Dim results = reader.Read(imageInput)

            Dim decoded = results.Select(Function(r) New With {Key .Value = r.Value, Key .Url = r.Url}).ToList()
            Return Ok(decoded)
        End Using
    End Function
End Class

AnyBitmap.FromStream() yöntemi, herhangi bir okunabilir akışı kabul eder, bu nedenle aynı kod yolu bir form üzerinden yüklenen dosyalar, blob depolamasından alınan resimler veya bir video hattından çıkarılan kareler için çalışır. Denetleyici, dosya sisteminin yalnızca okunabilir olabileceği konteynere alınmış dağıtımlarda önem taşıyan diske herhangi bir geçici dosya yazmaz.

Yüksek veri işleme kapasiteli senaryolar için, uygulama ömrü başına bir kez QrReader oluşturun, çünkü makine öğrenim modeli yükleme maliyeti ilk oluşturulmada ödenir. Aynı örnek üzerinde yapılan sonraki Read() çağrıları, iş parçacığı güvenliğindedir ve yüklenmiş modeli paylaşır.

.NET MAUI Uygulamasında QR Kodları Nasıl Oluşturulur?

.NET MAUI QR kod öğreticisi, iOS, Android, macOS ve Windows üzerinde tam çapraz platform üretimini göstermektedir. IronQR, Windows dışı platformlarda çalışırken SkiaSharp render arka planını kullanır ve tüm MAUI hedeflerinde tutarlı çıktı sunar.

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

Imports IronQr
Imports IronSoftware.Drawing

' Generate QR and convert to a byte array for display in MAUI
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")
Dim bitmap As AnyBitmap = qr.Save()
Dim imageBytes As Byte() = bitmap.ExportBytes()

' Bind imageBytes to an <Image Source> in your MAUI page

Mobil hedeflerde, ExportBytes(), doğrudan bir StreamImageSource içine besleyebileceğiniz veya bir ImageButton'e yazabileceğiniz bir PNG bayt dizisi döndürür. MAUI iskeleti, platforma özel kod yolları gerektirmez -- aynı üretim mantığı, dört MAUI hedefinin tümünde aynı şekilde çalışır.

VB.NET projeleri için API yüzeyi aynıdır; sadece sözdizimi farklıdır. Kütüphane, ayrı bir VB.NET derlemesi gerektirmeyen tek bir NuGet paketi ile birlikte gelir.

Sonraki Adımlarınız Neler?

IronQR, .NET'te QR kodu yaşam döngüsünün tamamını kapsar - temel oluşturma ve yapılandırılmış yük kodlamasından, hasar görmüş veya markalı kodların makine öğrenimi destekli okunmasına kadar. Kütüphane, Kanji kodlaması, hata düzeltme yapılandırması ve platformlar arası görsel çıktıyı yönetir, böylece siz uygulamanızın özel mantığına odaklanabilirsiniz.

Öğrendiklerinizi pratiğe dökmek için:

• Okuma API'si ve sonuç işlemesi hakkında daha detaylı bilgi için C# QR kod okuyucu eğitimi inceleyin.
• Tam bir proje rehberliği için C# QR kodu oluşturucu uygulama öğreticisini inceleyin.
• Ek oluşturma ve okuma örüntülerini görmek için kod örneklerine göz atın.
• IronQR lisansı satın alarak tüm özelliklerin üretim dağıtımı için kilidini açın veya daha fazla değerlendirme süresine ihtiyacınız varsa ücretsiz denemeyi uzatın.