1. IronBarcode
  2. Nasıl Yapılır
  3. Hata Düzeltmeyi Ayarlayın
C# ile Hata Düzeltmeyi Nasıl Ayarlanır | IronQR

Hata Düzeltmeyi C#'de Nasıl Ayarlarım

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

C# barkodlarında hata düzeltme, IronBarcode'un QRCodeWriter.CreateQrCode metodunda QrErrorCorrectionLevel parametresi kullanılarak ayarlanır, dört seviyeyi destekler (L, M, Q, H) ve zarar görmüş verilerin %7-30'unu kurtarabilir, daha yüksek seviyeler daha karmaşık QR kodları oluşturur.

Hata Düzeltme, görsel kusurlar veya kodlama hatalarına rağmen barkod okunabilirliğini sürdürme yeteneğini ifade eder. Bu zararlar baskı kusurları, leke, çizikler veya tarama koşullarındaki değişiklikler gibi faktörlerden kaynaklanabilir. Hata düzeltme, özellikle C#'de QR kodları ile çalışırken hangi tür barkod kodlamasının uygun olduğunu belirlemede önemli bir faktördür.

Genel olarak, 2D barkodlar, aşağıdaki faktörler nedeniyle 1D barkodlara göre kusurlara daha fazla toleransa sahiptir:

  • Veri Kapasitesi: 2D barkodlar, hem yatay hem de dikey olarak şifreleyerek 1D barkodlardan daha fazla veri depolar. Daha fazla bilgi için desteklenen barkod formatları hakkında bilgi edinin.
  • Yedeklilik: 2D barkodlar, barkodun bir parçası hasar görse bile kalan sağlam bölümlerden bilgi çıkarımı sağlayan birden fazla veri katmanına sahiptir.
  • Kompaktlık: 2D barkodlar kompakt şekillerinden dolayı sınırlı alanlar için uygundur.
  • Esneklik: 2D barkodlar, çeşitli açılar ve yönlerden taranabilir.

Hata düzeltme, kusurlu barkodlar ve görüntü düzeltme senaryoları ile uğraşırken tarama koşulları ideal olmadığında özellikle önem kazanır.

Hızlı Başlangıç: QR Kod Oluşturma'da Hata Düzeltme Seviyesini Kullanma

Bu kısa örnek, IronBarcode ile orta hata düzeltme seviyesini ayarlayarak bir QR kodu oluşturmayı gösterir. Geliştiriciler CreateQrCode metodunu içerik, boyut ve hata düzeltme seviyesi ile kullanabilir.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/BarCode yükleyin

    PM > Install-Package BarCode

  2. Bu kod parçasını kopyalayıp çalıştırın.

    var qr = IronBarCode.QRCodeWriter.CreateQrCode("https://ironsoftware.com", 500, IronBarCode.QRCodeWriter.QrErrorCorrectionLevel.Medium).SaveAsPng("qr.png");

  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronBarcode kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Minimal İş Akışı (5 Adımda)

  1. Barkodlarda hata düzeltmeyi ayarlamak için C# kütüphanesini indirin
  2. QR kodu oluşturmak için QRCodeWriter sınıfını kullanın
  3. Hata düzeltme seviyesini ayarlamak için QrErrorCorrection parametresini değiştirin
  4. Dört farklı hata düzeltme seviyesinde görsel olarak üretilen QR kodlarını karşılaştırın
  5. Çıkış QR kodlarını inceleyin


QR Kodlarında Hata Düzeltmeyi Nasıl Ayarlarım?

