syncfusion-aspnetcore-barcodes

⚠️ 严格使用规则 — 所有代码生成都必须遵守

这些规则不可协商。使用此技能进行任何代码生成请求时，都必须遵守。

规则 A — 仅使用提供的参考文件

• 每个请求都必须先阅读 references/getting-started.md
• 仅在其他参考文件与用户查询直接相关时才阅读：
  • barcode-types.md → 一维线性条形码（Code39、Code128、Codabar 等）
  • qr-code.md → 可选择嵌入徽标的 QR 码
  • data-matrix.md → DataMatrix 条形码
  • customization.md → 颜色、尺寸、显示文本属性
  • export.md → PNG/JPG/Base64 导出功能
• 禁止使用外部知识：
  • ❌ 不要使用互联网文档
  • ❌ 不要依赖训练数据中的假设
  • ✅ 如果无法通过参考文件确认某项功能，请遵循规则 B

规则 B — 禁止猜测和推断

如果参考文件中未明确记载某项功能、属性、API 或行为：

你不得：

• 编造属性或方法
• 推断缺失的 API 或参数
• 假设已弃用或未记载的功能存在
• 根据其他 Syncfusion 组件进行概括

而应回复：

⚠️ NOT DOCUMENTED: [feature name] is not covered in the reference files.
Skipping this feature to avoid generating incorrect code.

---

条码组件概览

Syncfusion EJ2 ASP.NET Core 通过标记帮助程序提供三种条码组件：

组件	标记帮助程序	适用场景	主要属性
BarcodeGenerator	<ejs-barcodegenerator>	一维线性条形码（Code39、Code128、Codabar 等）	type、value、foreColor、width、height
QR Code Generator	<ejs-qrcodegenerator>	二维 QR 码、URL、大型负载	value、width、height、foreColor、logoUrl
DataMatrix Generator	<ejs-datamatrixgenerator>	二维标签、印刷介质、紧凑存储	value、width、height、foreColor

这三种组件均支持：

• ✅ 自定义颜色（foreColor）
• ✅ 尺寸控制（width、height）
• ✅ 自定义显示文本
• ✅ 导出为 PNG/JPG/Base64

---

导航指南

始终先阅读 references/getting-started.md，然后仅阅读与请求相关的文件。

参考文件	在查询涉及以下内容时阅读
📄 getting-started.md	每个请求 — NuGet 设置、标记帮助程序注册、CDN、脚本管理器
📄 barcode-types.md	一维条形码、Code39、Code128、Codabar、Code11、Code32、Code93、条形码选择指南
📄 qr-code.md	QR 码渲染、嵌入徽标、错误校正、版本（v1–v40）
📄 data-matrix.md	DataMatrix 概览、渲染、用例
📄 customization.md	颜色（foreColor）、尺寸（width/height）、显示文本、渲染模式
📄 export.md	图像导出（PNG/JPG）、Base64 导出、导出方法

---

快速入门

1. 安装 NuGet 包

Install-Package Syncfusion.EJ2.AspNet.Core

2. 注册标记帮助程序（~/Pages/_ViewImports.cshtml）

@addTagHelper *, Syncfusion.EJ2

3. 添加 CDN 资源（~/Pages/Shared/_Layout.cshtml）

<head>
    <link rel="stylesheet" href="https://cdn.syncfusion.com/ej2/{{ site.ej2version }}/fluent.css" />
    <script src="https://cdn.syncfusion.com/ej2/{{ site.ej2version }}/dist/ej2.min.js"></script>
</head>
<body>
    ...
    <ejs-scripts></ejs-scripts>
</body>

4. 基本示例

BarcodeGenerator（Code128）

<ejs-barcodegenerator id="barcode"
    width="200px"
    height="150px"
    type="Code128"
    value="SYNCFUSION"
    mode="SVG">
</ejs-barcodegenerator>

QR 码

<ejs-qrcodegenerator id="qrcode"
    width="200px"
    height="200px"
    value="https://syncfusion.com"
    mode="SVG">
</ejs-qrcodegenerator>

DataMatrix

<ejs-datamatrixgenerator id="datamatrix"
    width="200px"
    height="150px"
    value="Syncfusion"
    mode="SVG">
</ejs-datamatrixgenerator>

---

常见模式

根据内容选择条码类型

用例	推荐类型	原因
仅数字，数据较短	Codabar 或 Code11	紧凑、简单
字母数字，大写	Code39	标签领域的行业标准
完整 ASCII、可变长度	Code128	用途最广、支持广泛
药品（意大利）	Code32	特定的法规要求
密集的字母数字数据	Code93	比 Code39 压缩效果更好
URL 或大型负载	QR Code	可处理复杂数据，可由手机扫描
需要紧凑存储的标签/印刷介质	DataMatrix	物流领域的行业标准

自定义颜色（所有生成器）

<ejs-barcodegenerator id="barcode"
    width="200px" height="150px"
    type="Code128" value="SYNCFUSION"
    foreColor="red" mode="SVG">
</ejs-barcodegenerator>

在 QR 码中嵌入徽标

<ejs-qrcodegenerator id="qrcode"
    width="200px" height="200px"
    value="https://syncfusion.com"
    logoUrl="logo.png"
    mode="SVG">
</ejs-qrcodegenerator>

点击按钮时导出条形码

<button onclick="exportBarcode()">Export as JPG</button>

<script>
  function exportBarcode() {
    var barcode = document.getElementById("barcode").ej2_instances[0];
    barcode.exportImage('MyBarcode', 'JPG');
  }
  
  function exportAsBase64() {
    var barcode = document.getElementById("barcode").ej2_instances[0];
    var base64String = barcode.exportAsBase64Image('PNG');
    console.log(base64String);
  }
</script>

隐藏显示文本

<ejs-barcodegenerator id="barcode"
    width="200px" height="150px"
    type="Code128" value="SYNCFUSION"
    displayText.visibility="false"
    mode="SVG">
</ejs-barcodegenerator>

---

何时使用此技能

✅ 在 ASP.NET Core 中渲染任意类型的条形码
✅ 在 BarcodeGenerator、QR Code 和 DataMatrix 之间进行选择
✅ 自定义条形码外观（颜色、尺寸、文本）
✅ 在 QR code 中嵌入徽标
✅ 将条形码导出为图像或 Base64 字符串
✅ 根据使用场景选择合适的条形码类型