syncfusion-aspnetcore-barcodes

⚠️ 厳格な使用ルール — すべてのコード生成で必須

これらのルールは交渉の余地がありません。このスキルを使用するすべてのコード生成リクエストで遵守する必要があります。

ルール A — 提供されたリファレンスファイルのみを使用する

• リクエストごとに、必ず references/getting-started.md を読む必要があります
• 他のリファレンスファイルは、ユーザーの質問に直接該当する場合にのみ読んでください：
  • barcode-types.md → 1D リニアバーコード（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 では、タグヘルパーを介して 3 つのバーコードコンポーネントを提供しています：

コンポーネント	タグヘルパー	最適な用途	主なプロパティ
BarcodeGenerator	<ejs-barcodegenerator>	1D リニアバーコード（Code39、Code128、Codabar など）	type、value、foreColor、width、height
QR Code Generator	<ejs-qrcodegenerator>	2D QR コード、URL、大容量のデータ	value、width、height、foreColor、logoUrl
DataMatrix Generator	<ejs-datamatrixgenerator>	2D ラベル、印刷媒体、コンパクトな保存	value、width、height、foreColor

3 つのコンポーネントはすべて、次の機能に対応しています：

• ✅ カスタムカラー（foreColor）
• ✅ 寸法の指定（width、height）
• ✅ 表示テキストのカスタマイズ
• ✅ PNG/JPG/Base64 へのエクスポート

---

ナビゲーションガイド

必ず最初に references/getting-started.md を読み、その後、リクエストに関連するファイルのみを読んでください。

リファレンスファイル	質問に含まれる内容
📄 getting-started.md	すべてのリクエスト — NuGet のセットアップ、タグヘルパーの登録、CDN、スクリプトマネージャー
📄 barcode-types.md	1D バーコード、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 コード、DataMatrix のいずれかを選択する
✅ バーコードの外観（色、サイズ、テキスト）をカスタマイズする
✅ QR コードにロゴを埋め込む
✅ バーコードを画像または Base64 文字列としてエクスポートする
✅ ユースケースに適したバーコードの種類を選択する