syncfusion-blazor-barcode

Syncfusion Blazor Barcode Generator

Syncfusion の Blazor Barcode Generator パッケージ（Syncfusion.Blazor.BarcodeGenerator）は、Blazor アプリケーションでバーコードを生成するための 4 つのコンポーネントを提供します。

コンポーネント	用途
SfBarcodeGenerator	1D リニアバーコード（Code39、Code128、Codabar など）に加え、GS1 Code 128、ITF-14、GS1 DataBar ファミリー全種
SfQRCodeGenerator	ロゴを任意で埋め込める QR コードに加え、GS1 QR Code（EnableGS1）
SfDataMatrixGenerator	コンパクトなエンコード向けの 2D Data Matrix コードに加え、GS1 Data Matrix（EnableGS1）
SfDotCodeGenerator	高密度ドットマトリックスの DotCode シンボルに加え、GS1 DotCode（EnableGS1）

4 つすべてが Blazor Server、Blazor WebAssembly、Blazor Web App（.NET 8+）で動作します。

---

このスキルを使用する場面

• ユーザーが Blazor コンポーネントでバーコードをレンダリングまたは表示する必要がある場合
• ユーザーが QR コードの生成について質問している場合（例：商品リンク、2FA、連絡先カード）
• ユーザーが 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 Code、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 のセットアップ
• ページへの最初のバーコードコンポーネントの追加

1D バーコードの種類と設定

📄 参照先： references/barcode-types.md

• 説明付きの、サポートされているすべての BarcodeType 列挙値
• Code39、Code39 Extended、Code11、Code32、Code93、Codabar、Code128
• ユースケースに適した種類の選択
• EnableCheckSum の設定
• OnValidationFailed イベントの処理

QR Code Generator

📄 参照先： references/qr-code-generator.md

• QR コードの基本的な使用方法
• 誤り訂正レベル（L、M、Q、H）
• QR コード中央へのロゴ画像の埋め込み
• ロゴサイズのカスタマイズ
• 色、寸法、表示テキストのカスタマイズ
• OnValidationFailed イベント

Data Matrix Generator

📄 参照先： references/data-matrix-generator.md

• Data Matrix コードの基本的な使用方法
• 色、寸法、表示テキストのカスタマイズ
• 一般的な用途（医薬品、ラベル）
• OnValidationFailed イベント

DotCode Generator

📄 参照先： 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 の全ファミリー：Omnidirectional、Stacked、Stacked Omnidirectional、Limited、Expanded、Expanded Stacked
• 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 対応モードを含む、4 種類すべてのジェネレータータイプに適用されます

---

クイックスタートの例

1D バーコード

@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 準拠の 1D バーコード）

@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 の各バリアントを含む 1D シンボル体系を選択します
ForeColor	すべて	バーコードのバーの色（例："red"、"#333"）
EnableCheckSum	SfBarcodeGenerator	チェックサムの桁を追加／検証します（Code39 では既定値は true）
ErrorCorrectionLevel	SfQRCodeGenerator	QR の誤り訂正レベル：Low、Medium、Quartile、High
EnableGS1	SfQRCodeGenerator、SfDataMatrixGenerator、SfDotCodeGenerator	コンポーネントを GS1 モードに切り替え、FNC1 を処理しながら Value を (AI)data のペアとしてエンコードします
OnValidationFailed	すべて	Value に無効な文字、形式が不正な AI 構文、または無効なチェックデジットが含まれている場合に発生するイベント

---

一般的な用途

ニーズ	コンポーネント	参照先
製品／在庫ラベル	SfBarcodeGenerator（Code128/Code39）	barcode-types.md
URL／連絡先／2FA の QR コード	SfQRCodeGenerator	qr-code-generator.md
ロゴ付きのブランド QR コード	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	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