C#'de QR Kod Hata Mesajlarını Nasıl Yönetirim?

Updated: 9 Mayıs 2026

IronQR'nin hata yönetimi, okuma ve yazma hatalarını yakalamanıza, tanı koyma kayıtlarını almanıza ve her taramadan net sonuçlar elde etmenize yardımcı olur. Açık kontroller eklemezseniz, hem boş bir sonuç hem de bozuk bir dosya hiçbir şey döndürmeyecek ve yanlış gidenin ne olduğunu bilemeyeceksiniz. Hedeflenmiş istisna yönetimi ve tanı koyma kaydı ekleyerek, sessiz hataları faydalı geri bildirimlere dönüştürebilirsiniz. Bu kılavuz, boş sonuçları nasıl yöneteceğinizi, yazma zamanında oluşan istisnaları nasıl yöneteceğinizi ve toplu işlem için yapılandırılmış bir kayıt sarmalayıcısı nasıl oluşturacağınızı açıklar.

Hızlı Başlangıç: QR Kod Hatalarını Yönetin

QR okuma işlemlerini try-catch bloğunda sarın ve dosya ve kod çözme hataları için tanılama bilgilerini kaydedin.

1Install IronQR with NuGet Package Manager
PM > Install-Package IronQR
```
Install-Package IronQR
```

2Bu kod parçacığını kopyalayın ve çalıştırın.

using IronQr;
using IronSoftware.Drawing;

try
{
    var input = new QrImageInput(AnyBitmap.FromFile("label.png"));
    var results = new QrReader().Read(input);
    Console.WriteLine($"Found {results.Count()} QR code(s)");
}
catch (IOException ex)
{
    Console.Error.WriteLine($"File error: {ex.Message}");
}

using IronQr;
using IronSoftware.Drawing;

try
{
    var input = new QrImageInput(AnyBitmap.FromFile("label.png"));
    var results = new QrReader().Read(input);
    Console.WriteLine($"Found {results.Count()} QR code(s)");
}
catch (IOException ex)
{
    Console.Error.WriteLine($"File error: {ex.Message}");
}

3Canlı ortamınızda test için dağıtım yapın

Ücretsiz deneme ile bugün projenizde IronQR kullanmaya başlayın

Asgari İş Akışı (5 adım)

QR kod hatalarını yönetmek için IronQR C# kütüphanesini indirin
QR okuma/yazma aramalarını try-catch bloklarına sarın
Belirli hatalar için IOException ve ArgumentException yakalayın
Boş sonuçlar ve istisnalar için tanı koyma kayıtları alın
Gözlenebilirliğin iyileştirilmesi için yapılandırılmış JSON kaydını kullanın

Okuma Hatalarını ve Boş Sonuçları Yönetme

Tanı koyma kaydı olmadan, boş bir sonuç ve bozuk bir dosya çağıran kişiye aynı şekilde görünür. Aşağıdaki örnek, dosya erişim hatalarını algılar ve tarama sonuç döndürmezse uyarı verir.

Giriş

Bu QR örneği girişi diskte mevcuttur. Kullanıcının dosyayı alıp kod çözdüğü ve dosya yolunun yanlış olduğu senaryoları simüle edeceğiz.

using IronQr;
using IronSoftware.Drawing;

string filePath = "damaged-scan.png";

try
{
    // File-level failure throws IOException or FileNotFoundException
    var inputBmp = AnyBitmap.FromFile(filePath);
    var imageInput = new QrImageInput(inputBmp);

    var reader = new QrReader();
    IEnumerable<QrResult> results = reader.Read(imageInput);

    if (!results.Any())
    {
        // Not an exception — but a diagnostic event worth logging
        Console.Error.WriteLine($"[WARN] No QR codes found in: {filePath}");
        Console.Error.WriteLine($"  Action: Verify image quality or try a different scan");
    }
    else
    {
        foreach (QrResult result in results)
        {
            Console.WriteLine($"[{result.QrType}] {result.Value}");
        }
    }
}
catch (FileNotFoundException)
{
    Console.Error.WriteLine($"[ERROR] File not found: {filePath}");
}
catch (IOException ex)
{
    Console.Error.WriteLine($"[ERROR] Cannot read file: {filePath} — {ex.Message}");
}
catch (Exception ex)
{
    Console.Error.WriteLine($"[ERROR] Unexpected failure reading {filePath}: {ex.GetType().Name} — {ex.Message}");
}

