IRONSOFTWAREHOME
IRONQR KULLANIMI

NuGet Paketi ile C#'ta QR Kodları Nasıl Oluşturulur

Curtis Chau
Curtis Chau
Updated: 21 Nisan 2026

.NET uygulamalarında QR kodlarını üretmek hiç bu kadar basit olmamıştı. Doğru NuGet paketiyle, QR kodları oluşturabilir, görünümlerini özelleştirebilir ve bunları birkaç satır kodla birden fazla çıktı formatına kaydedebilirsiniz. IronQR, .NET Core, .NET Framework ve .NET 5-10 için çapraz platform desteği ile kurumsal düzeyde QR kodu oluşturulması sağlar.

Bu öğretici, IronQR NuGet paketini nasıl kuracağınızı ve hemen QR kodları üretmeye nasıl başlayacağınızı gösterir. Envanter sistemleri, etkinlik biletleme platformları veya pazarlama uygulamaları oluşturuyor olun, IronQR profesyonel QR kodu uygulamaları için gereken araçları sağlar.

İlk Adım:
arrow pointer

Bir QR Kodu NuGet Paketi Nasıl Kurulur?

IronQR'yu NuGet Paket Yöneticisi aracılığıyla yüklemek saniyeler alır. Visual Studio içinde NuGet Paket Yöneticisi Konsolunu açın ve aşağıdaki komutu çalıştırın veya CLI ortamları için dotnet add package komutunu kullanın:

PM > Install-Package IronQR

NuGet paketi, hedef çerçevelerinizle uyumluluğu sağlamak için tüm bağımlılıkları otomatik olarak yönetir. IronQR, .NET Framework 4.6.2+, .NET Core 2.0+ ve .NET 5-10'u destekler, bu da onu herhangi bir Visual Studio projesi için çok yönlü bir kütüphane yapar.

Herhangi bir kod yazmadan önce bir ücretsiz deneme lisans anahtarına ihtiyacınız var. Uygulama başlatımında erken ayarlayın, böylece tüm sonraki çağrılar doğrulanır:

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Lisans anahtarı yerinde olduğunda, uygulamanız QR kodları oluşturmak, okumak ve özelleştirmek için hazırdır, çıktı resimlerinde filigran olmadan.

İlk QR Kodunuzu Nasıl Üretirsiniz?

İlk QR kodunuzu oluşturmak minimum kod gerektirir. QrWriter sınıfı, çoğu kullanım senaryosu için iyi çalışan mantıklı varsayılanlarla QR kodu oluşturmayı yönetir:

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

QR Kodu Çıkışı

NuGet QR Kod Oluşturucu: C# ile Sadece Birkaç Satır Kodda QR Kodları Oluşturun: Görsel 1 - Basit QR çıktısı

QrWriter.Write() yöntemi, string veriyi kabul eder ve QR sembolünü içeren bir QrCode nesnesi döndürür. Save() yöntemi bunu çeşitli resim formatlarına kodlamayı destekleyen veya bir XAML Yoluna vektör verisi olarak aktarmayı sağlayan bir AnyBitmap'e dönüştürür. Bu yaklaşım, platforma özgü bağımlılıklar olmadan Windows, macOS ve Linux'ta çalışır -- .NET 6 ile başlayarak yalnızca Windows'ta çalışan System.Drawing kütüphanelerinin aksine.

Yukarıdaki üç satırlık desen, en yaygın senaryoyu kapsar: bir dizeyi kodla, bir bitmap al, dosya yaz. Üretim kullanımı için, muhtemelen düz metin yerine URL dizeleri, ürün tanımlayıcıları veya JSON yükleri aktaracaksınız.

Doğru Hata Düzeltme Seviyesini Nasıl Seçersiniz?

QR kodları, bir kodun taranabilir kalırken ne kadar zarar görebileceğini belirleyen ISO/IEC 18004 QR kod standardında tanımlanan dört hata düzeltme seviyesini destekler. IronQR, QrOptions sınıfı üzerinden tüm dört seviyeyi destekler:

