Como criar uma imagem de código QR em C# com IronQR

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

Para criar uma imagem de código QR em C#, use o método QrWriter.Write() do IronQR para gerar o código, depois Save() para obter um objeto AnyBitmap e SaveAs() para exportá-lo para o formato de imagem preferido, como PNG ou JPEG.

Início rápido: Crie sua primeira imagem de código QR

  1. Instale o IronQR através do Gerenciador de Pacotes NuGet.
  2. Adicione using IronQr; e using IronSoftware.Drawing;
  3. Gere o código QR: QrCode qrCode = QrWriter.Write("your text");
  4. Salve como bitmap: AnyBitmap anyBitmap = qrCode.Save();
  5. Exporte como imagem: anyBitmap.SaveAs("myQRCode.png", AnyBitmap.ImageFormat.Png);

Aqui está um exemplo completo para você começar:

  1. Instale IronQR com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronQR
  2. Copie e execute este trecho de código.

    using IronQr;
    using IronSoftware.Drawing;
    
    // Generate a simple QR code
    QrCode myQrCode = QrWriter.Write("Hello, World!");
    
    // Save as an image bitmap
    AnyBitmap qrImage = myQrCode.Save();
    
    // Export to PNG file
    qrImage.SaveAs("hello-world-qr.png");
  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronQR em seu projeto hoje com uma avaliação gratuita

    arrow pointer

Os códigos QR codificam dados como padrões visuais de quadrados pretos e brancos que câmeras e leitores podem ler. Essas matrizes bidimensionais armazenam URLs, texto ou outras informações em um formato compacto e fácil de escanear. Para exemplos mais avançados, consulte o guia de início rápido do QR Code .

Como faço para criar um código QR como imagem?

Que código preciso para gerar um código QR?

Criar códigos QR com o IronQR requer um código mínimo. Gere o objeto de código QR com uma linha e depois exporte-o como uma imagem usando os métodos Save e SaveAs. A classe QrWriter fornece todas as funcionalidades para gerar códigos QR .

:path=/static-assets/qr/content-code-examples/how-to/create-qr-code-image.cs
using IronQr;
using IronSoftware.Drawing;

// Creating a QR code
QrCode qrCode = QrWriter.Write("12345");

// Save QR code to AnyBitmap
AnyBitmap anyBitmap = qrCode.Save();

// Save AnyBitmap to PNG
anyBitmap.SaveAs("simpleQrCode.png", AnyBitmap.ImageFormat.Png);
$vbLabelText   $csharpLabel
Exemplo de código QR gerado, mostrando o resultado visual do processo de criação do código QR.

Para quais formatos de imagem posso exportar?

O método Save retorna um objeto AnyBitmap que suporta múltiplos formatos de exportação:

  • JPEG (.jpg ou .jpeg) : Formato comprimido para fotos usando compressão com perda de dados.
  • PNG (.png) : Formato sem perdas, ideal para uso na web, com suporte a transparência.
  • Bmp (.bmp) : Formato do Windows não compactado que produz arquivos grandes e de alta qualidade.
  • GIF (.gif) : Suporta animações e transparência com limite de 256 cores.
  • TIFF (.tiff ou .tif) : Formato flexível para fotografia profissional.
  • WBMP (.wbmp) : Formato monocromático para comunicação sem fio.
  • WebP (.webp) : Formato moderno com excelente compressão com e sem perdas.
  • Ícone (.ico) : Pequenas imagens quadradas para ícones de programas e arquivos.
  • WMF (.wmf) : Formato vetorial e raster para gráficos do Windows.
  • RawFormat (.raw) : Dados de imagem não processados ​​para edição profissional.

Por que devo escolher PNG em vez de JPEG para códigos QR?

O formato PNG oferece compressão sem perdas e bordas nítidas, essenciais para a legibilidade do código QR. A compressão com perda de dados do JPEG pode desfocar as bordas do código QR, afetando potencialmente a confiabilidade da leitura. O formato PNG garante linhas nítidas para uma digitalização ideal em todos os dispositivos e condições.