using IronQr;
using IronSoftware.Drawing;

string filePath = "damaged-scan.png";

try
{
    // File-level failure throws IOException or FileNotFoundException
    var inputBmp = AnyBitmap.FromFile(filePath);
    var imageInput = new QrImageInput(inputBmp);

    var reader = new QrReader();
    IEnumerable<QrResult> results = reader.Read(imageInput);

    if (!results.Any())
    {
        // Not an exception — but a diagnostic event worth logging
        Console.Error.WriteLine($"[WARN] No QR codes found in: {filePath}");
        Console.Error.WriteLine($"  Action: Verify image quality or try a different scan");
    }
    else
    {
        foreach (QrResult result in results)
        {
            Console.WriteLine($"[{result.QrType}] {result.Value}");
        }
    }
}
catch (FileNotFoundException)
{
    Console.Error.WriteLine($"[ERROR] File not found: {filePath}");
}
catch (IOException ex)
{
    Console.Error.WriteLine($"[ERROR] Cannot read file: {filePath} — {ex.Message}");
}
catch (Exception ex)
{
    Console.Error.WriteLine($"[ERROR] Unexpected failure reading {filePath}: {ex.GetType().Name} — {ex.Message}");
}

Imports IronQr
Imports IronSoftware.Drawing

Module Module1
    Sub Main()
        Dim filePath As String = "damaged-scan.png"

        Try
            ' File-level failure throws IOException or FileNotFoundException
            Dim inputBmp = AnyBitmap.FromFile(filePath)
            Dim imageInput = New QrImageInput(inputBmp)

            Dim reader = New QrReader()
            Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

            If Not results.Any() Then
                ' Not an exception — but a diagnostic event worth logging
                Console.Error.WriteLine($"[WARN] No QR codes found in: {filePath}")
                Console.Error.WriteLine("  Action: Verify image quality or try a different scan")
            Else
                For Each result As QrResult In results
                    Console.WriteLine($"[{result.QrType}] {result.Value}")
                Next
            End If
        Catch ex As FileNotFoundException
            Console.Error.WriteLine($"[ERROR] File not found: {filePath}")
        Catch ex As IOException
            Console.Error.WriteLine($"[ERROR] Cannot read file: {filePath} — {ex.Message}")
        Catch ex As Exception
            Console.Error.WriteLine($"[ERROR] Unexpected failure reading {filePath}: {ex.GetType().Name} — {ex.Message}")
        End Try
    End Sub
End Module

Imports IronQr
Imports IronSoftware.Drawing

Module Module1
    Sub Main()
        Dim filePath As String = "damaged-scan.png"

        Try
            ' File-level failure throws IOException or FileNotFoundException
            Dim inputBmp = AnyBitmap.FromFile(filePath)
            Dim imageInput = New QrImageInput(inputBmp)

            Dim reader = New QrReader()
            Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

            If Not results.Any() Then
                ' Not an exception — but a diagnostic event worth logging
                Console.Error.WriteLine($"[WARN] No QR codes found in: {filePath}")
                Console.Error.WriteLine("  Action: Verify image quality or try a different scan")
            Else
                For Each result As QrResult In results
                    Console.WriteLine($"[{result.QrType}] {result.Value}")
                Next
            End If
        Catch ex As FileNotFoundException
            Console.Error.WriteLine($"[ERROR] File not found: {filePath}")
        Catch ex As IOException
            Console.Error.WriteLine($"[ERROR] Cannot read file: {filePath} — {ex.Message}")
        Catch ex As Exception
            Console.Error.WriteLine($"[ERROR] Unexpected failure reading {filePath}: {ex.GetType().Name} — {ex.Message}")
        End Try
    End Sub
