Como escrever códigos de barras Unicode e em idiomas internacionais em C# | IronPDF

How to Write UTF-8 & Unicode Barcodes in C#

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

IronBarcode permite que os desenvolvedores codifiquem texto UTF-8 — incluindo chinês, árabe, tailandês e outros scripts internacionais — em códigos de barras usando formatos como DataMatrix e Código QR, que suportam nativamente caracteres UTF-8 para etiquetagem de produtos internacionais.

Inicio rápido: Crie um Código de Barras Unicode com Codificação DataMatrix

Gere um código de barras contendo texto Unicode multilíngue usando IronBarcode em uma linha e depois salve-o como uma imagem.

  1. Instale IronBarcode com o Gerenciador de Pacotes NuGet

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

    var barcode = IronBarCode.BarcodeWriter.CreateBarcode("123 英語 اللغة العربية", IronBarCode.BarcodeWriterEncoding.DataMatrix);
    barcode.SaveAsImage("unicode.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

Como crio um Código de Barras UTF-8 com Idiomas Mistos?

IronBarcode suporta escrever e gerar códigos de barras em Unicode (codificado em UTF-8), permitindo que os desenvolvedores criem strings que contenham vários idiomas como valores de código de barras. Por exemplo, uma string que inclua uma mistura de chinês, árabe e tailandês pode ser tratada diretamente.

O suporte Unicode na geração de códigos de barras é essencial para aplicações globais, permitindo que empresas criem rótulos de produtos, documentos de envio e sistemas de identificação que funcionem em diferentes idiomas e regiões. A biblioteca IronBarcode fornece manipulação fácil de texto codificado em UTF-8, tornando-a a solução ideal para requisitos internacionais de códigos de barras.

Abaixo está a string a seguir que usaremos como valor de código de barras.

string unicodeText = "周態告応立待太記行神正用真最。音日独素円政進任見引際初携食。更火識将回興継時億断保媛全職。文造画念響竹都務済約記求生街東。天体無適立年保輪動元念足総地作靖権瀬内。失文意芸野画美暮実刊切心。感変動技実視高療試意写表重車棟性作家薄井。陸瓶右覧撃稿法真勤振局夘決。任堀記文市物第前兜純響限。囲石整成先尾未展退幹販山令手北結。أم يذكر النفط قبضتهم على, الصين وفنلندا ما حدى. تم لكل أملا المنتصر, ٣٠ حدى مارد القوى. شرسة للسيطرة قامفي. حتى أم يطول المحيط, زهاء وحلفاؤها من فعل. لم قامت الجو الساحلية وتم, ويعزى واقتصار قبل كل۔ภคนทลาพาธสตารเซฟต แชมป มารเกตตงลมเหลวโยเกรต แลนดบาบนอมครม รสโซ แบรนดไคลแมกซ พซซาโมเดลเสอโครง มอบโซนรายชอ แอดมชชน ดอกเตอร พะเรอ มารคเจไดโมจราสเบอรร เอนทรานซออดชนศลปวฒนธรรมเปราะบาง โมจซเรยสวอลนตทรป";
string unicodeText = "周態告応立待太記行神正用真最。音日独素円政進任見引際初携食。更火識将回興継時億断保媛全職。文造画念響竹都務済約記求生街東。天体無適立年保輪動元念足総地作靖権瀬内。失文意芸野画美暮実刊切心。感変動技実視高療試意写表重車棟性作家薄井。陸瓶右覧撃稿法真勤振局夘決。任堀記文市物第前兜純響限。囲石整成先尾未展退幹販山令手北結。أم يذكر النفط قبضتهم على, الصين وفنلندا ما حدى. تم لكل أملا المنتصر, ٣٠ حدى مارد القوى. شرسة للسيطرة قامفي. حتى أم يطول المحيط, زهاء وحلفاؤها من فعل. لم قامت الجو الساحلية وتم, ويعزى واقتصار قبل كل۔ภคนทลาพาธสตารเซฟต แชมป มารเกตตงลมเหลวโยเกรต แลนดบาบนอมครม รสโซ แบรนดไคลแมกซ พซซาโมเดลเสอโครง มอบโซนรายชอ แอดมชชน ดอกเตอร พะเรอ มารคเจไดโมจราสเบอรร เอนทรานซออดชนศลปวฒนธรรมเปราะบาง โมจซเรยสวอลนตทรป";
$vbLabelText   $csharpLabel

Em seguida, chamamos o método BarcodeWriter.CreateBarcode para criar o código de barras desejado. O método recebe dois valores: o texto e a codificação. Saiba mais sobre criando códigos de barras a partir de vários tipos de dados, incluindo URLs, IDs e dados binários.

:path=/static-assets/barcode/content-code-examples/how-to/writing-in-unicode-write.cs
using IronBarCode;

// Unicode text with Chinese, Arabic and Thai characters
string text = "周態告応立待太記行神正用真最。音日独素円政進任見引際初携食。更火識将回興継時億断保媛全職。文造画念響竹都務済約記求生街東。天体無適立年保輪動元念足総地作靖権瀬内。失文意芸野画美暮実刊切心。感変動技実視高療試意写表重車棟性作家薄井。陸瓶右覧撃稿法真勤振局夘決。任堀記文市物第前兜純響限。囲石整成先尾未展退幹販山令手北結。أم يذكر النفط قبضتهم على, الصين وفنلندا ما حدى. تم لكل أملاً المنتصر, ٣٠ حدى مارد القوى. شرسة للسيطرة قامفي. حتى أم يطول المحيط, زهاء وحلفاؤها من فعل. لم قامت الجو الساحلية وتم, ويعزى واقتصار قبل كل。ภคันทลาพาธสตาร์เซฟตี้ แชมป์ มาร์เก็ตติ้งล้มเหลวโยเกิร์ต แลนด์บาบูนอึมครึม รุสโซ แบรนด์ไคลแม็กซ์ พิซซ่าโมเดลเสือโคร่ง ม็อบโซนรายชื่อ แอดมิชชั่น ด็อกเตอร์ พะเรอ มาร์คเจไดโมจิราสเบอร์รี เอนทรานซ์ออดิชั่นศิลปวัฒนธรรมเปราะบาง โมจิซีเรียสวอลนัตทริป";

// Create a DataMatrix barcode with the specified text
var myBarcode = BarcodeWriter.CreateBarcode(text, BarcodeWriterEncoding.DataMatrix);

// Save the barcode as an image
myBarcode.SaveAsImage("Unicode.jpeg");
$vbLabelText   $csharpLabel

Este é o arquivo gerado pelo código:

Saída de Código de Barras Unicode

Para opções de estilo aprimoradas, você também pode personalizar seus códigos de barras Unicode com cores, margens e anotações para atender a requisitos específicos de branding.


Quais Tipos de Código de Barras Suportam Caracteres Unicode?

O suporte Unicode varia por tipo de código de barras. Apenas formatos de código de barras selecionados suportam nativamente Unicode e armazenam diretamente texto Unicode sem soluções alternativas de codificação. Além da codificação DataMatrix que fizemos acima, aqui está uma lista rápida de tipos de codificação que suportam Unicode.

Tipo de Código de Barras Suporte a Unicode Ideal para Capacidade Máxima
Código QR UTF-8 Completo (modo Kanji para CJK) Marketing, etiquetas multilíngues, IDs ~3.000 caracteres (alfanuméricos)
Matriz de dados Com ECI (Interpretação de Canal Estendido) Etiquetas de itens pequenos, industriais ~1.556 bytes
PDF417 Com ECI (mas com suporte de scanner limitado) Documentos (cartões de embarque, IDs) ~1.100 bytes
Código Asteca UTF-8 nativo Bilhetes móveis, passes de companhia aérea ~3.000 caracteres

Observe a diferença no número de caracteres que você pode encaixar com cada tipo de codificação de código de barras. Por exemplo, usar a string acima com PDF417 não funcionará, pois contém mais de 500 caracteres Unicode. Neste caso, você precisa implementar uma solução alternativa para que funcione. Portanto, é importante observar o comprimento da sua string.

Os tipos de código de barras listados acima estão todos disponíveis a partir de BarcodeWriterEncoding.

Para uma lista completa de todos os tipos de codificação de código de barras disponíveis a partir de BarcodeWriterEncoding, por favor, consulte nossa documentação de formatos de código de barras suportados.

Melhores Práticas para Geração de Codigos de Barras Unicode

Ao trabalhar com códigos de barras Unicode, considere estes fatores importantes:

  1. Codificação de Caracteres: Sempre certifique-se de que seu texto de origem está devidamente codificado em UTF-8 antes de gerar códigos de barras
  2. Compatibilidade do Scanner: Verifique se os seus scanners de código de barras suportam a decodificação Unicode para o tipo de código de barras escolhido
  3. Tamanho dos Dados: Monitore o tamanho em bytes do seu texto Unicode, pois caracteres como chinês ou árabe normalmente requerem 2-3 bytes cada
  4. Correção de Erros: Para aplicações críticas, use níveis maiores de correção de erros para garantir uma digitalização confiável

Para geração de Código QR especificamente, confira nosso tutorial abrangente sobre Gerador de Código QR em C# que inclui técnicas avançadas de manipulação de Unicode.

How Do I Read Unicode Barcodes in C#?

Além de escrever em Unicode, IronBarcode também suporta leitura de códigos de barras Unicode. Para ler o código de barras, usamos o método Read da classe BarcodeReader com o parâmetro fornecido sendo o código de barras Unicode.

Aqui está um exemplo rápido usando o código de barras Unicode gerado acima:

:path=/static-assets/barcode/content-code-examples/how-to/writing-in-unicode-read.cs
using IronBarCode;
using System.IO;

// Reading the Unicode barcode
BarcodeResults result = BarcodeReader.Read("Unicode.jpeg");

// Output the text value from the barcode to a txt file
File.WriteAllText("text.txt", result[0].Text);
$vbLabelText   $csharpLabel

Observe que, embora você possa exibir o valor do texto em um terminal com Console.WriteLine, o terminal não suporta nativamente a exibição de caracteres Unicode e requer configuração adicional. Neste exemplo, direcionamos a saída para um arquivo txt em vez disso.

Saída

Editor de texto mostrando texto Unicode multilíngue em scripts chinês, árabe e tailandês para exemplo de codificação de código de barras

Casos de Uso Comuns para Códigos de Barras Unicode

A geração de códigos de barras Unicode serve para numerosas aplicações práticas em indústrias globais:

  • Rotulagem de Produtos Internacionais: Crie rótulos de produtos que exibam informações em vários idiomas para distribuição global
  • Logística e Transporte: Gere etiquetas de envio com endereços em scripts nativos para entrega internacional precisa
  • Cuidados de Saúde: Codifique informações de pacientes, incluindo nomes em línguas nativas, para registros médicos e prescrições
  • Gestão de Eventos: Crie ingressos e passes com nomes de convidados em seus scripts nativos
  • Gestão de Documentos: Gere identificadores de documentos contendo metadados em vários idiomas

Para operações de código de barras mais avançadas, explore nossa documentação de Referência de API para descobrir todas as capacidades do suporte Unicode do IronBarcode.

Perguntas frequentes

Por que eu precisaria gerar códigos de barras Unicode?

A geração de códigos de barras Unicode é essencial para dar suporte a idiomas internacionais como o chinês, o árabe e outros, permitindo que as empresas operem em diferentes regiões e se comuniquem de forma eficaz com públicos diversos.

O IronBarcode consegue lidar com caracteres Unicode?

Sim, o IronBarcode suporta a geração de códigos de barras com caracteres Unicode, possibilitando a codificação de texto em vários idiomas internacionais, incluindo chinês e árabe.

Que tipos de códigos de barras posso criar com caracteres Unicode usando o IronBarcode?

Com o IronBarcode, você pode criar diversos tipos de códigos de barras, como códigos QR e Code 128, usando caracteres Unicode. Essa flexibilidade é ideal para aplicações que exigem internacionalização.

É possível personalizar a aparência dos códigos de barras Unicode no IronBarcode?

Sim, o IronBarcode permite personalizar a aparência dos códigos de barras Unicode, incluindo tamanho, cor e fonte do texto, garantindo que os códigos de barras atendam aos seus requisitos específicos de design e identidade visual.

Preciso de algum software específico para ler códigos de barras Unicode criados com o IronBarcode?

Não é necessário nenhum software especial para ler códigos de barras Unicode criados com o IronBarcode. Leitores de código de barras padrão e aplicativos de software capazes de ler o formato específico do código de barras podem interpretá-los.

Posso gerar códigos de barras com uma combinação de caracteres Unicode e ASCII?

Sim, o IronBarcode suporta a geração de códigos de barras que contêm uma combinação de caracteres Unicode e ASCII, oferecendo flexibilidade na codificação de uma ampla gama de dados.

Como o IronBarcode lida com idiomas RTL (da direita para a esquerda), como o árabe?

O IronBarcode é capaz de lidar com idiomas da direita para a esquerda, como o árabe, codificando corretamente a direção do texto nos códigos de barras gerados, garantindo uma representação precisa e legibilidade.

Quais são as vantagens de usar o IronBarcode para geração de códigos de barras Unicode?

O IronBarcode oferece facilidade de uso, compatibilidade com vários formatos de código de barras, suporte para idiomas internacionais e opções de personalização, tornando-o uma escolha ideal para gerar códigos de barras Unicode.

Existe um limite para o número de caracteres que posso codificar em um código de barras Unicode com o IronBarcode?

O número de caracteres que você pode codificar em um código de barras Unicode com o IronBarcode depende do tipo e tamanho do código de barras. No entanto, o IronBarcode foi projetado para lidar com grandes quantidades de dados de forma eficiente.

O IronBarcode consegue gerar códigos de barras para aplicações desktop e mobile?

Sim, o IronBarcode pode gerar códigos de barras adequados tanto para aplicações desktop quanto para dispositivos móveis, oferecendo versatilidade em diferentes plataformas e dispositivos.

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.