O suporte à transparência do PNG agrega valor a códigos QR estilizados com logotipos ou cores personalizadas. Saiba mais sobre como criar códigos QR estilizados com personalização avançada em nosso guia avançado.

Como posso controlar o tamanho e a qualidade do código QR?

IronQR oferece opções para controlar tamanho e qualidade:

using IronQr;
using IronSoftware.Drawing;

// Create QR code with custom dimensions
QrOptions options = new QrOptions(QrErrorCorrectionLevel.High, 20);
QrCode qrCode = QrWriter.Write("https://ironsoftware.com", options);

// Save with specific dimensions
AnyBitmap qrImage = qrCode.SaveAsPng(500, 500);

// Save to file
qrImage.SaveAs("custom-size-qr.png");
using IronQr;
using IronSoftware.Drawing;

// Create QR code with custom dimensions
QrOptions options = new QrOptions(QrErrorCorrectionLevel.High, 20);
QrCode qrCode = QrWriter.Write("https://ironsoftware.com", options);

// Save with specific dimensions
AnyBitmap qrImage = qrCode.SaveAsPng(500, 500);

// Save to file
qrImage.SaveAs("custom-size-qr.png");
$vbLabelText   $csharpLabel

A correção de erros determina a tolerância a danos, mantendo a legibilidade. Níveis mais elevados criam códigos QR complexos com melhor tolerância a falhas, detalhada em nossa documentação sobre tolerância a falhas .


Quais tipos de código QR são suportados?

Qual tipo de código QR devo usar para aplicações padrão?

O IronQR é compatível com todos os principais formatos de código QR para diversas necessidades de aplicação:

  • QRCode : Código QR padrão que armazena até 7.089 caracteres numéricos ou 4.296 caracteres alfanuméricos. Adequado para URLs, informações de contato e armazenamento de dados em geral.
Exemplo de código QR mostrando padrão de matriz preto e branco padrão com quadrados de posicionamento nos cantos.

Quando devo usar microcódigos QR?

  • MicroQRCode : Versão menor para aplicações com espaço limitado. Armazena até 35 caracteres numéricos ou 21 caracteres alfanuméricos. Ideal para embalagens pequenas ou etiquetas minúsculas.
Código QR padrão mostrando o típico padrão quadrado em preto e branco com cantos arredondados e módulos de dados.

Para que servem os códigos RMQR?

  • RMQRCode : Micro QR Code retangular com proporção flexível. Armazena dados de forma semelhante a um Micro QR Code, mas se adapta a espaços retangulares.
Exemplo de código QR mostrando um padrão de matriz padrão com marcadores de posicionamento e quadrados com dados codificados.

Melhores práticas para geração de imagens de código QR

Quais são as principais considerações para a produção de códigos QR?

Considere estes fatores para a produção de códigos QR:

  1. Nível de correção de erros : Use Alto (H) para materiais impressos que possam ser danificados. O tamanho médio (M) é suficiente para telas digitais.
  2. Zona de Silêncio : Mantenha um espaço em branco de pelo menos 4 módulos de largura ao redor do código QR para uma leitura ideal.
  3. Contraste : Preto sobre branco proporciona os melhores resultados. Os recursos de estilo do IronQR permitem variações criativas, mantendo a legibilidade.
  4. Tamanho : Garanta que os códigos impressos tenham no mínimo 2 cm x 2 cm. Os monitores digitais podem precisar de tamanhos maiores dependendo da distância de visualização.

Como lidar com diferentes casos de uso?

Aplicações diferentes exigem abordagens diferentes:

Para cartões de visita e materiais impressos:

// High error correction for durability
QrOptions printOptions = new QrOptions(QrErrorCorrectionLevel.High, 10);
QrCode businessCard = QrWriter.Write("BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nEND:VCARD", printOptions);
// High error correction for durability
QrOptions printOptions = new QrOptions(QrErrorCorrectionLevel.High, 10);
QrCode businessCard = QrWriter.Write("BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nEND:VCARD", printOptions);
$vbLabelText   $csharpLabel

