Jak generować kody QR i kody kreskowe w C#

Generate QR Codes in C# - Complete Tutorial for .NET Developers

This article was translated from English: Does it need improvement?
Translated
View the article in English

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 jednowierszowych implementacji 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

Gotowy na szybkie wygenerowanie kodu QR? Oto jak można użyć API QRCodeWriter IronBarcode do wygenerowania kodu QR w zaledwie jednej linii kodu — dostosowanie jest opcjonalne, ale potężne.

  1. Install IronBarcode with NuGet Package Manager

    PM > Install-Package BarCode
  2. Skopiuj i uruchom ten fragment kodu.

    var qr = QRCodeWriter.CreateQrCode("https://ironsoftware.com/", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium); qr.SaveAsPng("MyQR.png");
  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronBarcode w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

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

Zainstaluj przez NuGet

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:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-3.cs
using IronBarCode;

// You may add styling with color, logo images or branding:
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
GeneratedBarcode myQRCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);

myQRCodeWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkGreen);

// Save as PDF
myQRCodeWithLogo.SaveAsPdf("MyQRWithLogo.pdf");

// Also Save as HTML
myQRCodeWithLogo.SaveAsHtmlFile("MyQRWithLogo.html");
Imports IronBarCode

' You may add styling with color, logo images or branding:
Private qrCodeLogo As New QRCodeLogo("visual-studio-logo.png")
Private myQRCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo)

myQRCodeWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkGreen)

' Save as PDF
myQRCodeWithLogo.SaveAsPdf("MyQRWithLogo.pdf")

' Also Save as HTML
myQRCodeWithLogo.SaveAsHtmlFile("MyQRWithLogo.html")
$vbLabelText   $csharpLabel

How Can I Create a Simple QR Code in C#?

Wygeneruj kod QR przy użyciu zaledwie jednej linii kodu, korzystając z metody IronBarcode's CreateQrCode:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-4.cs
using IronBarCode;
using IronSoftware.Drawing;
using System;

// Verifying QR Codes
QRCodeLogo qrCodeLogo = new QRCodeLogo("visual-studio-logo.png");
GeneratedBarcode MyVerifiedQR = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo);

MyVerifiedQR.ChangeBarCodeColor(System.Drawing.Color.LightBlue);

if (!MyVerifiedQR.Verify())
{
    Console.WriteLine("\t LightBlue is not dark enough to be read accurately.  Lets try DarkBlue");
    MyVerifiedQR.ChangeBarCodeColor(Color.DarkBlue);
}
MyVerifiedQR.SaveAsHtmlFile("MyVerifiedQR.html");

// open the barcode html file in your default web browser
System.Diagnostics.Process.Start("MyVerifiedQR.html");
Imports Microsoft.VisualBasic
Imports IronBarCode
Imports IronSoftware.Drawing
Imports System

' Verifying QR Codes
Private qrCodeLogo As New QRCodeLogo("visual-studio-logo.png")
Private MyVerifiedQR As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/", qrCodeLogo)

MyVerifiedQR.ChangeBarCodeColor(System.Drawing.Color.LightBlue)

If Not MyVerifiedQR.Verify() Then
	Console.WriteLine(vbTab & " LightBlue is not dark enough to be read accurately.  Lets try DarkBlue")
	MyVerifiedQR.ChangeBarCodeColor(Color.DarkBlue)
End If
MyVerifiedQR.SaveAsHtmlFile("MyVerifiedQR.html")

' open the barcode html file in your default web browser
System.Diagnostics.Process.Start("MyVerifiedQR.html")
$vbLabelText   $csharpLabel

Metoda CreateQrCode akceptuje 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.

Standardowy kod QR wygenerowany z IronBarcode w C# 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 ustawia pozycję i rozmiar logo, aby zachować integralność kodu QR:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-5.cs
using IronBarCode;
using System;
using System.Linq;

// Create Some Binary Data - This example equally well for Byte[] and System.IO.Stream
byte[] BinaryData = System.Text.Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/barcode/");

// WRITE QR with Binary Content
QRCodeWriter.CreateQrCode(BinaryData, 500).SaveAsImage("MyBinaryQR.png");

// READ QR with Binary Content
var MyReturnedData = BarcodeReader.Read("MyBinaryQR.png").First();
if (BinaryData.SequenceEqual(MyReturnedData.BinaryValue))
{
    Console.WriteLine("\t Binary Data Read and Written Perfectly");
}
else
{
    throw new Exception("Corrupted Data");
}
Imports Microsoft.VisualBasic
Imports IronBarCode
Imports System
Imports System.Linq

