Generate QR Codes in C# - Complete Tutorial for .NET Developers
Potrzebujesz generować kody QR w swojej aplikacji C#? Ten samouczek pokazuje dokładnie, jak tworzyć, dostosowywać i weryfikować kody QR przy użyciu IronBarcode — od prostych implementacji jednowierszowych po zaawansowane funkcje, takie jak osadzanie logo i kodowanie danych binarnych.
Niezależnie od tego, czy tworzysz systemy inwentaryzacyjne, platformy biletowe, czy rozwiązania do płatności bezkontaktowych, nauczysz się implementować funkcjonalność kodów QR o jakości profesjonalnej w swoich aplikacjach .NET.
Szybki start: Tworzenie kodu QR w jednej linii z IronBarcode
Chcesz szybko wygenerować kod QR? Oto jak możesz użyć API IronBarcode QRCodeWriter, aby stworzyć kod QR za pomocą zaledwie jednej linii kodu — dostosowanie jest opcjonalne, ale daje duże możliwości.
-
Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode -
Skopiuj i uruchom ten fragment kodu.
var qr = QRCodeWriter.CreateQrCode("https://ironsoftware.com/", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium); qr.SaveAsPng("MyQR.png"); -
Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronBarcode w swoim projekcie już dziś z darmową wersją próbną
Minimalny proces (5 kroków)
- Zainstaluj IronBarcode przez NuGet
- Stwórz kod QR w jednej linii:
QRCodeWriter.CreateQrCode() - Osadzaj logotypy używając
CreateQrCodeWithLogo() - Zweryfikuj czytelność za pomocą
GeneratedBarcode.Verify() - Koduj dane binarne dla zaawansowanych zastosowań
How Do I Install a QR Code Library in C#?
Zainstaluj IronBarcode za pomocą menedżera pakietów NuGet, używając tego prostego polecenia:
Install-Package BarCode
Alternatywnie, pobierz bezpośrednio bibliotekę IronBarcode DLL i dodaj ją jako odniesienie do swojego projektu.
Importuj wymagane przestrzenie nazw
Dodaj te przestrzenie nazw, aby uzyskać dostęp do funkcji generowania kodów QR w IronBarcode:
using IronBarCode;
using System;
using System.Drawing;
using System.Linq;
using IronBarCode;
using System;
using System.Drawing;
using System.Linq;
Imports IronBarCode
Imports System
Imports System.Drawing
Imports System.Linq
How Can I Create a Simple QR Code in C#?
Wygeneruj kod QR za pomocą zaledwie jednej linii kodu, korzystając z metody IronBarcode CreateQrCode:
using IronBarCode;
// Generate a QR code with text content
var qrCode = QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("MyQR.png");
using IronBarCode;
// Generate a QR code with text content
var qrCode = QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("MyQR.png");
Imports IronBarCode
' Generate a QR code with text content
Private qrCode = QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qrCode.SaveAsPng("MyQR.png")
Metoda `` przyjmuje trzy parametry:
- Zawartość tekstowa: Dane do zakodowania (obsługuje URL-e, tekst lub dowolne dane tekstowe)
- Rozmiar: Wymiary pikselowe kwadratowego kodu QR (w tym przykładzie 500x500)
- Korekcja błędów: Określa czytelność w suboptymalnych warunkach (niska, średnia, kwartylowa lub wysoka)
Wyższe poziomy korekcji błędów pozwalają na czytelność kodów QR, nawet gdy są częściowo uszkodzone lub zasłonięte, jednak skutkują gęstszymi wzorami z mniejszymi modułami danych.
Podstawowy kod QR zawierający tekst "hello world", wygenerowany przy rozmiarze 500x500 pikseli z średnią korekcją błędów
Jak dodać logo do mojego kodu QR?
Osadzanie logo w kodach QR zwiększa rozpoznawalność marki przy zachowaniu możliwości skanowania. IronBarcode automatycznie pozycjonuje i dostosowuje rozmiar logo, aby zachować integralność kodu QR:
using IronBarCode;
using IronSoftware.Drawing;
// Load logo image
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
// Create QR code with embedded logo
GeneratedBarcode myQRCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);
// Customize appearance
myQRCodeWithLogo.ResizeTo(500, 500).SetMargins(10).ChangeBarCodeColor(Color.DarkGreen);
// Save the branded QR code
myQRCodeWithLogo.SaveAsPng("myQRWithLogo.png");
using IronBarCode;
using IronSoftware.Drawing;
// Load logo image
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
// Create QR code with embedded logo
GeneratedBarcode myQRCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);
// Customize appearance
myQRCodeWithLogo.ResizeTo(500, 500).SetMargins(10).ChangeBarCodeColor(Color.DarkGreen);
// Save the branded QR code
myQRCodeWithLogo.SaveAsPng("myQRWithLogo.png");
Imports IronBarCode
Imports IronSoftware.Drawing
' Load logo image
Private qrCodeLogo As New QRCodeLogo("visual-studio-logo.png")
' Create QR code with embedded logo
Private myQRCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo)
' Customize appearance
myQRCodeWithLogo.ResizeTo(500, 500).SetMargins(10).ChangeBarCodeColor(Color.DarkGreen)
' Save the branded QR code
myQRCodeWithLogo.SaveAsPng("myQRWithLogo.png")
Metoda `` w inteligentny sposób zarządza umieszczeniem logo poprzez:
- Automatyczne dopasowanie rozmiaru logotypu do zachowania czytelności kodu QR
- Pozycjonowanie go w strefie ciszy, aby uniknąć uszkodzenia danych
- Zachowanie oryginalnych kolorów logotypu przy zmianie kolorów kodu QR
To podejście gwarantuje, że Twoje markowe kody QR pozostaną w pełni funkcjonalne na wszystkich urządzeniach do skanowania i aplikacjach.
Kod QR z logo Visual Studio, demonstrujący automatyczne dostosowanie rozmiaru i pozycjonowania logotypów przez IronBarcode
Jak mogę eksportować kody QR do różnych formatów?
IronBarcode obsługuje wiele formatów eksportu dla różnych zastosowań. Eksportuj swoje kody QR jako obrazy, PDF-y lub pliki HTML:
using IronBarCode;
using System.Drawing;
// Create QR code with logo
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
GeneratedBarcode myQRCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);
// Apply custom styling
myQRCodeWithLogo.ChangeBarCodeColor(Color.DarkGreen);
// Export to multiple formats
myQRCodeWithLogo.SaveAsPdf("MyQRWithLogo.pdf"); // PDF document
myQRCodeWithLogo.SaveAsHtmlFile("MyQRWithLogo.html"); // Standalone HTML
myQRCodeWithLogo.SaveAsPng("MyQRWithLogo.png"); // PNG image
myQRCodeWithLogo.SaveAsJpeg("MyQRWithLogo.jpg"); // JPEG image
using IronBarCode;
using System.Drawing;
// Create QR code with logo
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
GeneratedBarcode myQRCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);
// Apply custom styling
myQRCodeWithLogo.ChangeBarCodeColor(Color.DarkGreen);
// Export to multiple formats
myQRCodeWithLogo.SaveAsPdf("MyQRWithLogo.pdf"); // PDF document
myQRCodeWithLogo.SaveAsHtmlFile("MyQRWithLogo.html"); // Standalone HTML
myQRCodeWithLogo.SaveAsPng("MyQRWithLogo.png"); // PNG image
myQRCodeWithLogo.SaveAsJpeg("MyQRWithLogo.jpg"); // JPEG image
Imports IronBarCode
Imports System.Drawing
' Create QR code with logo
Private qrCodeLogo As New QRCodeLogo("visual-studio-logo.png")
Private myQRCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo)
' Apply custom styling
myQRCodeWithLogo.ChangeBarCodeColor(Color.DarkGreen)
' Export to multiple formats
myQRCodeWithLogo.SaveAsPdf("MyQRWithLogo.pdf") ' PDF document
myQRCodeWithLogo.SaveAsHtmlFile("MyQRWithLogo.html") ' Standalone HTML
myQRCodeWithLogo.SaveAsPng("MyQRWithLogo.png") ' PNG image
myQRCodeWithLogo.SaveAsJpeg("MyQRWithLogo.jpg") ' JPEG image
Każdy format ma określone zastosowania:
- PDF: Idealny do dokumentów do druku i raportów
- HTML: Doskonały do integracji z witryną bez zewnętrznych zależności
- PNG/JPEG: Standardowe formaty obrazów do wszechstronnego użytku
Jak mogę zweryfikować czytelność kodu QR po dostosowaniu?
Modyfikacje kolorów i dodanie logo mogą wpłynąć na skanowalność kodu QR. Użyj metody ``, aby upewnić się, że Twoje spersonalizowane kody QR pozostają czytelne:
using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Drawing;
// Generate QR code with logo
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
GeneratedBarcode myVerifiedQR = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);
// Apply light color (may affect readability)
myVerifiedQR.ChangeBarCodeColor(Color.LightBlue);
// Verify the QR code can still be scanned
if (!myVerifiedQR.Verify())
{
Console.WriteLine("LightBlue is not dark enough to be read accurately. Let's try DarkBlue");
myVerifiedQR.ChangeBarCodeColor(Color.DarkBlue);
}
// Save verified QR code
myVerifiedQR.SaveAsHtmlFile("MyVerifiedQR.html");
using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Drawing;
// Generate QR code with logo
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
GeneratedBarcode myVerifiedQR = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);
// Apply light color (may affect readability)
myVerifiedQR.ChangeBarCodeColor(Color.LightBlue);
// Verify the QR code can still be scanned
if (!myVerifiedQR.Verify())
{
Console.WriteLine("LightBlue is not dark enough to be read accurately. Let's try DarkBlue");
myVerifiedQR.ChangeBarCodeColor(Color.DarkBlue);
}
// Save verified QR code
myVerifiedQR.SaveAsHtmlFile("MyVerifiedQR.html");
Imports IronBarCode
Imports IronSoftware.Drawing
Imports System
Imports System.Drawing
' Generate QR code with logo
Dim qrCodeLogo As New QRCodeLogo("visual-studio-logo.png")
Dim myVerifiedQR As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo)
' Apply light color (may affect readability)
myVerifiedQR.ChangeBarCodeColor(Color.LightBlue)
' Verify the QR code can still be scanned
If Not myVerifiedQR.Verify() Then
Console.WriteLine("LightBlue is not dark enough to be read accurately. Let's try DarkBlue")
myVerifiedQR.ChangeBarCodeColor(Color.DarkBlue)
End If
' Save verified QR code
myVerifiedQR.SaveAsHtmlFile("MyVerifiedQR.html")
Metoda `` wykonuje kompleksowy test skanowania kodu QR. Zapewnia to kompatybilność z różnymi urządzeniami skanującymi i warunkami oświetleniowymi przed wdrożeniem.
Pomyślnie zweryfikowany kod QR w ciemnoniebieskim kolorze, pokazujący właściwy kontrast dla niezawodnego skanowania
Jak mogę zakodować dane binarne w kodach QR?
Kody QR doskonale przechowują dane binarne w sposób efektywny. Ta funkcja umożliwia zaawansowane zastosowania, takie jak szyfrowany transfer danych, udostępnianie plików i konfiguracja urządzeń IoT:
using IronBarCode;
using System;
using System.Linq;
// Convert string to binary data
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/barcode/");
// Create QR code from binary content
QRCodeWriter.CreateQrCode(binaryData, 500).SaveAsPng("MyBinaryQR.png");
// Read and verify binary data integrity
var myReturnedData = BarcodeReader.Read("MyBinaryQR.png").First();
// Confirm data matches original
if (binaryData.SequenceEqual(myReturnedData.BinaryValue))
{
Console.WriteLine("Binary Data Read and Written Perfectly");
}
else
{
throw new Exception("Data integrity check failed");
}
using IronBarCode;
using System;
using System.Linq;
// Convert string to binary data
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/barcode/");
// Create QR code from binary content
QRCodeWriter.CreateQrCode(binaryData, 500).SaveAsPng("MyBinaryQR.png");
// Read and verify binary data integrity
var myReturnedData = BarcodeReader.Read("MyBinaryQR.png").First();
// Confirm data matches original
if (binaryData.SequenceEqual(myReturnedData.BinaryValue))
{
Console.WriteLine("Binary Data Read and Written Perfectly");
}
else
{
throw new Exception("Data integrity check failed");
}
Imports IronBarCode
Imports System
Imports System.Linq
' Convert string to binary data
Private binaryData() As Byte = System.Text.Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/barcode/")
' Create QR code from binary content
QRCodeWriter.CreateQrCode(binaryData, 500).SaveAsPng("MyBinaryQR.png")
' Read and verify binary data integrity
Dim myReturnedData = BarcodeReader.Read("MyBinaryQR.png").First()
' Confirm data matches original
If binaryData.SequenceEqual(myReturnedData.BinaryValue) Then
Console.WriteLine("Binary Data Read and Written Perfectly")
Else
Throw New Exception("Data integrity check failed")
End If
Kodowanie binarne w kodach QR oferuje kilka zalet:
- Efektywność: Przechowuje dane w zwartym formacie binarnym
- Wszechstronność: Obsługuje dowolny typ danych (pliki, zaszyfrowane treści, zserializowane obiekty)
- Integralność: Zachowuje dokładne sekwencje bajtów bez problemów kodowania
Ta funkcja odróżnia IronBarcode od podstawowych bibliotek QR, umożliwiając zaawansowane scenariusze wymiany danych w aplikacjach.
Kod QR przechowujący dane binarne, demonstrujący zaawansowane możliwości kodowania IronBarcode
How Do I Read QR Codes in C#?
IronBarcode zapewnia elastyczne możliwości odczytu kodów QR. Oto najprostsze podejście:
using IronBarCode;
using System;
using System.Linq;
// Read QR code with optimized settings
BarcodeResults result = BarcodeReader.Read("QR.png", new BarcodeReaderOptions() {
ExpectBarcodeTypes = BarcodeEncoding.QRCode
});
// Extract and display the decoded value
if (result != null && result.Any())
{
Console.WriteLine(result.First().Value);
}
else
{
Console.WriteLine("No QR codes found in the image.");
}
using IronBarCode;
using System;
using System.Linq;
// Read QR code with optimized settings
BarcodeResults result = BarcodeReader.Read("QR.png", new BarcodeReaderOptions() {
ExpectBarcodeTypes = BarcodeEncoding.QRCode
});
// Extract and display the decoded value
if (result != null && result.Any())
{
Console.WriteLine(result.First().Value);
}
else
{
Console.WriteLine("No QR codes found in the image.");
}
Imports IronBarCode
Imports System
Imports System.Linq
' Read QR code with optimized settings
Private result As BarcodeResults = BarcodeReader.Read("QR.png", New BarcodeReaderOptions() With {.ExpectBarcodeTypes = BarcodeEncoding.QRCode})
' Extract and display the decoded value
If result IsNot Nothing AndAlso result.Any() Then
Console.WriteLine(result.First().Value)
Else
Console.WriteLine("No QR codes found in the image.")
End If
Dla bardziej złożonych scenariuszy wymagających precyzyjnej kontroli:
using IronBarCode;
using System;
using System.Linq;
// Configure advanced reading options
BarcodeReaderOptions options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Faster, // Optimize for speed
ExpectMultipleBarcodes = false, // Single QR code expected
ExpectBarcodeTypes = BarcodeEncoding.QRCode, // QR codes only
Multithreaded = true, // Enable parallel processing
MaxParallelThreads = 4, // Utilize multiple CPU cores
RemoveFalsePositive = true, // Filter out false detections
ImageFilters = new ImageFilterCollection() // Apply preprocessing
{
new AdaptiveThresholdFilter(), // Handle varying lighting
new ContrastFilter(), // Enhance contrast
new SharpenFilter() // Improve edge definition
}
};
// Read with advanced configuration
BarcodeResults result = BarcodeReader.Read("QR.png", options);
using IronBarCode;
using System;
using System.Linq;
// Configure advanced reading options
BarcodeReaderOptions options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Faster, // Optimize for speed
ExpectMultipleBarcodes = false, // Single QR code expected
ExpectBarcodeTypes = BarcodeEncoding.QRCode, // QR codes only
Multithreaded = true, // Enable parallel processing
MaxParallelThreads = 4, // Utilize multiple CPU cores
RemoveFalsePositive = true, // Filter out false detections
ImageFilters = new ImageFilterCollection() // Apply preprocessing
{
new AdaptiveThresholdFilter(), // Handle varying lighting
new ContrastFilter(), // Enhance contrast
new SharpenFilter() // Improve edge definition
}
};
// Read with advanced configuration
BarcodeResults result = BarcodeReader.Read("QR.png", options);
Imports IronBarCode
Imports System
Imports System.Linq
' Configure advanced reading options
Private options As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Faster,
.ExpectMultipleBarcodes = False,
.ExpectBarcodeTypes = BarcodeEncoding.QRCode,
.Multithreaded = True,
.MaxParallelThreads = 4,
.RemoveFalsePositive = True,
.ImageFilters = New ImageFilterCollection() From {
New AdaptiveThresholdFilter(),
New ContrastFilter(),
New SharpenFilter()
}
}
' Read with advanced configuration
Private result As BarcodeResults = BarcodeReader.Read("QR.png", options)
Te zaawansowane opcje odczytu umożliwiają niezawodną detekcję kodów QR w trudnych warunkach, takich jak słabe oświetlenie, zniekształcenia obrazu, czy wydruki niskiej jakości.
Co dalej w zakresie rozwoju kodów QR?
Teraz, gdy opanowałeś już generowanie kodów QR za pomocą IronBarcode, zapoznaj się z tymi zaawansowanymi tematami:
- Wyciągaj kody QR z dokumentów PDF
- Zaimplementuj przetwarzanie partii kodów QR
- Stosuj poprawki obrazów dla trudnych skanów
Pobierz zasoby
Uzyskaj dostęp do pełnego kodu źródłowego i przykładów:
Dokumentacja API
Eksploruj pełen zestaw funkcji w dokumentacji API:
Alternatywa: IronQR dla zaawansowanych aplikacji QR
Dla projektów wymagających najnowocześniejszych możliwości kodów QR, rozważ IronQR — specjalistyczną bibliotekę kodów QR od Iron Software z funkcjami odczytu zasilanymi uczeniem maszynowym z dokładnością 99,99% oraz zaawansowanymi opcjami generacji.
Gotowy na wdrożenie kodów QR w swojej aplikacji .NET? Bezpłatna próba lub pobierz IronBarcode już dziś.
Często Zadawane Pytania
Jak wygenerować kod QR w C#?
Możesz generować kod QR w C# używając metody IronBarcode's QRCodeWriter.CreateQrCode(). Ta metoda pozwala przekazać swoją zawartość, rozmiar i poziom korekcji błędów, aby efektywnie stworzyć kod QR.
Do jakich formatów obrazów mogą być eksportowane kody QR?
Z IronBarcode możesz eksportować kody QR do różnych formatów, w tym PNG, JPEG, PDF i HTML. Dostępne są metody takie jak SaveAsPng(), SaveAsJpeg(), SaveAsPdf() i SaveAsHtmlFile() do tego celu.
Jak mogę dodać logo firmy do kodu QR?
IronBarcode dostarcza metodę CreateQrCodeWithLogo(), gdzie możesz przekazać obiekt QRCodeLogo zawierający swoje logo. Biblioteka zapewnia, że logo jest właściwie rozmiarowane i pozycjonowane, aby kod QR pozostał czytelny.
Co to jest korekcja błędów w kodach QR i jaki poziom powinienem wybrać?
Korekcja błędów w kodach QR pozwala im pozostać skanowalnymi, nawet jeśli są częściowo uszkodzone. IronBarcode oferuje cztery poziomy: Niski (7%), Średni (15%), Kwartał (25%) i Wysoki (30%). Średni jest odpowiedni dla większości celów, a Wysoki jest idealny dla trudnych środowisk.
Jak zweryfikować czytelność dostosowanego kodu QR?
Możesz użyć metody Verify() na obiekcie GeneratedBarcode, aby upewnić się, że twój dostosowany kod QR pozostaje skanowalny po modyfikacjach, takich jak zmiany koloru czy dodanie logo.
Czy dane binarne mogą być kodowane w kodach QR?
Tak, metoda CreateQrCode() IronBarcode obsługuje kodowanie tablic bajtów, co pozwala na przechowywanie danych binarnych, takich jak pliki czy zaszyfrowane treści w kodach QR.
Jak czytac kody QR z obrazów w C#?
Aby czytać kody QR z obrazów w C#, użyj metody BarcodeReader.Read() w IronBarcode. Dla zoptymalizowanej wydajności, wybierz BarcodeEncoding.QRCode w BarcodeReaderOptions.
Jaka jest maksymalna pojemność danych kodu QR?
Generowane przez IronBarcode kody QR mogą zawierać do 2 953 bajtów, 4 296 znaków alfanumerycznych lub 7 089 cyfr, w zależności od wybranego poziomu korekcji błędów.
Jak mogę zmienić kolor kodu QR, aby pozostał skanowalny?
Metoda ChangeBarCodeColor() w IronBarcode pozwala na zmianę koloru kodu QR. Zawsze używaj metody Verify() po tej operacji, żeby upewnić się, że czytelność kodu QR nie jest wpływana przez zmianę koloru.
Jakie funkcje oferuje wyspecjalizowana biblioteka do kodów QR?
IronQR, wyspecjalizowana biblioteka od Iron Software, zawiera zaawansowane funkcje takie jak czytanie kodów QR z użyciem uczenia maszynowego z dokładnością 99,99% oraz solidne możliwości generowania, dostosowane do złożonych aplikacji.

