Définir la politique d'encodage ECI
using IronBarCode;

// Set the ECI policy once for every 2D barcode
BarcodeWriter.DefaultEciMode = EciMode.ForceUtf8;

// Follows the policy with no further arguments
GeneratedBarcode qr = BarcodeWriter.CreateBarcode("BK005|8389|0001", BarcodeEncoding.QRCode);
qr.SaveAsPng("policy-qr.png");

// Aztec follows the same policy
GeneratedBarcode aztec = BarcodeWriter.CreateBarcode("BK005|8389|0001", BarcodeEncoding.Aztec);
aztec.SaveAsPng("policy-aztec.png");
Téléchargement NuGet
PM > Install-Package BarCode
Définir la politique d'encodage ECI

Définir la politique d'encodage ECI

Un en-tête ECI UTF-8 indique à un scanner comment interpréter les octets dans un code-barres 2D. IronBarcode n'en ajoute un que lorsque les données contiennent des caractères non ASCII, ce qui permet de garder les charges utiles ASCII compactes. Lorsque qu'un standard exige que chaque symbole déclare son encodage, ou qu'une flotte de scanners ne peut pas du tout gérer l'ECI, un réglage modifie cette décision pour chaque code-barres 2D que l'application produit.

Guide en 3 étapes pour définir une politique d'encodage ECI

  • using IronBarCode;
  • BarcodeWriter.DefaultEciMode = EciMode.ForceUtf8;
  • GeneratedBarcode qr = BarcodeWriter.CreateBarcode("BK005|8389|0001", BarcodeEncoding.QRCode);

Explication du code

Nous importons d'abord la bibliothèque IronBarcode, puis assignons BarcodeWriter.DefaultEciMode. Il s'agit d'un champ statique, donc une seule affectation définit la politique pour l'ensemble de l'application. EciMode.ForceUtf8 écrit l'en-tête sur chaque symbole, EciMode.Off ne l'écrit jamais, et EciMode.Auto est le paramètre par défaut qui l'écrit uniquement pour les données non ASCII.

Ensuite, nous générons des codes-barres exactement comme nous le ferions sans le réglage. Aucun appel CreateBarcode ne passe d'argument d'encodage, pourtant le code QR et le code Aztec portent tous deux l'en-tête, car le champ statique est lu chaque fois qu'un code-barres est rendu. Cela en fait le seul moyen de contrôler l'ECI sur QR, Aztec et PDF417, qui n'ont pas de paramètre par appel propre.

Attribuez le champ une fois au démarrage de l'application, avant que le premier code-barres ne soit généré, afin que tous les symboles produits par la suite suivent la même politique.

Explorez le guide complet pour contrôler le balisage UTF-8 ECI !

Prêt à commencer ?

Téléchargements NuGet 2,564,559Version :2026.11tout juste publié