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

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

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

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

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

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

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

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

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

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.