NetBarcode vs IronBarcode：C#バーコードライブラリの比較

型列挙型設計境界

CODE-39065--@@@列挙は、NetBarcodeが生成できるものの権威あるリストです。 それを詳しく調べてみると、図書館の規模が明らかになる。

// ネットバーコード Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// ネットバーコード Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

' ネットバーコード Type enum — complete list as of v1.8
Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

これはプルリクエスト待ちの欠落機能ではありません。列挙型には14個のエントリがあり、すべて1次元で、これはライブラリの意図する範囲を反映しています。 QRコード、DataMatrix、PDF417、またはAztecを必要とするアプリケーションは、これらのフォーマットを提供するための別のパッケージを入手する必要があります。

詳細な機能比較

NetBarcodeアプローチ

NetBarcodeは、Type列挙型を通じて14種類のリニアバーコード形式を提供します。 その範囲内では、フォーマットの選択は簡単です。適切な列挙型メンバーをコンストラクタに渡せばよいのです。 境界線も同様に明確だ。列挙型の範囲外のフォーマットを使用しようとすると、コンパイル時エラーが発生する。

// ネットバーコード — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// ネットバーコード — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// ネットバーコード — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// ネットバーコード — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' ネットバーコード — formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

この境界が制約となる業界には、医薬品追跡（FDAの2次元バーコード義務付けに基づくDataMatrix）、航空会社の搭乗券（Aztec）、物流マニフェスト（PDF417）、モバイルマーケティング（QRコード）などがある。 これらの要件のいずれも、NetBarcodeを単独のソリューションとして利用することを不可能にする。

IronBarcodeのアプローチ

IronBarcodeはサポートしているすべてのフォーマットを同じBarcodeWriter.CreateBarcode@メソッドを通して公開します。 APIサーフェスは、1Dフォーマットから2Dフォーマットに移行しても変わりません。

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

サポートされている定数の完全なリストは、サポートされているバーコード形式のリファレンスに記載されており、すべての2次元バーコード生成形式とすべての1次元バーコード形式が網羅されています。

NetBarcodeアプローチ

NetBarcodeの生成モデルはコンストラクタベースです。 CODE-39079--@@@オブジェクトは、データ文字列とType列挙値でインスタンス化されます。 出力は、SaveImageFile()で直接保存されるか、GetImage()を介してImage<Rgba32>として取得されます。 バージョン1.8以降、GetImage()の戻り値の型はSixLabors.ImageSharp型であり、戻り値を保存または処理するコードはImageSharp APIをインポートして動作する必要があります。

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

CODE-39085--@@メソッドのリターンタイプは、ダウンストリームコードをImageSharpライブラリに結びつけます。 結果を受け取るか格納するメソッドは、Image<Rgba32>として宣言し、呼び出しコードに推移的依存関係を導入する必要があります。

IronBarcodeのアプローチ

IronBarcodeは流暢なチェーンを使用します。 CODE-39087--@@は、複数の出力メソッドを持つGeneratedBarcodeオブジェクトを返します。 画像処理は内部的に行われ、ImageSharp 型は呼び出し元のコードには公開されません。

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

幅、高さ、ラベル構成など、 1次元バーコード生成に関する詳細なオプションについては、 IronBarcodeのドキュメントに記載されています。

NetBarcodeアプローチ

NetBarcodeには読み取りAPIがありません。 バーコード画像をデータ文字列にデコードするメソッド、クラス、または設定は存在しません。 これは意図的な範囲設定であり、リリースまでの一時的な省略ではありません。 NetBarcodeでバーコードを生成し、後で印刷されたラベルの検証、返品商品のスキャン、仕入先請求書からの値の抽出などのためにそのバーコードを読み取る必要があるプロジェクトでは、その目的のために別のライブラリを導入する必要があります。

// ネットバーコード — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// ネットバーコード — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

' ネットバーコード — no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

ZXing .NETライブラリは、NetBarcodeと併用して読み取りを行う際に最も一般的に使用されるライブラリであり、NetBarcodeや既にQRコード用に追加された2Dライブラリに加えて、3つ目のAPIインターフェースと3つ目のパッケージを提供し、バージョン管理の対象となります。

IronBarcodeのアプローチ

IronBarcodeはBarcodeReaderを@@--CODE-39090--@と同じパッケージに含んでいます。 読み取りAPIは画像ファイルとPDFドキュメントを受け付け、デコードされた結果のコレクションを返します。各結果には、バーコード値、フォーマットタイプ、およびPDFから読み取った場合はページ番号が含まれます。

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

画像からバーコードを読み取るためのガイドでは、読み取りAPIで利用可能な速度調整、複数バーコードの検出、および画像補正オプションについて説明します。

NetBarcodeとImageSharp

NetBarcodeはMITライセンスで提供されています。 依存しているSixLabors.ImageSharpライブラリは異なるモデルを採用しており、オープンソースプロジェクトや、年間総収益が一定のしきい値以下の企業は無料で利用できますが、そのしきい値を超えると商用ライセンスが必要になります。 ImageSharpがプロジェクトの.csproj@に明示的に記載されているか、NetBarcodeを通して通過的に到着しているかに関係なく、このスプリットは適用されます。

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

