syncfusion-blazor-barcode

Syncfusion Blazor 条码生成器

Syncfusion 的 Blazor 条码生成器包（Syncfusion.Blazor.BarcodeGenerator）提供四种组件，用于在 Blazor 应用中生成条码：

组件	用途
SfBarcodeGenerator	一维线性条码（Code39、Code128、Codabar 等），以及 GS1 Code 128、ITF-14 和完整的 GS1 DataBar 系列
SfQRCodeGenerator	QR 码，可选嵌入徽标，以及 GS1 QR 码（EnableGS1）
SfDataMatrixGenerator	用于紧凑编码的二维 Data Matrix 码，以及 GS1 Data Matrix（EnableGS1）
SfDotCodeGenerator	高密度点阵 DotCode 符号，以及 GS1 DotCode（EnableGS1）

这四种组件均适用于 Blazor Server、Blazor WebAssembly 和 Blazor Web App（.NET 8+）。

---

何时使用此技能

• 用户需要在 Blazor 组件中渲染或显示条码
• 用户询问 QR 码生成（例如，产品链接、双重身份验证、联系卡片）
• 用户需要 Data Matrix 码（制药、物流、标签打印）
• 用户需要用于高速工业／喷墨打印或产品序列化的 DotCode 符号
• 用户正在配置 SfBarcodeGenerator、SfQRCodeGenerator、SfDataMatrixGenerator 或 SfDotCodeGenerator
• 用户询问如何将条码导出为图像（JPG/PNG）或 Base64
• 用户询问条码类型、纠错、校验和或验证事件
• 用户要在 QR 码中嵌入徽标
• 用户询问 GS1 标准或符合 GS1 规范的条码：GS1 Code 128、ITF-14、GS1 DataBar（Omnidirectional、Stacked、Stacked Omnidirectional、Limited、Expanded、Expanded Stacked）、GS1 QR 码、GS1 Data Matrix 或 GS1 DotCode
• 用户正在构建零售、物流、仓储、库存管理、产品追溯或供应链标签功能
• 用户询问 GS1 应用标识符（AI）、FNC1 分隔符、EnableGS1 或 GTIN/SSCC 校验位计算

---

导航指南

设置项目

📄 阅读： references/getting-started.md

• NuGet 包安装
• _Imports.razor 命名空间配置
• 在 Program.cs 中注册服务
• 样式表和脚本引用
• 设置 Blazor Server、WebAssembly 和 Web App
• 在页面中添加第一个条码组件

一维条码类型和配置

📄 阅读： references/barcode-types.md

• 所有受支持的 BarcodeType 枚举值及其说明
• Code39、Code39 Extended、Code11、Code32、Code93、Codabar、Code128
• 为使用场景选择合适的类型
• EnableCheckSum 配置
• OnValidationFailed 事件处理

QR 码生成器

📄 阅读： references/qr-code-generator.md

• QR 码基本用法
• 纠错级别（L、M、Q、H）
• 在 QR 码中心嵌入徽标图像
• 自定义徽标大小
• 自定义颜色、尺寸和显示文本
• OnValidationFailed 事件

Data Matrix 生成器

📄 阅读： references/data-matrix-generator.md

• Data Matrix 码基本用法
• 自定义颜色、尺寸和显示文本
• 常见使用场景（制药、标签）
• OnValidationFailed 事件

DotCode 生成器

📄 阅读： references/dotcode-generator.md

• SfDotCodeGenerator 基本用法
• 数字、字母数字、字节和 GS1 编码模式
• 通过 EnableGS1 使用 GS1 DotCode 进行制药／医疗保健序列化
• 自定义颜色和尺寸
• OnValidationFailed 事件及错误原因

GS1 条码标准（零售、物流、供应链）

📄 阅读： references/gs1-barcodes.md

• GS1 应用标识符（AI）语法和验证规则
• 用于运输／批次／有效期标签的 GS1 Code 128（BarcodeType.GS1Code128）
• 用于纸箱／箱级 GTIN 跟踪的 ITF-14（BarcodeType.ITF14）
• 完整的 GS1 DataBar 系列：全向型、堆叠型、堆叠全向型、有限型、扩展型、扩展堆叠型
• 通过 EnableGS1 使用 GS1 QR Code 和 GS1 Data Matrix
• GS1 DotCode 概述（交叉链接至 dotcode-generator.md）
• 为零售、库存和产品追溯场景选择合适的 GS1 符号体系

导出和自定义条码

📄 阅读： references/export-and-customization.md

• 将条码导出为图像文件（JPG/PNG）
• 导出为 Base64 字符串
• 使用 ForeColor 自定义条码颜色
• 使用 Width / Height 设置尺寸
• 使用 BarcodeGeneratorDisplayText 设置标签文本
• 适用于全部四种生成器类型，包括启用 GS1 的模式

---

快速入门示例

一维条码

@using Syncfusion.Blazor.BarcodeGenerator

<SfBarcodeGenerator Width="200px" Height="150px"
                    Type="@BarcodeType.Code128"
                    Value="SYNCFUSION">
</SfBarcodeGenerator>

QR Code

@using Syncfusion.Blazor.BarcodeGenerator

<SfQRCodeGenerator Width="200px" Height="200px"
                   Value="https://www.syncfusion.com">
</SfQRCodeGenerator>

Data Matrix

@using Syncfusion.Blazor.BarcodeGenerator

<SfDataMatrixGenerator Width="200" Height="150"
                       Value="SYNCFUSION">
</SfDataMatrixGenerator>

DotCode

@using Syncfusion.Blazor.BarcodeGenerator

<SfDotCodeGenerator Width="300" Height="250"
                    Value="Product Serialization">
</SfDotCodeGenerator>

GS1 Code 128（符合 GS1 标准的一维条码）

@using Syncfusion.Blazor.BarcodeGenerator

<SfBarcodeGenerator Width="300px" Height="200px"
                    Type="@BarcodeType.GS1Code128"
                    Value="(01)09506000134352(17)261231(10)ABC123">
    <BarcodeGeneratorDisplayText Text="Product Serialization" />
</SfBarcodeGenerator>

GS1 QR Code（零售／追溯）

@using Syncfusion.Blazor.BarcodeGenerator

<SfQRCodeGenerator Width="250px" Height="250px"
                   Value="(01)09506000134352(17)271231(10)ABC123"
                   EnableGS1="true">
</SfQRCodeGenerator>

---

关键属性

属性	适用对象	说明
Value	全部	要编码的数据字符串
Width	全部	条码宽度（px 或 %）
Height	全部	条码高度（px 或 %）
Type	SfBarcodeGenerator	BarcodeType 枚举——选择一维符号体系，包括 GS1Code128、ITF14 和 GS1 DataBar 变体
ForeColor	全部	条码条纹的颜色（例如，"red"、"#333"）
EnableCheckSum	SfBarcodeGenerator	添加／验证校验位（Code39 默认值为 true）
ErrorCorrectionLevel	SfQRCodeGenerator	QR 错误恢复级别：低、中、四分位、高
EnableGS1	SfQRCodeGenerator、SfDataMatrixGenerator、SfDotCodeGenerator	将组件切换为 GS1 模式，并将 Value 编码为 (AI)data 对，同时处理 FNC1
OnValidationFailed	全部	当 Value 包含无效字符、格式错误的 AI 语法或无效校验位时触发的事件

---

常见使用场景

需求	组件	阅读
产品／库存标签	SfBarcodeGenerator（Code128/Code39）	barcode-types.md
URL／联系人／双重验证 QR Code	SfQRCodeGenerator	qr-code-generator.md
带徽标的品牌 QR Code	SfQRCodeGenerator + QRCodeLogo	qr-code-generator.md
药品／运输标签	SfDataMatrixGenerator	data-matrix-generator.md
工业／喷墨产品序列化	SfDotCodeGenerator	dotcode-generator.md
运输／批次／有效期标签（GS1）	SfBarcodeGenerator（GS1Code128）	gs1-barcodes.md
纸箱／箱级 GTIN 跟踪	SfBarcodeGenerator（ITF14）	gs1-barcodes.md
零售 POS 全向扫描	SfBarcodeGenerator（GS1DataBarOmnidirectional）	gs1-barcodes.md
小型包装／空间有限的 GTIN	SfBarcodeGenerator（GS1DataBarStacked/GS1DataBarLimited）	gs1-barcodes.md
可变计量商品或优惠券（多 AI）	SfBarcodeGenerator（GS1DataBarExpanded/ExpandedStacked）	gs1-barcodes.md
供应链／产品追溯 QR Code	SfQRCodeGenerator + EnableGS1	gs1-barcodes.md
紧凑型 GS1 标签（制药／制造）	SfDataMatrixGenerator + EnableGS1	gs1-barcodes.md
工业打印机上的 GS1 序列化	SfDotCodeGenerator + EnableGS1	dotcode-generator.md / gs1-barcodes.md
将条码下载为图像	.Export() 方法	export-and-customization.md
将条码嵌入电子邮件／PDF	.ExportAsBase64Image()	export-and-customization.md