Şu anda IronBarcode, geniş kapsamlı barkod oluşturma özelliklerinin bir parçası olarak QR Kodlar, Micro QRlar ve rMQRs'de hata düzeltme ayarlarını destekler. Bu, QR kodu standartları tarafından belirlenen dört önceden ayarlanmış hata düzeltme seviyesinin tümünü destekler. The error correction level is adjusted via the QrErrorCorrectionLevel parameter in the QRCodeWriter.CreateQrCode method. Hata düzeltmenin dört seviyesi şunlardır:

  • En Yüksek: Seviye H. Verilerin %30'una kadarını kurtarabilir.
  • Yüksek: Seviye Q. Verilerin %25 kadarini kurtarabilir.
  • Orta: Seviye M. Verilerin %15 kadarini kurtarabilir.
  • Düşük: Seviye L. Verilerin %7 kadarini kurtarabilir.

Daha yüksek hata düzeltme seviyeleri, daha karmaşık QR kodu görüntüleri ile sonuçlanır ve QR kodları oluştururken görsel netlik ile hata düzeltme arasında bir denge gerektirir. Aşağıdaki kod örneği hata düzeltmenin ayarlanmasını göstermektedir:

:path=/static-assets/barcode/content-code-examples/how-to/set-error-correction.cs
// Import the necessary namespace for barcode generation
using IronBarCode;

// Create a QR code with the specified URL, size, and error correction level
GeneratedBarcode mediumCorrection = QRCodeWriter.CreateQrCode(
    "https://ironsoftware.com/csharp/barcode/", // URL to be encoded in the QR code
    500,                                       // Size of the QR code (500x500 pixels)
    QRCodeWriter.QrErrorCorrectionLevel.Medium // Error correction level to handle distortions
);

// Save the generated QR code image as a PNG file with the specified filename
mediumCorrection.SaveAsPng("mediumCorrection.png");
' Import the necessary namespace for barcode generation
Imports IronBarCode

' Create a QR code with the specified URL, size, and error correction level
Private mediumCorrection As GeneratedBarcode = QRCodeWriter.CreateQrCode("https://ironsoftware.com/csharp/barcode/", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)

' Save the generated QR code image as a PNG file with the specified filename
mediumCorrection.SaveAsPng("mediumCorrection.png")
$vbLabelText   $csharpLabel

Hangi Hata Duzenleme Seviyesini Secmeliyim?

Hata düzeltme seviyesi seçimi, belirli kullanım durumunuza ve ortamınıza bağlıdır. QR kodlarının fiziksel hasara, kire veya kısmi örtülmelere maruz kalabileceği uygulamalar için yüksek hata düzeltme seviyeleri (Q veya H) önerilir. Bu seviyeler, QR kodunun karmaşıklığı ve büyüklüğü arttıkça daha iyi hata toleransı sağlar.

Dijital ekranlar veya yüksek kaliteli baskı gibi temiz, kontrollü ortamlar için daha düşük hata düzeltme seviyeleri (L veya M) yeterli olabilir. Bu seviyeler, daha basit ve daha az yoğun QR kodları üretir, ve bu kodlar daha küçük boyutlarda taranması daha kolaydır. Bu faktörleri dikkate alın:

  • Fiziksel Ortam: Dış mekan veya endüstriyel ortamlar daha yüksek hata düzeltmeden fayda sağlar
  • Baskı Kalitesi: Daha düşük kaliteli baskılar daha yüksek hata düzeltme gerektirir
  • Boyut Kısıtlamaları: Sınırlı alan okunabilirlik için daha düşük hata düzeltme gerektirebilir
  • Tarama Mesafesi: Daha uzun tarama mesafeleri daha basit QR kodları ile daha iyi çalışır

Farklı hata düzeltme seviyeleri ile QR kodları oluşturmayı karşılaştırmak için bir örnek:

using IronBarCode;
using System.Drawing;

// Generate QR codes with all four error correction levels
var content = "https://ironsoftware.com/csharp/barcode/";
int size = 500;

// Create QR codes with different error correction levels
var lowCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Low)</code>;
var mediumCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Medium)</code>;
var highCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.High)</code>;
var highestCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Highest)</code>;