End Module

Çıktı

Başarılı bir QR kod okuması için terminal çıkışı [QRCode] https://ironsoftware.com/qr/scan-1 gösteriyor

Lütfen dikkate alın: Başarılı bir okuma sadece QR kod değerini döndürecek, ancak çalışma sırasında bir hata oluşursa, aşağıda gösterilen istisna mesajı veya uyarıları gösterecektir.

Aşağıdaki konsol, boş sonuç durumunu için bir [WARN] ve eksik dosya için bir [ERROR] gösterir, her biri için dosya yolu ve önerilen bir işlem ile.

Damaged-scan.png içinde QR kodu bulunamadığı için WARN ve eksik-label.png için dosya bulunamadığı için HATA gösteren terminal çıkışı

Yazma Hatalarını Yönetme

QrWriter.Write 'a null geçirilmesi bir IronQrEncodingException tetikler. Konfigüre edilmiş hata düzeltme seviyesi için kapasiteyi aşan veriler de atar, çünkü daha yüksek düzeltme seviyeleri mevcut veri kapasitesini azaltır.

Giriş

Aşağıdaki iki giriş değişkeni, başarısızlık senaryolarını tanımlar: nullContent, null ve oversizedContent en yüksek düzeltme seviyesinde QR kapasitesini aşan 5000 karakterlik bir dizedir.

using IronQr;

string? content = null; // null throws IronQrEncodingException 
string oversizedContent = new string('A', 5000); // 5,000 chars exceeds QR capacity at Highest error correction level 

// Scenario 1: null input
try
{   
    QrCode qr = QrWriter.Write(content); // Input
}
catch (Exception ex)
{
    Console.Error.WriteLine($"[ERROR] Null content: {ex.GetType().Name} — {ex.Message}"); // Output
}

// Scenario 2: data exceeds QR capacity at the configured error correction level
try
{
    var options = new QrOptions(QrErrorCorrectionLevel.Highest);
    QrCode qr = QrWriter.Write(oversizedContent, options); // Input
}
catch (Exception ex)
{
    Console.Error.WriteLine($"[ERROR] QR capacity exceeded: {ex.Message}"); // Output
    Console.Error.WriteLine($"  Input length: {oversizedContent.Length} chars");
    Console.Error.WriteLine($"  Action: Reduce content or lower error correction level");
}

using IronQr;

string? content = null; // null throws IronQrEncodingException 
string oversizedContent = new string('A', 5000); // 5,000 chars exceeds QR capacity at Highest error correction level 

// Scenario 1: null input
try
{   
    QrCode qr = QrWriter.Write(content); // Input
}
catch (Exception ex)
{
    Console.Error.WriteLine($"[ERROR] Null content: {ex.GetType().Name} — {ex.Message}"); // Output
}

// Scenario 2: data exceeds QR capacity at the configured error correction level
try
{
    var options = new QrOptions(QrErrorCorrectionLevel.Highest);
    QrCode qr = QrWriter.Write(oversizedContent, options); // Input
}
catch (Exception ex)
{
    Console.Error.WriteLine($"[ERROR] QR capacity exceeded: {ex.Message}"); // Output
    Console.Error.WriteLine($"  Input length: {oversizedContent.Length} chars");
    Console.Error.WriteLine($"  Action: Reduce content or lower error correction level");
}

Imports IronQr

Dim content As String = Nothing ' Nothing throws IronQrEncodingException 
Dim oversizedContent As String = New String("A"c, 5000) ' 5,000 chars exceeds QR capacity at Highest error correction level 

