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

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:

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";

using IronQr;

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

Imports 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");

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");

Imports IronQr
Imports IronSoftware.Drawing

' Generate a QR code from text data
Dim myQr As QrCode = QrWriter.Write("Hello World")

' Save QR code as bitmap image
Dim qrImage As AnyBitmap = myQr.Save()

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

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:

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");

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");

Imports IronQr
Imports IronSoftware.Drawing

' Configure high error correction level
Dim options As New QrOptions(QrErrorCorrectionSeviye.High)

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

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");

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");

Imports IronQr
Imports IronSoftware.Drawing

' Create styled QR code with custom colors
Dim styleOptions As New QrStyleOptions With {
    .Dimensions = 300,    ' Width and height in pixels
    .Margins = 10,        ' Quiet zone in pixels
    .Color = Color.DarkBlue,
    .BackgroundColor = Color.White
}

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

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();

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();

Imports IronQr
Imports IronSoftware.Drawing

Dim qr As QrCode = QrWriter.Write("Format demonstration")
Dim image As AnyBitmap = 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
Dim pngBytes As Byte() = image.ExportBytes()

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.

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");

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");

Imports IronQr
Imports IronSoftware.Drawing

' Encode binary data -- useful for encrypted payloads or binary identifiers
Dim binaryData As Byte() = System.Text.Encoding.UTF8.GetBytes("Binary content example")
Dim qr As QrCode = QrWriter.Write(binaryData)
qr.Save().SaveAs("binary-qr.png")

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}");
}

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}");
}

Imports IronQr
Imports IronSoftware.Drawing

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

' Read all QR codes in the image
Dim readResult As QrReadResult = QrReader.Read(inputImage)

For Each result As QrResult In readResult.QrCodes
    ' Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}")
Next

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();

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();

Imports IronQr
Imports IronSoftware.Drawing

Dim builder = WebApplication.CreateBuilder(args)
Dim 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", Function(data As String)
                      Dim qr As QrCode = QrWriter.Write(data)
                      Dim image As AnyBitmap = qr.Save()
                      Dim pngBytes As Byte() = image.ExportBytes()
                      Return Results.File(pngBytes, "image/png")
                  End Function)

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");

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");

Imports IronQr
Imports IronSoftware.Drawing

' Specify dimensions and quiet zone for print output
Dim printOptions As New QrStyleOptions With {
    .Dimensions = 600,   ' High resolution for print
    .Margins = 20        ' Generous quiet zone for reliable scanning
}

Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")
Dim printImage As AnyBitmap = 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.