IronQR Tarafından Desteklenen QR Kodu Hata Düzeltme Seviyeleri
SeviyeKurtarma KapasitesiEn İyi İçin
L (Düşük)~%7Temiz ortamlar, maksimum veri yoğunluğu
M (Orta)~%15Genel kullanım (varsayılan)
Q (Dörtlü)~%25Endüstriyel uygulamalar
H (Yüksek)~%30Logolar, dış mekan tabelaları, kısmi örtüşmeler
using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionSeviye.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

Çıktı

NuGet QR Kod Oluşturucu: C# ile Sadece Birkaç Satır Kodda QR Kodları Oluşturun: Görsel 2 - Yüksek düzeltme seviyeli QR

Daha yüksek hata düzeltme seviyeleri, daha fazla ham modülle daha yoğun QR simgeleri oluşturur, kodun kısmen örtüşmüş veya zarar görmüş olsa bile okunabilir kalmasını sağlar. Ambalajlarda basılacak veya logolara gömülecek kodlar için Seviye H doğru seçimdir. Hasarın söz konusu olmadığı dijital özgün ekranlar için, Seviye M veri kapasitesini ve güvenilirliğini dengeler.

Yanlış seviyeyi seçmek, üretim ortamında tarama hatalarının yaygın bir kaynağıdır. QR kodlarınız fiziksel materyaller üzerinde görünecek veya kameralarla farklı mesafelerde olacaksa, Seviye Q veya H kullanın ve dağıtmadan önce çıktıyı birden fazla tarayıcı uygulaması ile doğrulayın.

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

IronQR, özelleştirilmiş renkler, boyutlar, kenar boşlukları ve logo gömmeye olanak tanıyan QrStyleOptions ile geniş stil seçenekleri sunar. Markalı QR kodları, bilinen bir kimlik ile kodu görsel olarak ilişkilendirdikleri için pazarlama bağlamlarında daha iyi performans gösterir:

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

Stilize Edilmiş QR Çıkışı

NuGet QR Kod Oluşturucu: C# ile Sadece Birkaç Satır Kodda QR Kodları Oluşturun: Görsel 3 - Tarzlı QR Kodu

Dimensions özelliği, hem genişliği hem de yüksekliği piksel cinsinden ayarlar. Margins özelliği, tarayıcıların kod sınırını bulmak için kullandığı QR sembolünün etrafındaki beyaz çerçeve olan sessiz alanı kontrol eder. Önerilen 4 modüllük minimumun altına kenar boşluklarını azaltmak, eski cihazlarda tarama hatalarına neden olabilir.

QR kodlarına logolar eklemek, marka bilinirliğini artırır. Stil sistemi, logoları taranabilirliği koruyarak otomatik olarak yerleştirir - açık kaynak alternatiflerinin gerektirdiği manuel yerleştirme hesaplamalarına göre önemli bir avantaj sağlar.

QR Kodlarını Farklı Çıktı Formatlarına Nasıl Kaydedersiniz?

IronQR, PNG, JPEG, GIF, TIFF, BMP ve SVG dahil olmak üzere birden fazla çıktı formatını destekler. SaveAs yöntemi, formatı dosya uzantısından otomatik olarak algılar:

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

Çoklu QR Kodu Çıktı Formatları

NuGet QR Kod Oluşturucu: C# ile Sadece Birkaç Satır Kodda QR Kodları Oluşturun: Görsel 4 - Farklı dosya formatları olarak kaydedilen QR kodları

ExportBytes() yöntemi, özellikle diske yazmak zorunda kalmadan bir QR kodu resmini HTTP üzerinden geri döndürmeniz gereken web uygulamalarında faydalıdır. Bayt dizisini doğrudan yanıt akışına yazabilir veya isteğe bağlı olarak geri almak için bir veritabanı sütununda depolayabilirsiniz.