// Save each with descriptive filenames
<code>lowCorrection.SaveAsPng("qr_low_correction.png")</code>;
<code>mediumCorrection.SaveAsPng("qr_medium_correction.png")</code>;
<code>highCorrection.SaveAsPng("qr_high_correction.png")</code>;
<code>highestCorrection.SaveAsPng("qr_highest_correction.png")</code>;
using IronBarCode;
using System.Drawing;

// Generate QR codes with all four error correction levels
var content = "https://ironsoftware.com/csharp/barcode/";
int size = 500;

// Create QR codes with different error correction levels
var lowCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Low)</code>;
var mediumCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Medium)</code>;
var highCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.High)</code>;
var highestCorrection = <code>QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Highest)</code>;

// Save each with descriptive filenames
<code>lowCorrection.SaveAsPng("qr_low_correction.png")</code>;
<code>mediumCorrection.SaveAsPng("qr_medium_correction.png")</code>;
<code>highCorrection.SaveAsPng("qr_high_correction.png")</code>;
<code>highestCorrection.SaveAsPng("qr_highest_correction.png")</code>;
Imports IronBarCode
Imports System.Drawing

' Generate QR codes with all four error correction levels
Dim content As String = "https://ironsoftware.com/csharp/barcode/"
Dim size As Integer = 500

' Create QR codes with different error correction levels
Dim lowCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Low)
Dim mediumCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Medium)
Dim highCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.High)
Dim highestCorrection = QRCodeWriter.CreateQrCode(content, size, QRCodeWriter.QrErrorCorrectionLevel.Highest)

' Save each with descriptive filenames
lowCorrection.SaveAsPng("qr_low_correction.png")
mediumCorrection.SaveAsPng("qr_medium_correction.png")
highCorrection.SaveAsPng("qr_high_correction.png")
highestCorrection.SaveAsPng("qr_highest_correction.png")
$vbLabelText   $csharpLabel

Hata Düzeltmeyi Kontrol Eden Parametreler Nelerdir?

The primary parameter controlling error correction in IronBarcode is the QrErrorCorrectionLevel enumeration. This parameter is passed to the CreateQrCode method and determines how much redundant data is embedded in the QR code. Özel QR kodları oluştururken, hata düzeltme ayarlarını diğer stil seçenekleri ile birleştirebilirsiniz:

using IronBarCode;

// Create a styled QR code with high error correction
var styledQr = <code>QRCodeWriter.CreateQrCode("Important Data", 500, QRCodeWriter.QrErrorCorrectionLevel.High)</code>;

// Apply custom styling
styledQr.ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SetMargins(10)
    .AddAnnotationTextAboveBarcode("Scan for Details");

// Export with various options
styledQr.SaveAsPng("styled_high_correction.png");
styledQr.SaveAsJpeg("styled_high_correction.jpg");
styledQr.SaveAsPdf("styled_high_correction.pdf");
using IronBarCode;

// Create a styled QR code with high error correction
var styledQr = <code>QRCodeWriter.CreateQrCode("Important Data", 500, QRCodeWriter.QrErrorCorrectionLevel.High)</code>;

// Apply custom styling
styledQr.ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SetMargins(10)
    .AddAnnotationTextAboveBarcode("Scan for Details");

// Export with various options
styledQr.SaveAsPng("styled_high_correction.png");
styledQr.SaveAsJpeg("styled_high_correction.jpg");
styledQr.SaveAsPdf("styled_high_correction.pdf");
Imports IronBarCode

' Create a styled QR code with high error correction
Dim styledQr = QRCodeWriter.CreateQrCode("Important Data", 500, QRCodeWriter.QrErrorCorrectionLevel.High)

' Apply custom styling
styledQr.ChangeBarCodeColor(System.Drawing.Color.DarkBlue) _
    .SetMargins(10) _
    .AddAnnotationTextAboveBarcode("Scan for Details")