' Scenario 1: null input
Try
    Dim qr As QrCode = QrWriter.Write(content) ' Input
Catch ex As Exception
    Console.Error.WriteLine($"[ERROR] Null content: {ex.GetType().Name} — {ex.Message}") ' Output
End Try

' Scenario 2: data exceeds QR capacity at the configured error correction level
Try
    Dim options As New QrOptions(QrErrorCorrectionLevel.Highest)
    Dim qr As QrCode = QrWriter.Write(oversizedContent, options) ' Input
Catch ex As Exception
    Console.Error.WriteLine($"[ERROR] QR capacity exceeded: {ex.Message}") ' Output
    Console.Error.WriteLine($"  Input length: {oversizedContent.Length} chars")
    Console.Error.WriteLine("  Action: Reduce content or lower error correction level")
End Try

Imports IronQr

Dim content As String = Nothing ' Nothing throws IronQrEncodingException 
Dim oversizedContent As String = New String("A"c, 5000) ' 5,000 chars exceeds QR capacity at Highest error correction level 

' Scenario 1: null input
Try
    Dim qr As QrCode = QrWriter.Write(content) ' Input
Catch ex As Exception
    Console.Error.WriteLine($"[ERROR] Null content: {ex.GetType().Name} — {ex.Message}") ' Output
End Try

' Scenario 2: data exceeds QR capacity at the configured error correction level
Try
    Dim options As New QrOptions(QrErrorCorrectionLevel.Highest)
    Dim qr As QrCode = QrWriter.Write(oversizedContent, options) ' Input
Catch ex As Exception
    Console.Error.WriteLine($"[ERROR] QR capacity exceeded: {ex.Message}") ' Output
    Console.Error.WriteLine($"  Input length: {oversizedContent.Length} chars")
    Console.Error.WriteLine("  Action: Reduce content or lower error correction level")
End Try

Çıktı

Konsol her iki hata senaryosu için istisna türünü ve mesajını gösterir.

Null içerik QrWriter.Write'a geçtiğinde IronQrEncodingException gösteren terminal çıkışı

Girdi uzunluğunu, içerik kısaltılması veya daha düşük bir düzeltme seviyesi gerekip gerekmediğini belirlemek için istisna mesajıyla günlükleyin. Kullanıcı girdisi için, istisna yükünü azaltmak ve tanı koymayı geliştirmek amacıyla kodlamadan önce dizge uzunluğunu doğrulayın ve null değerleri kontrol edin.

QR Kod İşlemlerini Kayıt Altına Alma

Dahili tanılama bilgilerini yakalamak için IronSoftware.Logger kullanın. Her okuma işlemi için, dosya yolu, sonuç sayısı ve geçen zamanı JSON olarak kaydeden bir yardımcı fonksiyon uygulayarak tüm toplu işlem için net bir çıktı sağlayın.

Giriş

Paket, qr-scans/'dan dört geçerli QR kodu görüntüsü ve geçersiz baytlarla bir beşinci dosya, scan-05-broken.png içerir.

https://ironsoftware.com/qr/scan-1 adresini kodlayan QR kodu

Tarama 1

https://ironsoftware.com/qr/scan-2 adresini kodlayan QR kodu

Tarama 2

https://ironsoftware.com/qr/scan-3 adresini kodlayan QR kodu

Tarama 3

https://ironsoftware.com/qr/scan-4 adresini kodlayan QR kodu

Tarama 4

using IronQr;
using IronSoftware.Drawing;
using System.Diagnostics;

// Enable shared Iron Software logging for internal diagnostics
IronQr.Logging.Logger.LoggingMode = IronQr.Logging.Logger.LoggingModes.All;
IronQr.Logging.Logger.LogFilePath = "ironqr-debug.log";