PDF belgelerine QR kodları eklemek için, IronQR, mevcut belgelere doğrudan QR kodu yerleştirmeyi sağlayan StampToExistingPdfPage yöntemini sunar. Bu, ek PDF kütüphaneleri olmadan yerel olarak çalışır, ki bu bağımlılık sayısını en aza indirmek istediğiniz mikro hizmet ortamlarında önemlidir.

IronQR NuGet Paketini QRCoder ile Nasıl Karşılaştırırsınız?

QRCoder kütüphanesi, .NET'te QR kodu üretmeyi sağlayan popüler bir açık kaynak seçeneğidir. QRCoder'ı kullanan geliştiriciler, QRCodeGenerator, QRCodeData ve PngByteQRCode gibi ayrı bir render sınıfı içeren çok aşamalı API'sine aşinadır. IronQR bunu tek bir QrWriter.Write() çağrısına indirger.

.NET Geliştiricileri için IronQR ve QRCoder Özellik Karşılaştırması
ÖzellikIronQRQRCoder
Çapraz Platform OluşturmaTam .NET 5-10 desteğiBitmap oluşturma için yalnızca Windows
ML Kontrollü Okuma%99.9 doğruluk oranı ile tespitSadece üretim, okuma yok
PDF EntegrasyonuYerel damgalama desteğiEk kütüphaneler gerektirir
Ticari Destek24/5 mühendislik desteğiYalnızca topluluk
Logo EklemeDahili, otomatik konumlandırılmışManuel kaplama gerekli

QRCoder, Windows ortamlarında temel oluşturma işlemlerinde iyi çalışır. IronQR'nin makine öğrenmesi modeli, herhangi bir açıdan üstün QR kodu okuma özelliği sunar -- bu, kullanıcı tarafından gönderilen görüntülerin işlendiği ve girdi kalitesinin kontrol edilemediği uygulamalar için kritiktir. Tek yöntemli API, çalışan bir özelliği teslim etmek için gereken kod satırlarını da azaltır.

QRCoder'dan geçiş yapan ekipler için, QRCoder'dan IronQR'a geçiş kılavuzu'nü inceleyerek API eşleştirmesini yan yana görebilirsiniz.

Binary Verileri Bir QR Kodunda Nasıl Kodlarsınız?

IronQR, metin dışında, ikili QR kodu yükleri için bayt dizilerini kodlamayı destekler. Bu, şifrelenmiş belirteçler, serileştirilmiş nesneler veya UTF-8 dizeleri olarak temsil edilemeyen ham ikili tanıtıcılar için kullanışlıdır:

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

Çıktı

NuGet QR Kod Oluşturucu: C# ile Sadece Birkaç Satır Kodda QR Kodları Oluşturun: Görsel 5 - İkili kodlanmış QR kodu

İkili kodlama, şifrelenmiş yükleri, serileştirilmiş nesneleri veya herhangi bir ikili içeriği QR sembolleri içerisine dahil etmenizi sağlar. Alıcı taraftaki tarayıcının, ikili yükü nasıl yorumlayacağını bilmesi gerekir -- bu, QR kodunun insan tarafından okunabilir bir URL yerine imzalı bir belirteç içerdiği erişim kontrol sistemlerinde yaygındır.

Unutmayın ki ikili veri, eşdeğer metin verisinden daha yoğun QR sembolleri üretir. Eğer yük büyüklüğü uzak mesafede tarama güvenilirliği için bir endişe yaratıyorsa, H seviyesinde hata düzeltme uygulayın ve kullanıcıların sahip olmasını beklediğiniz en küçük kamera ile test edin.

C#'da QR Kodları Nasıl Okunur?

IronQR hem yazmayı hem de okumayı yönetir. QrReader sınıfı, görüntü dosyalarını, bit eşlem resimlerini ve kamera çerçevelerini kabul eder, toplu işleme ve gerçek zamanlı tarama senaryoları için uygundur:

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