' Export with various options
styledQr.SaveAsPng("styled_high_correction.png")
styledQr.SaveAsJpeg("styled_high_correction.jpg")
styledQr.SaveAsPdf("styled_high_correction.pdf")
$vbLabelText   $csharpLabel

Hata Düzeltme Neden QR Kodu Karmaşıklığını Etkiler?

Hata düzeltme, Reed–Solomon hata düzeltme algoritmaları kullanarak QR koduna yedek veri ekleyerek çalışır. Bu yedekleme, QR kodu okuyucusunun eksik veya hasarlı veri bölümlerini yeniden oluşturmasını sağlar. Daha fazla hata düzeltme eklendikçe, aynı bilgiyi kodlamak için daha fazla modül (siyah ve beyaz kareler) gerekir ve bu, daha yoğun, daha karmaşık bir desenle sonuçlanır.

Bu karmaşıklık barkod okuma ayarları ve tarama performansı için pratik sonuçlar doğurur. Daha yüksek hata düzeltme seviyeleri, en iyi performans için okuyucu ayarlarında ayarlamalar gerektirebilir.

Farklı Hata Düzeltme Seviyeleri Nelerdir?

Aşağıda, aynı değeri temsil eden ancak hata düzeltme seviyeleri değişken olan bir QR Kod görüntüleri örnek seti bulunmaktadır. Gözlemlendiği üzere, daha yüksek hata düzeltme seviyeleri, daha karmaşık QR kodu görüntüleri ile sonuçlanır, daha fazla hata toleransı sağlar.

QR code with highest error correction level showing dense pattern of black and white squares

En Yüksek Hata Düzeltme

QR code demonstrating high error correction level with dense data patterns and robust finder patterns

Yüksek Hata Düzeltme

QR code with medium error correction level showing clear data pattern and finder squares

Orta Hata Düzeltme

QR code with low error correction level showing standard black and white matrix pattern

Düşük Hata Düzeltme

Daha Yüksek Hata Düzeltmeyi Ne Zaman Kullanmalıyım?

Daha yüksek hata düzeltme seviyeleri çeşitli senaryolarda önerilir:

  1. Endüstriyel Uygulamalar: QR kodlarının sert koşullara maruz kalan ürünler veya ekipmanlar üzerinde kullanıldığı durumlar
  2. Dış Mekan Tabela: Dışmekanda hava koşullarına bağlı hasara maruz kalan QR kodları için
  3. Uzun Süreli Depolama: Yıllarca taranabilir kalması gereken belgeler veya ürünler
  4. Pazarlama Malzemeleri: QR kodunun kısmen gizlenen logolar veya tasarımlar içermesi durumunda

Birden fazla barkodun okunması veya hasarlı görüntülerin işlenmesi gibi ileri senaryolar için daha yüksek hata düzeltme, ek güvenilirlik sağlar.

Hata Düzeltme QR Kodu Boyutunu Nasıl Etkiler?

Hata düzeltme, QR kodlarının fiziksel boyutunu ve veri kapasitesini doğrudan etkiler. Daha yüksek hata düzeltme seviyeleri, aynı veri miktarını kodlamak için daha fazla modül gerektirir, bu da şu sonuçları doğurabilir:

  • Aynı veri içeriği için daha büyük QR kodları
  • Verilen bir QR kodu boyutunda azalmış maksimum veri kapasitesi
  • Küçük boyutlarda taranması daha zor olabilecek daha karmaşık desenler
  • Hem üretim hem de tarama için artan işlem süresi

Düzeltme Seviyeleri Arasındaki Görsel Farklar Nelerdir?

Aynı veriyi kodlayan QR kodları karşılaştırıldığında, hata düzeltme seviyeleri arasındaki görsel farklar belirgin hale gelir. Daha düşük düzeltme seviyeleri, daha az modülle basit desenler üretirken, daha yüksek seviyeler daha yoğun, daha karmaşık desenler oluşturur. Bu farklar sadece görünümü değil, aynı zamanda baskı ve görüntüleme için pratik değerlendirmeleri de etkiler.

