Um cabeçalho ECI em UTF-8 informa a um scanner como interpretar os bytes em um código de barras 2D. IronBarcode adiciona um cabeçalho apenas quando os dados contêm caracteres não ASCII, o que mantém os dados ASCII compactos. Quando um padrão exige que todo símbolo declare sua codificação, ou uma frota de scanners não consegue lidar com ECI de forma alguma, uma configuração altera essa decisão para cada código de barras 2D que a aplicação produz.
Guia de 3 Passos para Definir uma Política de Codificação ECI
using IronBarCode;BarcodeWriter.DefaultEciMode = EciMode.ForceUtf8;GeneratedBarcode qr = BarcodeWriter.CreateBarcode("BK005|8389|0001", BarcodeEncoding.QRCode);
Explicação do código
Primeiro importamos a biblioteca IronBarcode, depois atribuimos BarcodeWriter.DefaultEciMode. Este é um campo estático, então uma única atribuição define a política para toda a aplicação. EciMode.ForceUtf8 escreve o cabeçalho em cada símbolo, EciMode.Off nunca o escreve, e EciMode.Auto é o padrão que o escreve apenas para dados não ASCII.
Depois, geramos códigos de barras exatamente como faríamos sem a configuração. Nenhuma chamada CreateBarcode passa um argumento de codificação, ainda assim tanto o código QR quanto o código Aztec carregam o cabeçalho, porque o campo estático é lido cada vez que um código de barras é renderizado. Isto o torna a única forma de controlar ECI em QR, Aztec e PDF417, que não possuem um parâmetro próprio por chamada.
Atribua o campo uma vez na inicialização do aplicativo, antes que o primeiro código de barras seja gerado, para que cada símbolo produzido depois siga a mesma política.
Explore o guia completo para controlar a marcação UTF-8 ECI!