Makine öğrenimi (ML) destekli okuma motoru, herhangi bir yöndeki görüntüleri işler ve hata düzeltme eşiğine kadar kısmi hasarları yönetir. Üretim okuma senaryoları için düşük kaliteli girdileri, çoklu kod görüntülerini ve tarama modu yapılandırmasını ele alma konusunda rehberlik almak için QR kodu okuma kılavuzunu inceleyin.

IronQR'yi Bir ASP.NET Core Uygulamasında Nasıl Kullanırsınız?

Web uygulamaları, kullanıcı hesap bağlantıları, tek seferlik giriş kodları veya ödeme talepleri gibi nedenlerle sık sık talep üzerine QR kodları oluşturmalıdır. Aşağıdaki örnek, bir ASP.NET Core minimal API uç noktasından doğrudan QR kod resmi sunmayı gösterir:

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

Bu desen, hem ASP.NET Core minimal API'lerde hem de standart MVC denetleyicilerinde işe yarar. ExportBytes() çağrısı, dosya sisteminin salt okunur veya geçici olabileceği konteynerize dağıtımlarda önemli olan geçici dosyaları diske yazmayı önler.

ASP.NET Core tam entegrasyon kılavuzu için, ASP.NET Core QR kodu oluşturucu öğreticisini inceleyin. Blazor'a özgü bir kılavuz da Blazor QR kodu oluşturucu eğitiminde mevcuttur.

Bir QR Kod Görüntüsüne Nasıl Kenar Boşluğu Ekler ve Yeniden Boyutlandırırsınız?

Boyutları ve sessiz bölgeleri kontrol etmek, baskı kalitesinde çıktı almak için gereklidir. IronQR, hem QrStyleOptions ile hem de her biri ayrıntılı olarak ele alınan özel kılavuzlar ile bunları sunar:

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

Farklı çıktı ortamları için boyutlandırma ve kenar boşluğu gereksinimleri hakkında tam bilgi için, QR kodu resimlerini yeniden boyutlandırma ve QR kodlarına kenar boşlukları ekleme konusundaki nasıl yapılır makalelerine bakın. QR kod görüntüsü oluşturma kılavuzu, lisans aktivasyonundan dosya çıktısına kadar tam görüntü oluşturma akışını kapsar.

Belirli QR kodu kullanım durumları için -- kartvizitler için QR kodu oluşturma, dinamik QR kodu oluşturucu yazılımı geliştirme, ve görüntülerden QR kodu okuma -- her bir senaryoya özel makaleler tam kod örnekleri ile ele alınmaktadır.

Sonraki Adımlarınız Neler?

IronQR, QR kodu oluşturma işlemini çok adımlı bir süreçten basit bir NuGet entegrasyonuna dönüştürür. Paketi yüklersiniz, QrWriter.Write() çağrısında bulunur ve sonucu kaydedersiniz -- gerçek dünya senaryolarının çoğunu kapsayan üç işlemdir. Hata düzeltme seviyeleri, özel stil verme, PDF damgalama ve ML destekli okuma, aynı kütüphane ile kullanılabilir.

IronQR dokümantasyonu, tarama modlarıyla QR kodlarını okuma, toplu işlem ve platforma özel dağıtım notları gibi ileri düzey konular dahil olmak üzere, eksiksiz bir API referansı sunar. IronQR eğitim bölümü, .NET MAUI, VB.NET ve konsol uygulamaları için adım adım kılavuzlar içerir.

Özellik setini kısıtlama olmadan keşfetmek için ücretsiz bir deneme başlatın veya 24/5 mühendislik desteğiyle üretim dağıtımı için bir lisans satın alın.

Curtis Chau
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

İlgili Makaleler

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Ücretsiz Canlı Demo rezervasyonu yapın
Booking Badge

Dünya Çapında Milyonlarca Mühendisin Güvendiği

Iron Software müşteri logoları
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez