Como criar códigos de barras 2D

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

O IronBarcode permite que você gere todos os principais formatos de código de barras 2D, incluindo QR Code, Aztec, DataMatrix, MaxiCode, PDF417 e o novo formato rMQR com código C# simples. Basta passar o tipo de codificação desejado para o método Create e exportar como uma imagem. Com suporte para mais de 30 formatos de código de barras, o IronBarcode oferece uma solução abrangente para todas as suas necessidades de geração de códigos de barras.

Ao armazenar informações detalhadas em um espaço pequeno, os códigos de barras 2D são a solução definitiva da indústria. Eles contêm milhares de caracteres, permanecendo legíveis mesmo quando rasgados, arranhados ou marcados. Como podem ser escaneados de qualquer ângulo e não requerem alinhamento perfeito, esses códigos de barras são ideais para logística acelerada e aplicativos de escaneamento móvel. A correção de erros integrada garante que seus dados permaneçam acessíveis mesmo em condições desafiadoras.

O principal desafio é selecionar o formato correto para suas necessidades específicas. Você pode precisar do design compacto sem bordas do Código Aztec para bilhetagem móvel, da precisão industrial do Data Matrix para componentes eletrônicos minúsculos ou da enorme capacidade de armazenamento offline do PDF417 para carteiras de motorista e cartões de identificação. Com o IronBarcode, você pode gerar todos esses formatos de forma confiável e eficiente.

Neste guia, cobriremos como gerar formatos 2D críticos como QR Code, MaxiCode e o novo rMQR, junto com seus casos de uso cotidiano.


Início Rápido: Gere Seu Primeiro Código de Barras 2D

Use a API simples do IronBarcode para criar um QR Code a partir de uma string e salvá-lo como uma imagem PNG. Comece imediatamente — forneça os dados, escolha a codificação e o tamanho e escreva seu arquivo de imagem.

  1. Instale IronBarcode com o Gerenciador de Pacotes NuGet

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

    IronBarCode.BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode, 250, 250).SaveAsPng("myQRCode.png");
  3. Implante para testar em seu ambiente de produção.

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

    arrow pointer

O que são códigos de barras 2D e quando devo usá-los?

Códigos de barras bidimensionais como QR Codes usam uma grade de quadrados ou pontos para armazenar informações horizontal e verticalmente. Em contraste, códigos de barras lineares unidimensionais usam uma única linha de linhas para armazenar dados. Enquanto os códigos de barras padrão contêm apenas alguns números ou letras, códigos 2D podem armazenar grandes quantidades de dados — incluindo links da web, detalhes de ID ou arquivos inteiros — sem exigir uma conexão de banco de dados.

Esse design robusto torna os códigos de barras 2D incrivelmente duráveis. A correção de erros embutida permite a leitura mesmo quando os códigos de barras estão arranhados, rasgados ou marcados, onde códigos padrão falhariam. Isso torna os códigos de barras 2D ideais para ambientes rigorosos ou escaneamento móvel onde condições perfeitas não são garantidas. Para mais informações sobre ajuste fino da correção de erro, veja nosso guia de correção de erro.

Vamos explorar todos os formatos de código de barras 2D suportados pelo IronBarcode, demonstrar como criá-los e discutir seu uso comum. Cada formato tem características únicas adequadas a aplicações específicas.

Como criar um código de barras Aztec para bilhetagem móvel?

O Código Aztec é uma matriz 2D de alta densidade reconhecida por seu padrão de alvo quadrado no centro. Ao contrário de outros formatos, os códigos Aztec são eficientes em termos de espaço e armazenam dados em um formato quadrado compacto.

A vantagem única do código Aztec é que ele não requer uma zona de silêncio, ao contrário de outros códigos de barras. É comumente usado para bilhetagem móvel, como passes de embarque eletrônicos e pulseiras de pacientes em hospitais. Companhias aéreas e sistemas de transporte preferem este formato por seu tamanho compacto e excelente legibilidade nas telas de smartphones.

Código

IronBarcode torna a geração de códigos Aztec simples: passe BarcodeEncoding.Aztec como o segundo parâmetro ao chamar o método Create, depois exporte o resultado como uma imagem. Você pode ainda customizar a aparência usando as opções de estilo do IronBarcode.

:path=/static-assets/barcode/content-code-examples/how-to/create-aztec-barcode.cs
using IronBarCode;

// Create the Aztec barcode
GeneratedBarcode AztecCode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.Aztec);

// Display the value below the barcode
AztecCode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
AztecCode.SaveAsJpeg("aztec-sample.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de código de barras Aztec mostrando o padrão de alvo característico

Como criar um código de barras DataMatrix para marcação de peças industriais?

O Data Matrix é uma matriz 2D compacta reconhecida pelo seu padrão de localização em forma de L no perímetro. Este formato se destaca onde o espaço é limitado e a durabilidade é crítica.

A força única do Data Matrix é sua durabilidade extrema e capacidade de reduzir para tamanhos microscópicos para marcação direta de peças (DPM). É comumente usado para rastreamento industrial em instrumentos cirúrgicos, componentes eletrônicos e peças aeroespaciais onde o espaço é extremamente limitado. O tamanho compacto do formato e a alta densidade de dados são perfeitos para criar códigos de barras a partir de vários tipos de dados, incluindo números de série e códigos de lotes.

Código

IronBarcode torna a geração de códigos DataMatrix simples: passe BarcodeEncoding.DataMatrix como o segundo parâmetro ao chamar o método Create, depois exporte o resultado como uma imagem.

:path=/static-assets/barcode/content-code-examples/how-to/create-datamatrix-barcode.cs
using IronBarCode;

// Create the DataMatrix barcode
GeneratedBarcode DataMatrix = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.DataMatrix);

// Display the value below the barcode
DataMatrix.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
DataMatrix.SaveAsJpeg("dataMatrix-sample.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de código de barras DataMatrix exibindo o padrão localizador em forma de L

Como crio um código de barras MaxiCode para etiquetas de envio?

MaxiCode é uma matriz 2D de tamanho fixo reconhecida por seu padrão circular de alvo cercado por uma grade hexagonal. Este design exclusivo foi desenvolvido especificamente para escaneamento em alta velocidade em esteiras transportadoras.

O aspecto único do MaxiCode é seu tamanho físico constante de 1 polegada, independente dos dados armazenados, otimizando-o para leitura em alta velocidade em esteiras transportadoras. É comumente usado em logística e gerenciamento da cadeia de suprimentos, especificamente em etiquetas de envio da UPS para classificação e roteamento automatizados de pacotes. O tamanho fixo garante desempenho de escaneamento consistente, independentemente da carga de dados.

Código

IronBarcode torna a geração de MaxiCode simples: passe BarcodeEncoding.MaxiCode como o segundo parâmetro ao chamar o método Create, depois exporte como uma imagem. Para mais exemplos, consulte nosso guia de início rápido de código de barras.

:path=/static-assets/barcode/content-code-examples/how-to/create-maxicode-barcode.cs
using IronBarCode;

// Create the MaxiCode barcode
GeneratedBarcode MaxiCode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.MaxiCode);

// Display the value below the barcode
MaxiCode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
MaxiCode.SaveAsJpeg("maxiCode-sample.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de código de barras MaxiCode com padrão hexagonal e alvo circular

Como crio um código de barras PDF417 para cartões de identificação?

PDF417 é um código de barras linear em pilha reconhecido por sua aparência ampla e retangular, assemelhando-se a estática digital. Este formato codifica significativamente mais dados que outros formatos 2D, tornando-o ideal para armazenar informações detalhadas.

A capacidade única do PDF417 é servir como um arquivo de dados portátil, armazenando grandes quantidades de dados como fotos, nomes e registros biométricos sem necessidade de conexões de banco de dados. É comumente usado para identificação governamental, como carteiras de motorista e cartões de embarque impressos de companhias aéreas. O formato suporta a codificação de dados textuais e binários.

Código

IronBarcode torna a geração de PDF417 simples: passe BarcodeEncoding.PDF417 como o segundo parâmetro ao chamar o método Create, depois exporte como uma imagem. Você também pode salvar códigos de barras em vários formatos de imagem, incluindo PNG, JPEG, e mais.

:path=/static-assets/barcode/content-code-examples/how-to/create-pdf417-barcode.cs
using IronBarCode;

// Create PDF417 barcode
GeneratedBarcode PDF417code = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.PDF417);