İleri düzey barkod üretim teknikleri için kapsamlı dokümantasyonumuzu keşfedin ve hata düzeltmeyi diğer barkod özellikleri ile entegre ederek .NET uygulamalarınızda en iyi sonuçları almak için bilgi edinin.

Sıkça Sorulan Sorular

Barkod teknolojisinde hata düzeltme nedir?

Barkodlarda hata düzeltme, görsel kusurlar veya kodlama hatalarına rağmen barkod okunabilirliğini sürdürme yeteneğidir. IronBarcode, seçilen seviyeye bağlı olarak hasar görmüş verilerin %7-30'unu kurtarma imkanı sağlayan QrErrorCorrectionLevel parametresi aracılığıyla hata düzeltme sağlar.

C# dilinde QR kodları oluştururken hata düzeltme seviyelerini nasıl ayarlarım?

IronBarcode'un QRCodeWriter.CreateQrCode yöntemiyle QrErrorCorrectionLevel parametresini belirterek hata düzeltme seviyelerini ayarlayabilirsiniz. Yöntem, içerik, boyut ve dört hata düzeltme seviyesinden (L, M, Q, H) birini kabul eder.

QR kodları için mevcut dört hata düzeltme seviyesi nedir?

IronBarcode, QR kodları için dört önceden ayarlanmış hata düzeltme seviyesi destekler: L (Düşük - %7 kurtarma), M (Orta - %15 kurtarma), Q (Çeyrek - %25 kurtarma) ve H (Yüksek - %30 kurtarma). Daha yüksek seviyeler daha karmaşık QR kodlar oluşturur ancak daha iyi zarar direnci sunar.

Hangi barkod türleri hata düzeltme ayarlarını destekler?

Şu anda, IronBarcode QR Kodlar, Mikro QR'ler ve rMQR'ler için hata düzeltme seviyeleri ayarlamayı destekler. Bu 2D barkod formatları, geleneksel 1D barkodlara kıyasla üstün hata düzeltme yetenekleri sunar.

Neden 2D barkodlar 1D barkodlardan daha iyi hata düzeltme yeteneklerine sahiptir?

IronBarcode tarafından desteklenen 2D barkodlar, daha yüksek veri kapasitesi sayesinde (hem yatay hem de dikey olarak kodlama), sağlam bölümlerden veri çıkarılmasına izin veren yerleşik yedeklilik, sınırlı alanlar için uygun kompakt şekil ve çeşitli açılardan tarama esnekliği nedeniyle daha iyi hata düzeltme yeteneklerine sahiptir.

Daha yüksek hata düzeltme seviyelerini ne zaman kullanmalıyım?

Mükemmel olmayan baskı koşulları, potansiyel fiziksel zarar (çizik, leke), zorlayıcı tarama ortamlarıyla karşı karşıya kalındığında veya uzun ömürlü dayanıklılığın gerekli olduğu durumlarda IronBarcode ile daha yüksek hata düzeltme seviyelerini kullanın. Daha yüksek seviyeler daha güvenilir tarama sağlar ancak QR kodun karmaşıklığını artırır.

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  Mühendislik takımıyla şimdi sohbet edin
Yazılım Mühendisi
Tüm harika mühendisler gibi, Hairil de hevesli bir öğrenendir. C#, Python ve Java bilgilerini keskinleştiriyor ve bu bilgilerini, Iron Software ekibi genelinde takım üyelerine değer katmak için kullanıyor. Hairil, Malezya'daki Universiti Teknologi MARA'dan mezun olan Ek Kimya ve Süreç Mühendisliği ...
Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 2,169,908 | Sürüm: 2026.4 just released
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package BarCode
bir örnek çalıştırın dize barkod haline geldiğini görün.