NetBarcodeが主なターゲットとする、バーコードを大規模に処理する小売業や物流会社の場合、年間収益はImageSharpの商用ライセンスが適用される基準額を超えることが多い。 コンプライアンス監査によって、パッケージツリーに組み込まれたこの義務が明らかになる可能性がある。

v1.8リリースでは、ImageSharp依存の追加的な結果が導入されました：@--CODE-39092--@@の戻り値の型が内部表現からSixLabors.ImageSharp.Image<Rgba32>に変更されました。 明示的な型付けなしにGetImage()を呼び出す既存のコードはコンパイル時に壊れ、usingの新しい@@--CODE-39096--@と@@--CODE-39097--@のディレクティブが必要になりました。 ImageSharp独自のAPIが将来のバージョンで進化すると、NetBarcodeの公開APIにも影響が及ぶ。

IronBarcode

IronBarcodeはSixLabors.ImageSharpに依存していません。 ライセンス条件はIronBarcodeのライセンスページに直接記載されており、分割基準や推移的な商業義務は存在しません。 評価用の試用版キーが利用可能です。 購入したライセンスは、生成された出力から試用版の透かしを削除します。

QRコードおよび2Dフォーマットの要件

NetBarcodeの代替案を検討する最も一般的なきっかけは、QRコードに関する新たな要件の発生である。 小売ラベルや出荷明細書用の1次元バーコード生成から始まるアプリケーションは、非接触リンク、モバイルアプリのディープリンク、マーケティングキャンペーンなど、QRコードを必要とするケースが一般的です。 CODE-39134--@@@列挙型にはQRエントリがないため、NetBarcodeではこの要件を満たすことができません。 ギャップを埋めるために別途QRライブラリを追加するチームは、医薬品統合のためにDataMatrixが必要になった場合、または配送ラベルにPDF417を義務付ける物流業者が必要になった場合に、2回目の評価に直面することになる。

バーコード読み取りが必須となる

プロジェクトによっては、最初は純粋な生成作業から始まり、後から検証や文書処理の要件を追加する場合があります。例えば、印刷されたバーコードが元のデータと一致するかを確認したり、仕入先からの請求書からバーコード値を抽出したり、返品ラベルをスキャンしたりといった作業です。 NetBarcodeにはこのためのパスがありません。 ZXing .NETまたは同等の読み取りライブラリを追加すると、NetBarcodeとQRライブラリが既に存在する同じコードベース内で、学習および保守が必要な3つ目のAPIが導入されることになります。 将来の段階であっても読書ニーズを想定しているプロジェクトでは、最初から両方のニーズに対応できる図書館を選ぶ方が効率的な場合が多い。

ImageSharp商用ライセンス監査

サードパーティの依存関係に関する法的およびコンプライアンス上のレビューでは、NetBarcode パッケージツリーに組み込まれている SixLabors.ImageSharp の商用ライセンス条件が時折明らかになります。 年間総収益が一定の基準額を超える企業の場合、ImageSharpが意図的に選択されたか、NetBarcodeを経由して間接的に導入されたかにかかわらず、この義務が適用されます。 導入前ではなく監査中にこの問題を発見したチームは、計画的な移行ではなく、事後的な是正措置を講じる必要に迫られる。 プロジェクトを開始する前に依存関係のライセンスを評価する方が、より確実な方法です。

複数ライブラリの複雑さを軽減する

1D生成用のNetBarcode、2D出力用のQRコード専用ライブラリ、読み取り用のZXing .NETを既に導入しているチームは、3つの異なるパッケージ間でバージョン互換性を維持する必要に迫られる。 アップグレードのたびに、3つのライブラリが共有するImageSharpのバージョンが一致しているかどうかを確認する必要があります。 プロジェクトに参加する新しい開発者はそれぞれ、概念的には一つの課題であるにもかかわらず、３つの異なるAPIに遭遇することになる。 単一のバーコードライブラリに統合することで、導入が簡素化され、バージョン競合の問題が軽減され、メンテナンスが1つのリリースサイクルに集中します。

パッケージの入れ替えと推移的依存関係のクリーンアップ

NetBarcodeをdotnet remove package NetBarcodeで削除することが最初のステップです。SixLabors.ImageSharpパッケージは、プロジェクト内の他のパッケージが依存関係ツリーに再び現れるかもしれません。 削除後、復元されたパッケージリストをdotnet list package --include-transitiveで検査し、ImageSharpがまだ存在するかどうか、その商用ライセンス条件がまだ適用されるかどうかを確認してください。

GetImage() の戻り値の型置換

CODE-39137--@@ の結果を Image<Rgba32> として保存したコードはすべて更新する必要があります。 ImageSharp型にはIronBarcodeに直接相当する型はありません。 代替画像は、その後の画像利用状況によって異なる。 画像をストリームに保存するコードは、.SaveAsPng(stream)オブジェクトのGeneratedBarcodeに直接置き換えることができます。 生のバイトを取得したコードは、.ToPngBinaryData()を使用できます。 返された画像に対してImageSharpによる追加操作を行うコードは、それらの操作を個別に評価する必要があります。

名前空間の更新

CODE-39142--@、@--CODE-39143--@、@--CODE-39144--@、または@--CODE-39145--@をインポートしたファイルは、これらのディレクティブを@--CODE-39146--@に置き換える必要があります。 プロジェクト全体でこれらのusingステートメントを検索することで、ビルドを試行する前に注意が必要なすべてのファイルが特定されます。