// Display the value below the barcode
PDF417code.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
PDF417code.SaveAsJpeg("pdf417-sample.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de código de barras PDF417 mostrando padrão linear em pilha

Como crio um Código QR para campanhas de marketing?

Um Código QR é uma matriz 2D de alta densidade reconhecida por três padrões localizadores quadrados distintivos em seus cantos. Como o formato de código de barras 2D mais amplamente reconhecido, os códigos QR se tornaram onipresentes em aplicativos de consumo.

A vantagem única do Código QR é a acessibilidade universal para o consumidor — é a única simbologia 2D suportada nativamente por praticamente todos os aplicativos de câmera de smartphones modernos sem software adicional. É comumente usado para marketing e engajamento público, vinculando a sites e menus digitais, e facilitando pagamentos móveis. Para geração avançada de código QR, explore nossos exemplos de criação de código QR.

Código

IronBarcode torna a geração de códigos QR simples: passe BarcodeEncoding.QRCode como o segundo parâmetro ao chamar o método Create, depois exporte como uma imagem. Você também pode personalizar os estilos de código QR, adicionando logotipos e alterando cores.

:path=/static-assets/barcode/content-code-examples/how-to/create-QRCode.cs
using IronBarCode;

// Create QR Code
GeneratedBarcode QRcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);

// Display the value below the barcode
QRcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
QRcode.SaveAsJpeg("QRcode.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de Código QR com três padrões localizadores de canto

Como crio um Micro Código QR para eletrônicos pequenos?

Um Micro Código QR é uma matriz 2D miniaturizada reconhecida por seu padrão localizador quadrado único no canto superior esquerdo. Este formato foi projetado especificamente para aplicações onde o espaço é extremamente limitado.

A vantagem única do Micro Código QR é se ajustar a espaços extremamente apertados reduzindo o overhead, exigindo apenas uma zona de silêncio de dois módulos em comparação com a padrão de quatro, enquanto troca capacidade de dados por compactação física. É comumente usado para marcar pequenos componentes eletrônicos, placas de circuito impresso (PCBs) e peças industriais onde os códigos QR padrão são muito grandes.

Devido ao seu tamanho miniaturizado, aplicam-se limites de caracteres. A versão maior (M4) comporta um máximo de 21 caracteres alfanuméricos ou 35 números. Planeje cuidadosamente sua estratégia de codificação de dados ao usar Micro códigos QR.

Código

IronBarcode torna a geração de MicroQRCode simples: passe BarcodeEncoding.MicroQRCode como o segundo parâmetro ao chamar o método Create, depois exporte como uma imagem.

:path=/static-assets/barcode/content-code-examples/how-to/create-microQR.cs
using IronBarCode;

// Create a Micro QR Code
GeneratedBarcode microQRcode = BarcodeWriter.CreateBarcode("IRON-1234", BarcodeEncoding.MicroQRCode);

// Display the value below the barcode
microQRcode.AddBarcodeValueTextBelowBarcode();

// Save to file as Jpeg
microQRcode.SaveAsJpeg("microQRCode.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de Micro Código QR com padrão localizador único

O que acontece se meus dados excederem a capacidade do Micro QR?

IronBarcode lança um erro se a string de entrada exceder 35 dígitos numéricos ou 21 caracteres alfanuméricos. Esta validação embutida ajuda a prevenir erros de execução em ambientes de produção.

Mensagem de erro exibida quando a capacidade de dados do Micro Código QR é excedida

Como crio um rMQR Code para espaços estreitos?

O Código QR Micro Retangular (rMQR) é uma matriz 2D especializada reconhecida por sua forma alongada e semelhante a uma tira e único padrão localizador no canto superior esquerdo. Este formato inovador aborda uma lacuna específica na tecnologia de códigos de barras.

A vantagem única do rMQR é se ajustar a espaços longos e estreitos onde códigos quadrados não podem—como bordas de molduras finas ou superfícies curvas. Ele preenche a lacuna entre a pequena pegada do Micro QR e a alta capacidade do QR Code padrão, exigindo apenas uma zona de silêncio de dois módulos. É comumente usado para marcar cabos, tubos de ensaio, frascos médicos e componentes eletrônicos finos onde a altura é severamente restrita.

Devido ao seu design retangular, estende-se horizontalmente para aumentar a capacidade sem aumentar a pegada vertical. A maior versão (R17x139) contém até 219 caracteres alfanuméricos ou 361 números – significativamente mais capaz que o Micro QR enquanto mantém um perfil esbelto.

Código

IronBarcode torna a geração de RMQRCode simples: passe BarcodeEncoding.RMQRCode como o segundo parâmetro ao chamar o método Create, depois exporte como uma imagem. Para uma visão geral abrangente de todos os recursos do IronBarcode, visite nossa referência de API.

:path=/static-assets/barcode/content-code-examples/how-to/create-rmQRcode.cs
using IronBarCode;

// Create a  RmQR Code
GeneratedBarcode rMqrCode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.RMQRCode);

// Display the value below the barcode
rMqrCode.AddBarcodeValueTextBelowBarcode();

// Save to file as Jpeg
rMqrCode.SaveAsJpeg("rmQRcode.jpg");
$vbLabelText   $csharpLabel

Saída

Exemplo de Código rMQR mostrando formato retangular

O que acontece se meus dados excederem a capacidade do rMQR?

IronBarcode lança um erro se a string de entrada exceder 361 dígitos numéricos ou 219 caracteres alfanuméricos. Essa validação garante que seus códigos de barras permaneçam escaneáveis e compatíveis com a especificação do rMQR.

Mensagem de erro mostrada quando o limite de capacidade do Código rMQR é excedido

Qual formato de código de barras 2D devo escolher?

Nome Formatar Uso Comum Restrições e Armadilhas
**Código Aztec** **Matriz (Centro-Fora)**
Grade quadrada com "alvo" centralizador. Não requer zona de silêncio.
Cartões de embarque móveis (Apple Wallet), bilhetes de trem e pulseiras de saúde.
  • **Dano ao Centro:** Depende do centralizador; dano ao alvo causa falha total.
  • **Reflexo na Tela:** Telas de telefone reflexivas podem cegar scanners padrão.
**Matriz de Dados** **Matriz (Padrão L)**
Quadrada ou retangular com borda sólida "L" em dois lados.
Componentes eletrônicos, instrumentos cirúrgicos e Marca Direta em Peça (DPM) em metal.
  • **Zona de Silêncio:** Requer borda branca de 1 módulo; gráficos na borda causam falhas.
  • **Contraste:** Metal brilhante (DPM) requer iluminação especializada para leitura.
**MaxiCode** **Matriz de Tamanho Fixo**
Exatamente 1x1 polegada. Pontos hexagonais com alvo circular central.
Etiquetas de envio UPS e classificação em esteira de alta velocidade.
  • **Tamanho Fixo:** Não pode encolher abaixo de 1 polegada de altura.
  • **Qualidade da Impressora:** Impressoras térmicas de baixa resolução distorcem hexágonos.
**PDF417** **Linear Empilhado**
Retângulo largo semelhante a estática digital. Alta capacidade.
Carteiras de Motorista (AAMVA), carteiras de identidade e cartões de embarque em papel.
  • **Truncamento:** Scanners portáteis frequentemente falham as bordas esquerda/direita.
  • **Crescimento de Tamanho:** O tamanho físico aumenta significativamente com mais dados.
**Código QR** **Matriz**
Quadrado com três padrões de localização de canto distintos.
Marketing ao consumidor, pagamentos, menus de restaurante, emparelhamento Wi-Fi.
  • **Zona de Silêncio:** Requer grande margem branca (4 módulos de largura).
  • **Densidade:** URLs longos sem encurtamento criam "estática" infocusável.
**Micro QR** **Matriz Miniatura**
Pequeno quadrado com apenas um padrão de localização de canto.
Placas de Circuito Impresso (PCBs), pequenos componentes elétricos.
  • **Limite de Capacidade:** Máximo de ~35 numéricos ou 21 caracteres alfanuméricos.
  • **Suporte ao Scanner:** Não é suportado por todos os aplicativos de câmera de smartphone.
**rMQR** **Matriz Retangular**
Faixa longa e estreita ligando Micro QR e QR padrão.
Tubos de ensaio, cabos, molduras finas, bordas estreitas de produtos.
  • **Novo Formataro:** Suporte crescente, mas não universal em scanners legados.
  • **Proporção:** Projetado estritamente para espaços estreitos.

Perguntas frequentes

Quais formatos de código de barras 2D posso criar em C#?

O IronBarcode é compatível com todos os principais formatos de código de barras 2D, incluindo QR Code, Aztec, DataMatrix, MaxiCode, PDF417 e o novo formato rMQR. Com suporte para mais de 30 formatos de código de barras no total, o IronBarcode oferece uma solução completa para gerar qualquer tipo de código de barras 2D que você precise em seus aplicativos C#.

Como faço para gerar um código QR em apenas uma linha de código?

Você pode criar um código QR com uma única linha usando o IronBarcode: `var myBarcode = BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode);` Esta simples chamada de API gera um código QR totalmente funcional que você pode salvar como imagem ou exportar em vários formatos.

Os códigos de barras 2D permanecem legíveis se estiverem danificados?

Sim, os códigos de barras 2D gerados com o IronBarcode incluem correção de erros integrada, garantindo que seus dados permaneçam acessíveis mesmo quando o código de barras estiver rasgado, arranhado ou marcado. Eles também podem ser lidos de qualquer ângulo e não exigem alinhamento perfeito, o que os torna ideais para condições de leitura desafiadoras.

Qual formato de código de barras 2D devo usar para bilhetes eletrônicos?

Para aplicações de bilhetagem móvel, o IronBarcode pode gerar códigos Aztec, que apresentam um design compacto sem bordas, perfeito para telas de dispositivos móveis. Você também pode usar códigos QR para aplicações móveis em geral ou explorar outros formatos, como DataMatrix para usos industriais ou PDF417 para cartões de identificação.

Quanta informação os códigos de barras 2D podem armazenar em comparação com os códigos de barras tradicionais?

Enquanto os códigos de barras 1D tradicionais armazenam apenas alguns números ou letras, os códigos de barras 2D criados com o IronBarcode podem armazenar milhares de caracteres, incluindo links da web, informações detalhadas de identificação e muito mais. A capacidade exata depende do formato: o PDF417 oferece enorme capacidade de armazenamento offline, enquanto o DataMatrix fornece precisão industrial para componentes menores.

Em que formatos de arquivo posso salvar meus códigos de barras 2D gerados?

O IronBarcode permite salvar seus códigos de barras 2D em vários formatos de imagem. Você pode usar SaveAsPng() para arquivos PNG, SaveAsJpeg() para imagens JPEG e vários outros métodos de exportação para salvar seus códigos de barras no formato que melhor atenda às necessidades da sua aplicação.

Posso gerar o novo formato de código de barras rMQR?

Sim, o IronBarcode suporta o novo formato rMQR (Micro QR Retangular), além dos códigos QR tradicionais e outros formatos 2D. Basta especificar BarcodeEncoding.rMQR ao criar seu código de barras para gerar essa variante retangular moderna do código QR.

Existe algum período de teste gratuito disponível para experimentar a geração de códigos de barras 2D?

Sim, o IronBarcode oferece um período de teste gratuito que permite experimentar todos os recursos de geração de códigos de barras 2D antes de comprar. Você pode baixar a biblioteca via NuGet e começar a criar códigos QR, DataMatrix, códigos Aztec e outros formatos 2D imediatamente para avaliar se ela atende às suas necessidades.

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 2,108,094 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package BarCode
executar um exemplo Veja seu fio se transformar em um código de barras.