' Create Some Binary Data - This example equally well for Byte[] and System.IO.Stream
Private BinaryData() As Byte = System.Text.Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/barcode/")

' WRITE QR with Binary Content
QRCodeWriter.CreateQrCode(BinaryData, 500).SaveAsImage("MyBinaryQR.png")

' READ QR with Binary Content
Dim MyReturnedData = BarcodeReader.Read("MyBinaryQR.png").First()
If BinaryData.SequenceEqual(MyReturnedData.BinaryValue) Then
	Console.WriteLine(vbTab & " Binary Data Read and Written Perfectly")
Else
	Throw New Exception("Corrupted Data")
End If
$vbLabelText   $csharpLabel

Metoda CreateQrCodeWithLogo inteligentnie obsługuje umieszczanie 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 osadzonym logo Visual Studio 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:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-6.cs
using IronBarCode;
using System;
using System.Linq;

BarcodeResults result = BarcodeReader.Read("QR.png", new BarcodeReaderOptions() { ExpectBarcodeTypes = BarcodeEncoding.QRCode });
if (result != null)
{
    Console.WriteLine(result.First().Value);
}
Imports IronBarCode
Imports System
Imports System.Linq

Private result As BarcodeResults = BarcodeReader.Read("QR.png", New BarcodeReaderOptions() With {.ExpectBarcodeTypes = BarcodeEncoding.QRCode})
If result IsNot Nothing Then
	Console.WriteLine(result.First().Value)
End If
$vbLabelText   $csharpLabel

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 Verify(), aby zapewnić, że twoje dostosowane kody QR pozostają czytelne:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-7.cs
using IronBarCode;
using System;
using System.Linq;

BarcodeReaderOptions options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Faster,
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.All,
    Multithreaded = false,
    MaxParallelThreads = 0,
    CropArea = null,
    UseCode39ExtendedMode = false,
    RemoveFalsePositive = false,
    ImageFilters = null
};

BarcodeResults result = BarcodeReader.Read("QR.png", options);
if (result != null)
{
    Console.WriteLine(result.First().Value);
}
Imports IronBarCode
Imports System
Imports System.Linq

Private options As New BarcodeReaderOptions With {
	.Speed = ReadingSpeed.Faster,
	.ExpectMultipleBarcodes = False,
	.ExpectBarcodeTypes = BarcodeEncoding.All,
	.Multithreaded = False,
	.MaxParallelThreads = 0,
	.CropArea = Nothing,
	.UseCode39ExtendedMode = False,
	.RemoveFalsePositive = False,
	.ImageFilters = Nothing
}

Private result As BarcodeResults = BarcodeReader.Read("QR.png", options)
If result IsNot Nothing Then
	Console.WriteLine(result.First().Value)
End If
$vbLabelText   $csharpLabel

Metoda Verify() wykonuje kompleksowy test skanowania twojego kodu QR. Zapewnia to kompatybilność z różnymi urządzeniami skanującymi i warunkami oświetleniowymi przed wdrożeniem.

Zweryfikowany kod QR z ciemnoniebieskim odcieniem i logo Visual Studio 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:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-8.cs
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
Dim 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
$vbLabelText   $csharpLabel

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 wyróżnia IronBarcode spośród podstawowych bibliotek kodów QR, umożliwiając zaawansowane scenariusze wymiany danych w twoich aplikacjach.

Kod QR zawierający dane zakodowane binarnie 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:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-9.cs
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
Dim 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
$vbLabelText   $csharpLabel

Dla bardziej złożonych scenariuszy wymagających precyzyjnej kontroli:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-qr-code-generator-10.cs
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
Dim options As New BarcodeReaderOptions With {
    .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() From { ' Apply preprocessing
        New AdaptiveThresholdFilter(),      ' Handle varying lighting
        New ContrastFilter(),               ' Enhance contrast
        New SharpenFilter()                 ' Improve edge definition
    }
}

' Read with advanced configuration
Dim result As BarcodeResults = BarcodeReader.Read("QR.png", options)
$vbLabelText   $csharpLabel

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ś generowanie kodów QR przy użyciu IronBarcode, odkryj te zaawansowane tematy:

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.

Jacob Mellor, Dyrektor Technologiczny @ Team Iron
Dyrektor ds. technologii

Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczą...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 2,317,217 | Wersja: 2026.7 właśnie wydany
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package BarCode
uruchom przykład zobacz, jak twoje ciągi zamieniają się w kody kreskowe.