Como gerar códigos QR em C# com um pacote NuGet

Como Você Instala um Pacote NuGet de Código QR?

Instalar o IronQR através do Gerenciador de Pacotes NuGet leva apenas alguns segundos. Abra o Console do Gerenciador de Pacotes NuGet no Visual Studio e execute o seguinte comando, ou use o comando dotnet add package para ambientes CLI:

Install-Package IronQR

O pacote NuGet gerencia automaticamente todas as dependências, garantindo compatibilidade com seus frameworks-alvo. O IronQR suporta .NET Framework 4.6.2+, .NET Core 2.0+ e .NET 5-10, tornando-o uma biblioteca versátil para qualquer projeto no Visual Studio.

Antes de escrever qualquer código, você precisa de uma chave de licença de avaliação gratuita. Configure-a logo no início da inicialização de sua aplicação para que todas as chamadas subsequentes sejam autenticadas:

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"

Com a chave de licença configurada, seu aplicativo está pronto para gerar, ler e personalizar Códigos QR sem marcas d'água nas imagens de saída.

Como Você Gera Seu Primeiro Código QR?

Criar seu primeiro Código QR requer um código mínimo. A classe QrWriter lida com a geração de códigos QR com padrões sensatos que funcionam bem para a maioria dos casos de uso:

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

Como Você Escolhe o Nível Correto de Correção de Erro?

Os Códigos QR suportam quatro níveis de correção de erro definidos no padrão ISO/IEC 18004 QR code standard que determinam quanto dano um código pode sustentar enquanto permanece escaneável. IronQR suporta todos os quatro níveis através da classe QrOptions:

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionNível.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(QrErrorCorrectionNível.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(QrErrorCorrectionNível.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")

Como Personalizar a Aparência do Código QR?

IronQR oferece amplas opções de estilo através de QrStyleOptions, permitindo cores personalizadas, dimensões, margens e incorporação de logotipo. Códigos QR de marca têm um desempenho melhor em contextos de marketing porque associam visualmente o código com uma identidade conhecida:

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

Como Salvar Códigos QR em Diferentes Formatos de Saída?

IronQR suporta múltiplos formatos de saída, incluindo PNG, JPEG, GIF, TIFF, BMP e SVG. O método SaveAs detecta automaticamente o formato a partir da extensão do arquivo:

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

Como Comparar o Pacote IronQR NuGet com QRCoder?

A biblioteca QRCoder é uma opção popular de código-fonte aberto para geração de códigos QR em .NET. Desenvolvedores que usaram QRCoder estão familiarizados com sua API em múltiplos passos envolvendo QRCodeGenerator, QRCodeData, e uma classe de renderização separada como PngByteQRCode. IronQR simplifica isso para uma única chamada QrWriter.Write().

O QRCoder funciona bem para geração básica em ambientes Windows. O modelo de aprendizado de máquina do IronQR fornece leitura superior de código QR de qualquer ângulo - fundamental para aplicativos que processam imagens enviadas por usuários onde a qualidade de entrada não pode ser controlada. A API de método único também reduz as linhas de código necessárias para implementar um recurso funcional.

Para equipes que estão migrando do QRCoder, veja o guia de migração do QRCoder para IronQR para um mapeamento de API lado a lado.

Como você codifica dados binários em um código QR?

Além de texto, o IronQR suporta codificação de arrays de bytes para cargas úteis de código QR binário. Isso é útil para tokens criptografados, objetos serializados ou identificadores binários brutos que não podem ser representados como strings UTF-8:

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

Como você lê códigos QR em C#?

O IronQR lida com escrita e leitura. A classe QrReader aceita arquivos de imagem, bitmaps e quadros de câmera, tornando-se adequada tanto para processamento em lote quanto para cenários de escaneamento em tempo real:

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

O motor de leitura com tecnologia ML processa imagens em qualquer orientação e lida com danos parciais até o limite de correção de erro. Para cenários de leitura em produção, revise o tutorial de leitura de código QR para orientação sobre como lidar com entradas de baixa qualidade, imagens com múltiplos códigos e configuração do modo de digitalização.

Como você usa o IronQR em um aplicativo ASP.NET Core?

Aplicações web frequentemente precisam gerar códigos QR sob demanda - para links de contas de usuário, códigos de login único ou solicitações de pagamento. O exemplo a seguir mostra como servir uma imagem de código QR diretamente de um ponto final da API mínima do ASP.NET Core:

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

Este padrão funciona tanto em APIs mínimas do ASP.NET Core quanto em controladores MVC padrão. A chamada ExportBytes() evita gravar arquivos temporários no disco, o que é importante em implantações em contêineres onde o sistema de arquivos pode ser somente leitura ou efêmero.

Para um guia completo de integração com o ASP.NET Core, veja o tutorial do gerador de código QR para ASP.NET Core. Um guia específico para Blazor também está disponível no tutorial gerador de código QR para Blazor.

Como você adiciona uma margem e redimensiona uma imagem de código QR?

Controlar dimensões e zonas de silêncio é essencial para saída de qualidade de impressão. IronQR expõe ambos através de QrStyleOptions, e guias dedicados de como-fazer cobrem cada um em detalhe:

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

Para orientação completa sobre tamanhos e requisitos de margem em diferentes mídias de saída, veja os artigos práticos sobre como redimensionar imagens de código QR e como adicionar margens aos códigos QR. O guia para criar imagem de código QR cobre todo o fluxo de criação de imagens desde a ativação da licença até a saída de arquivos.

Para casos de uso específicos de código QR - incluindo geração de códigos QR para cartões de visita, construindo um gerador de código QR dinâmico, e lendo códigos QR de imagens - os artigos dedicados cobrem cada cenário com exemplos completos de código.

Quais são os seus próximos passos?

O IronQR transforma a geração de código QR de um processo em várias etapas para uma integração simples do NuGet. Você instala o pacote, chama QrWriter.Write(), e salva o resultado -- três operações que cobrem a maioria dos cenários do mundo real. Níveis de correção de erro, estilização personalizada, marcação de PDF e leitura com tecnologia ML estão todos disponíveis através da mesma biblioteca.

A documentação do IronQR fornece a referência completa da API, incluindo tópicos avançados, como ler códigos QR com modos de digitalização, processamento em lote, e notas de implantação específicas para a plataforma. A seção de tutoriais do IronQR inclui guias passo a passo for .NET MAUI, VB.NET, e aplicações de console.

Comece um teste gratuito para explorar o conjunto completo de recursos sem restrições, ou compre uma licença para implantação em produção com suporte de engenharia 24/5.