// Reusable wrapper for structured observability
(IEnumerable<QrResult> Results, bool Success, string Error) ReadQrWithDiagnostics(string filePath)
{
    var sw = Stopwatch.StartNew();
    try
    {
        var input = new QrImageInput(AnyBitmap.FromFile(filePath));
        var results = new QrReader().Read(input).ToList();
        sw.Stop();

        Console.WriteLine($"{{\"op\":\"qr_read\",\"file\":\"{Path.GetFileName(filePath)}\","
            + $"\"status\":\"ok\",\"count\":{results.Count},\"ms\":{sw.ElapsedMilliseconds}}}");

        return (results, true, null);
    }
    catch (Exception ex)
    {
        sw.Stop();
        string error = $"{ex.GetType().Name}: {ex.Message}";

        Console.Error.WriteLine($"{{\"op\":\"qr_read\",\"file\":\"{Path.GetFileName(filePath)}\","
            + $"\"status\":\"error\",\"exception\":\"{ex.GetType().Name}\","
            + $"\"message\":\"{ex.Message}\",\"ms\":{sw.ElapsedMilliseconds}}}");

        return (Enumerable.Empty<QrResult>(), false, error);
    }
}

// Usage: process a batch with per-file isolation
string[] files = Directory.GetFiles("qr-scans/", "*.png");
int ok = 0, fail = 0;

foreach (string file in files)
{
    var (results, success, error) = ReadQrWithDiagnostics(file);
    if (success && results.Any()) ok++;
    else fail++;
}

Console.WriteLine($"\nBatch complete: {ok} success, {fail} failed/empty out of {files.Length} files");

using IronQr;
using IronSoftware.Drawing;
using System.Diagnostics;

// Enable shared Iron Software logging for internal diagnostics
IronQr.Logging.Logger.LoggingMode = IronQr.Logging.Logger.LoggingModes.All;
IronQr.Logging.Logger.LogFilePath = "ironqr-debug.log";

// Reusable wrapper for structured observability
(IEnumerable<QrResult> Results, bool Success, string Error) ReadQrWithDiagnostics(string filePath)
{
    var sw = Stopwatch.StartNew();
    try
    {
        var input = new QrImageInput(AnyBitmap.FromFile(filePath));
        var results = new QrReader().Read(input).ToList();
        sw.Stop();

        Console.WriteLine($"{{\"op\":\"qr_read\",\"file\":\"{Path.GetFileName(filePath)}\","
            + $"\"status\":\"ok\",\"count\":{results.Count},\"ms\":{sw.ElapsedMilliseconds}}}");

        return (results, true, null);
    }
    catch (Exception ex)
    {
        sw.Stop();
        string error = $"{ex.GetType().Name}: {ex.Message}";

        Console.Error.WriteLine($"{{\"op\":\"qr_read\",\"file\":\"{Path.GetFileName(filePath)}\","
            + $"\"status\":\"error\",\"exception\":\"{ex.GetType().Name}\","
            + $"\"message\":\"{ex.Message}\",\"ms\":{sw.ElapsedMilliseconds}}}");

        return (Enumerable.Empty<QrResult>(), false, error);
    }
}

// Usage: process a batch with per-file isolation
string[] files = Directory.GetFiles("qr-scans/", "*.png");
int ok = 0, fail = 0;

foreach (string file in files)
{
    var (results, success, error) = ReadQrWithDiagnostics(file);
    if (success && results.Any()) ok++;
    else fail++;
}

Console.WriteLine($"\nBatch complete: {ok} success, {fail} failed/empty out of {files.Length} files");

Çıktı

Konsol, her dosya için JSON günlük satırlarını gösterir: dört başarılı okuma ve kırık dosya için bir yapılandırılmış hata girişi, ardından toplu işlem özetini. IronSoftware.Logger, aynı anda IronQR-debug.log'ya dahili tanılama bilgilerini yazar. Tam hata ayıklama günlüğünü buradan indirebilirsiniz.