Para telas digitais e sites:

// Medium error correction with larger modules for screen display
QrOptions digitalOptions = new QrOptions(QrErrorCorrectionLevel.Medium, 15);
QrCode webQr = QrWriter.Write("https://example.com", digitalOptions);
// Medium error correction with larger modules for screen display
QrOptions digitalOptions = new QrOptions(QrErrorCorrectionLevel.Medium, 15);
QrCode webQr = QrWriter.Write("https://example.com", digitalOptions);
$vbLabelText   $csharpLabel

Para aplicativos móveis:

// Optimized for mobile scanning
QrOptions mobileOptions = new QrOptions(QrErrorCorrectionLevel.Low, 8);
QrCode appQr = QrWriter.Write("myapp://action", mobileOptions);
// Optimized for mobile scanning
QrOptions mobileOptions = new QrOptions(QrErrorCorrectionLevel.Low, 8);
QrCode appQr = QrWriter.Write("myapp://action", mobileOptions);
$vbLabelText   $csharpLabel

Recursos avançados e integração

Os recursos abrangentes do IronQR vão além da geração básica de códigos QR. A biblioteca integra-se perfeitamente com outros produtos da Iron Software e oferece suporte a processamento em lote, geração dinâmica e integração com aplicações web.

Para soluções completas de código QR, explore nosso tutorial de Gerador de Código QR em C#, que abrange padrões de implementação de ponta a ponta e as melhores práticas corporativas.

O IronQR oferece as ferramentas e a flexibilidade necessárias para o desenvolvimento profissional em .NET , desde geradores simples até sistemas complexos de processamento de documentos. A compatibilidade multiplataforma da biblioteca garante a geração consistente de códigos QR em ambientes Windows, Linux, macOS e na nuvem.

Perguntas frequentes

Qual é a maneira mais rápida de criar uma imagem de código QR em C#?

A maneira mais rápida é usar o método `QrWriter.Write()` do IronQR para gerar o código QR, depois chamar `Save()` para obter um objeto `AnyBitmap` e, finalmente, usar `SaveAs()` para exportá-lo para o formato de imagem desejado. Com apenas 5 linhas de código, você pode criar e salvar um código QR como um arquivo PNG ou JPEG.

Quais formatos de imagem são suportados na exportação de códigos QR?

O IronQR suporta vários formatos de imagem, incluindo JPEG, PNG, BMP, GIF, TIFF, WBMP, WebP e ícones. O método Save() retorna um objeto AnyBitmap que pode ser exportado para qualquer um desses formatos usando o método SaveAs() com o parâmetro ImageFormat apropriado.

Como faço para gerar um código QR simples e salvá-lo como um arquivo PNG?

Para gerar um código QR e salvá-lo como PNG, use: `QrCode myQrCode = QrWriter.Write("seu texto");`, depois `AnyBitmap qrImage = myQrCode.Save();` e, finalmente, `qrImage.SaveAs("nome_do_arquivo.png", AnyBitmap.ImageFormat.Png);`. O IronQR cuida de toda a complexidade da geração do código QR para você.

Quais namespaces preciso importar para criar imagens de código QR?

Você precisa importar dois namespaces: 'using IronQr;' para a funcionalidade de geração de código QR e 'using IronSoftware.Drawing;' para os recursos de manipulação de imagens. Estes fornecem acesso à classe QrWriter e ao objeto AnyBitmap usados no IronQR.

Posso criar códigos QR com estilo personalizado ou apenas em preto e branco?

Embora os exemplos básicos mostrem códigos QR padrão em preto e branco, a classe QrWriter do IronQR oferece ampla funcionalidade para gerar códigos QR personalizados. Você pode explorar opções avançadas de estilo por meio da documentação completa da API.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 61,359 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronQR
executar um exemplo Veja seu URL se transformar em um código QR.