4 başarılı okuma ve 1 hatayı gösteren JSON yapılandırılmış günlük satırları ve toplu işlem tamamlanma özeti gösteren terminal çıkışı

JSON çıktısı doğrudan log toplama araçlarına beslenir: kap container tabanlı bir dağıtımda Fluentd, Datadog veya CloudWatch'a stdout iletir. ms alanı gecikme gerilemelerini ortaya çıkarır ve hata ayıklama günlüğü, sarmalayıcının yaptığı iç işlemleri kaydeder.

Daha Fazla Okuma

Hata Düzeltme Seviyeleri: Kodlama düzeyinde QR sağlamlığını ayarlayın.
QR Kodlarını Okuma Nasıl Yapılır: uçtan uca okuma rehberi.
QR Kod Üretici Eğitimi: stilizasyon ve logolarla üretim.
QrReader API Referansı: yöntem imzaları ve açıklamalar.
QrWriter API Reference: all Write overloads.

Üretime hazır olduğunuzda lisanslama seçeneklerini görüntüleyin.

Tam DetailedErrorMessagesTest konsol uygulama projesini indirmek için buraya tıklayın.

Sıkça Sorulan Sorular

C#'de QR kodu okuma/yazma işlemlerini nasıl hata ayıklayabilirim?

IronQR kullanarak C#'de QR kodu okuma/yazma işlemlerini hata ayıklayabilirsiniz, istisnaları yakalayarak, tanılamaları kaydederek ve yapılandırılmış çıktı ile toplu işlem izleyerek.

QR kodlarını C#'de işlerken bir hata ile karşılaşırsam ne yapmalıyım?

C#'de QR kodlarını işlerken bir hata ile karşılaşırsanız, IronQR kullanarak istisnaları yakalayın ve yönetin. Bu, sorunları etkili bir şekilde tanımlamanıza ve çözmenize olanak tanır.

IronQR, QR kodu toplu işlemlerini izlemeye nasıl yardımcı olur?

IronQR, QR kodu toplu işlemlerini izlemek için yapılandırılmış çıktı sağlayarak, süreç sırasında herhangi bir hata veya verimsizlik durumunu tanımlamanıza ve çözmenize yardımcı olur.

IronQR, QR kodu işlemleri için tanılamaları kaydedebilir mi?

Evet, IronQR, C# uygulamalarınızdaki performansı ve hataları izlemek ve analiz etmek için QR kodu işlemleri için tanılamaları kaydedebilir.

IronQR ile QR kodu işlemede yaygın istisnalar nelerdir?

IronQR ile QR kodu işlemede yaygın istisnalar, okunamayan QR kodları ve yanlış format yönetimiyle ilgili sorunları içerir ve bu sorunlar C# kodunuzda doğru istisna yönetimi ile yönetilebilir.

How can I improve error detection during QR code processing with IronQR?

Improve error detection by implementing logging that captures detailed information on file paths, operation status, result counts, and execution time. This data supports easier debugging and system observability.

Can IronQR's logging output be integrated with log aggregation tools?

Yes, the JSON output from IronQR can be fed directly into log aggregation tools such as Fluentd, Datadog, or CloudWatch, making it suitable for containerized deployments and enhancing monitoring capabilities.

What approach does IronQR suggest for handling batch QR code operations?

IronQR recommends processing each file in isolation, logging the results for each read operation to help identify errors, and providing a complete batch summary that tallies successes and failures.

How does IronQR assist in diagnosing file-level failures during QR code scans?

IronQR detects file-level failures like IOException and FileNotFoundException, providing descriptive error messages which can be logged to pinpoint issues such as incorrect file paths or unreadable files.

Why is it important to wrap QR read/write calls in try-catch blocks?

Wrapping read/write operations in try-catch blocks ensures that failures do not crash the application, allowing you to handle exceptions gracefully, log necessary diagnostics, and guide the user with useful messages.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...

Daha Fazla Oku