基本的な問題

生成と読み取りの両方を必要とするプロジェクトにとって、デュアルライセンス構成は最も直接的な問題点となる。 OnBarcodeは起動時に、2つの異なるライセンスネームスペースに対して2つの別々の呼び出しを行う必要があります。

// OnBarcode: two products, two DLL references, no runtime key
// オンバーコード uses pre-licensed DLLs — the purchased DLL is already activated.
// There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// OnBarcode: two products, two DLL references, no runtime key
// オンバーコード uses pre-licensed DLLs — the purchased DLL is already activated.
// There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
using OnBarcode.Barcode;
using OnBarcode.Barcode;

' OnBarcode: two products, two DLL references, no runtime key
' オンバーコード uses pre-licensed DLLs — the purchased DLL is already activated.
' There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
Imports OnBarcode.Barcode
Imports OnBarcode.Barcode

IronBarcodeはこれを単一のプロパティ割り当てに集約し、生成、読み取り、PDFサポート、バッチ操作といったすべての機能を1つのキーで網羅します。

// IronBarcode: one package, one key, one line
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// IronBarcode: one package, one key, one line
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

アプリケーション内のすべてのバーコード操作（PDFの生成、読み取り、処理のいずれであっても）は、単一の構成で実行されます。

ステップ1：OnBarcodeパッケージの参照を削除します

プロジェクトでNuGetパッケージを使用している場合は、両方を削除してください。

dotnet remove package OnBarcode.Barcode.Generator
dotnet remove package OnBarcode.Barcode.Reader

dotnet remove package OnBarcode.Barcode.Generator
dotnet remove package OnBarcode.Barcode.Reader

プロジェクトが古い DLL ベースの配布を使用している場合、.csproj から手動参照ブロックも削除してください。

<ItemGroup>
  <Reference Include="OnBarcode.Barcode">
    <HintPath>lib\OnBarcode.Barcode.dll</HintPath>
    <Private>true</Private>
  </Reference>
</ItemGroup>

<ItemGroup>
  <Reference Include="OnBarcode.Barcode">
    <HintPath>lib\OnBarcode.Barcode.dll</HintPath>
    <Private>true</Private>
  </Reference>
</ItemGroup>

lib/ ディレクトリから DLL ファイルを削除するか、それらが保存されている場所から削除します。 新しいNuGetパッケージと並行して古いアセンブリを残しておくと、コンパイル時に名前空間の競合が発生します。

ステップ2： IronBarcodeを追加する

1つのパッケージで、生成、読み込み、PDFサポートがすべてカバーされます。

dotnet add package IronBarcode

dotnet add package IronBarcode

閲覧には別のパッケージは必要ありません。 PDFサポートには、別途パッケージは必要ありません。

ステップ3：名前空間を更新し、デュアルライセンス構成を置き換える

OnBarcode の 2 つの使用指示を、単一のIronBarcodeインポートに置き換えます。

// Remove
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// Add
using IronBarCode;

// Remove
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// Add
using IronBarCode;

Imports IronBarCode

2つのDLL参照を単一のキー割り当てに置き換えます。 これをアプリケーションの起動直後、バーコード操作が実行される前に一度だけ配置してください。

// Remove the オンバーコード DLL references and using directives
// Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove the オンバーコード DLL references and using directives
// Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove the オンバーコード DLL references and Imports statements
' Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

コード128バーコード生成

基本的なコード128の事例は、プロパティ割り当てパターンと静的ファクトリパターンの違いを示しています。

OnBarcodeアプローチ：

using OnBarcode.Barcode;

Linear barcode = new Linear();
barcode.Type = BarcodeType.CODE128;
barcode.Data = "SHIP-2024-001";
barcode.Resolution = 96;
barcode.X = 1;
barcode.BarcodeHeight = 80;
barcode.ShowText = true;
barcode.drawBarcode("shipping-label.png");

using OnBarcode.Barcode;

Linear barcode = new Linear();
barcode.Type = BarcodeType.CODE128;
barcode.Data = "SHIP-2024-001";
barcode.Resolution = 96;
barcode.X = 1;
barcode.BarcodeHeight = 80;
barcode.ShowText = true;
barcode.drawBarcode("shipping-label.png");

Imports OnBarcode.Barcode

Dim barcode As New Linear()
barcode.Type = BarcodeType.CODE128
barcode.Data = "SHIP-2024-001"
barcode.Resolution = 96
barcode.X = 1
barcode.BarcodeHeight = 80
barcode.ShowText = True
barcode.drawBarcode("shipping-label.png")

IronBarcodeのアプローチ：

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

データとエンコーディングタイプは CreateBarcode への引数として渡されます。 解像度やバーの高さといった特性は、スキャン可能な出力を生成するために必須ではありません。 デフォルト設定はほとんどの用途に適しています。 カスタム寸法が必要な場合、CreateBarcode と SaveAsPng 間のチェーン呼び出しとして追加でき、可変オブジェクト状態を導入しません。

ロゴ付きQRコード生成

ロゴ付き QR コードは、画像オーバーレイステップのために オンバーコード が System.Drawing にフォールバックする必要があります。IronBarcode ではこれを組み込みの操作として提供しています。

OnBarcodeアプローチ：

using OnBarcode.Barcode;
using System.Drawing;

QRCode qr = new QRCode();
qr.Data = "https://example.com/product/4891";
qr.QRCodeDataMode = QRCodeDataMode.Auto;
qr.QRCodeECL = QRCodeECL.H; // H-level error correction required for logo overlay

Image qrImage = qr.drawBarcode();

using (Graphics g = Graphics.FromImage(qrImage))
{
    Image logo = Image.FromFile("brand-logo.png");
    int logoSize = qrImage.Width / 5;
    int x = (qrImage.Width - logoSize) / 2;
    int y = (qrImage.Height - logoSize) / 2;
    g.DrawImage(logo, x, y, logoSize, logoSize);
}

qrImage.Save("product-qr.png");

using OnBarcode.Barcode;
using System.Drawing;

QRCode qr = new QRCode();
qr.Data = "https://example.com/product/4891";
qr.QRCodeDataMode = QRCodeDataMode.Auto;
qr.QRCodeECL = QRCodeECL.H; // H-level error correction required for logo overlay

Image qrImage = qr.drawBarcode();

using (Graphics g = Graphics.FromImage(qrImage))
{
    Image logo = Image.FromFile("brand-logo.png");
    int logoSize = qrImage.Width / 5;
    int x = (qrImage.Width - logoSize) / 2;
    int y = (qrImage.Height - logoSize) / 2;
    g.DrawImage(logo, x, y, logoSize, logoSize);
}

qrImage.Save("product-qr.png");

Imports OnBarcode.Barcode
Imports System.Drawing

Dim qr As New QRCode()
qr.Data = "https://example.com/product/4891"
qr.QRCodeDataMode = QRCodeDataMode.Auto
qr.QRCodeECL = QRCodeECL.H ' H-level error correction required for logo overlay

Dim qrImage As Image = qr.drawBarcode()

Using g As Graphics = Graphics.FromImage(qrImage)
    Dim logo As Image = Image.FromFile("brand-logo.png")
    Dim logoSize As Integer = qrImage.Width \ 5
    Dim x As Integer = (qrImage.Width - logoSize) \ 2
    Dim y As Integer = (qrImage.Height - logoSize) \ 2
    g.DrawImage(logo, x, y, logoSize, logoSize)
End Using

qrImage.Save("product-qr.png")

IronBarcodeのアプローチ：

using IronBarCode;

var qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500);
qr.SaveAsPng("product-qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500);
qr.SaveAsPng("product-qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500)
qr.SaveAsPng("product-qr.png")

エラー訂正レベル、ロゴサイズ計算、画像合成は内部で処理されます。 System.Drawing 依存性は必要ありません。

画像からバーコードを読み取る

画像ファイルからの読み込みは、製品統合を最も明確に示している。 OnBarcodeでは、読み取りには別途Reader SDK、別途ライセンス認証、および明示的なフォーマット指定が必要です。 IronBarcodeでは、既に設定されている同じパッケージとキーを使用して、単一の静的呼び出しを行うだけで済みます。

OnBarcodeアプローチ：

using OnBarcode.Barcode;

// オンバーコード reader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };
string[] results = scanner.Scan("received-label.png");

foreach (string value in results)
    Console.WriteLine(value);

using OnBarcode.Barcode;

// オンバーコード reader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };
string[] results = scanner.Scan("received-label.png");

foreach (string value in results)
    Console.WriteLine(value);

Imports OnBarcode.Barcode

' オンバーコード reader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
Dim scanner As New BarcodeScanner()
scanner.BarcodeTypes = New BarcodeType() {BarcodeType.Code128, BarcodeType.QRCode}
Dim results As String() = scanner.Scan("received-label.png")

For Each value As String In results
    Console.WriteLine(value)
Next

IronBarcodeのアプローチ：

using IronBarCode;

var results = BarcodeReader.Read("received-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

using IronBarCode;

var results = BarcodeReader.Read("received-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

Imports IronBarCode

Dim results = BarcodeReader.Read("received-label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

インスタンスの作成、フォーマット配列、個別のライセンス設定は不要です。 フォーマットは自動的に検出されます。 各結果には、デコードされた値と検出されたフォーマットが含まれています。 読み取りオプションやサポートされている画像タイプの詳細については、 "画像からバーコードを読み取る方法"ガイドを参照してください。

PDFファイルからバーコードを読み取る

この移行例は、サードパーティライブラリを使用してPDFページを画像にレンダリングしてから、それらの画像をOnBarcode Reader SDKに渡していたチームに適用されます。

OnBarcodeアプローチ：

// オンバーコード has no native PDF support.
// A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
var pageImages = RenderPdfPagesToImages("invoices.pdf"); // external library call

using OnBarcode.Barcode;
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };

foreach (var pageImage in pageImages)
{
    string[] results = scanner.Scan(pageImage);
    foreach (string value in results)
        Console.WriteLine(value);
}

// オンバーコード has no native PDF support.
// A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
var pageImages = RenderPdfPagesToImages("invoices.pdf"); // external library call

using OnBarcode.Barcode;
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };

foreach (var pageImage in pageImages)
{
    string[] results = scanner.Scan(pageImage);
    foreach (string value in results)
        Console.WriteLine(value);
}

Imports OnBarcode.Barcode

' オンバーコード has no native PDF support.
' A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
Dim pageImages = RenderPdfPagesToImages("invoices.pdf") ' external library call

Dim scanner As New BarcodeScanner()
scanner.BarcodeTypes = New BarcodeType() {BarcodeType.Code128, BarcodeType.QRCode}

For Each pageImage In pageImages
    Dim results As String() = scanner.Scan(pageImage)
    For Each value As String In results
        Console.WriteLine(value)
    Next
Next

IronBarcodeのアプローチ：

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}");

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}");

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}")
Next

レンダリング手順なし、外部PDFライブラリなし、フォーマット配列なし。 PDFバーコード読み取り機能は、すべてのページを自動的に処理し、各結果にページ番号を含めます。

バッチ生成

複数のアイテムに対してバーコードを生成する場合も、単一アイテムを生成する場合と同じパターンの違いが生じます。

OnBarcodeアプローチ：

using OnBarcode.Barcode;

foreach (var item in inventoryItems)
{
    Linear barcode = new Linear();
    barcode.Type = BarcodeType.CODE128;
    barcode.Data = item.Sku;
    barcode.Resolution = 96;
    barcode.BarWidth = 1;
    barcode.BarHeight = 80;
    barcode.ShowText = true;
    barcode.drawBarcode($"labels/{item.Id}.png");
}

using OnBarcode.Barcode;

foreach (var item in inventoryItems)
{
    Linear barcode = new Linear();
    barcode.Type = BarcodeType.CODE128;
    barcode.Data = item.Sku;
    barcode.Resolution = 96;
    barcode.BarWidth = 1;
    barcode.BarHeight = 80;
    barcode.ShowText = true;
    barcode.drawBarcode($"labels/{item.Id}.png");
}

Imports OnBarcode.Barcode

For Each item In inventoryItems
    Dim barcode As New Linear()
    barcode.Type = BarcodeType.CODE128
    barcode.Data = item.Sku
    barcode.Resolution = 96
    barcode.BarWidth = 1
    barcode.BarHeight = 80
    barcode.ShowText = True
    barcode.drawBarcode($"labels/{item.Id}.png")
Next

IronBarcodeのアプローチ：

using IronBarCode;

foreach (var item in inventoryItems)
{
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128)
        .SaveAsPng($"labels/{item.Id}.png");
}

using IronBarCode;

foreach (var item in inventoryItems)
{
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128)
        .SaveAsPng($"labels/{item.Id}.png");
}

Imports IronBarCode

For Each item In inventoryItems
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128) _
        .SaveAsPng($"labels/{item.Id}.png")
Next

問題1：DLL参照の競合

OnBarcode: レガシー DLL ディストリビューションのプロジェクトは、.csproj 内に <Reference> 要素を持ち、lib\OnBarcode.Barcode.dll または類似のパスを指しています。 IronBarcodeを追加した際に古いDLLがディスク上に残っている場合、コンパイラは同じ名前空間プレフィックスを提供する2つのアセンブリを認識し、あいまいな参照エラーを生成します。

解決策: dotnet add package IronBarcode を実行する前に、.csproj から <ItemGroup> 参照ブロックを削除してください。 ディスクからDLLファイルを削除してください。 クリーンビルドを実行して、古いアセンブリ参照が残っていないことを確認してください。

# Search for lingering オンバーコード DLL references in project files
grep -r "OnBarcode" --include="*.csproj" .
grep -r "OnBarcode" --include="*.props" .

# Search for lingering オンバーコード DLL references in project files
grep -r "OnBarcode" --include="*.csproj" .
grep -r "OnBarcode" --include="*.props" .

問題2：段階的移行中の型名の競合

OnBarcode: リーダーネームスペースは BarcodeScanner という名前のクラスをエクスポートします。 IronBarcode には BarcodeReader という静的なクラスがあります。 これらの名前は直接競合しませんが、OnBarcode.Barcode.Reader と IronBarCode を同時にインポートするファイルは BarcodeType 列挙型の曖昧性が発生する可能性があります — オンバーコード はフォーマット選択のために BarcodeType を定義し、IronBarcode は BarcodeEncoding を使用します。 移行中に両方のネームスペースをアクティブに保つと、BarcodeType 参照にコンパイルエラーが発生します。

解決策: 各ファイルの移行をアトミックに完了します — 同じ編集で using OnBarcode.Barcode.Reader ディレクティブを削除し、using IronBarCode を追加します。 どちらのusingディレクティブもファイル内に残さないでください。段階的なアプローチが必要な場合は、一時的に完全修飾名を使用してください。

// Temporary disambiguation during phased migration
var results = IronBarCode.BarcodeReader.Read("file.png");

// Temporary disambiguation during phased migration
var results = IronBarCode.BarcodeReader.Read("file.png");

' Temporary disambiguation during phased migration
Dim results = IronBarCode.BarcodeReader.Read("file.png")

問題3：バーコードタイプの配列削除

OnBarcode:リーダーには reader.BarcodeTypes = new BarcodeType[] { ... } が機能するようにします。 リーダーコードを移行する開発者は、フォーマットを明示的に指定する習慣を持ち、 IronBarcodeで同等の設定を探すことがあります。

解決策：書式指定を完全に削除する。 BarcodeReader.Read はサポートされているすべてのフォーマットに対して自動検出を行います。 設定は必要なく、IronBarcode では BarcodeType[] に相当するものが必要ないため存在しません。

// No format configuration required
var results = BarcodeReader.Read("label.png");

// No format configuration required
var results = BarcodeReader.Read("label.png");

Dim results = BarcodeReader.Read("label.png")

マイグレーション前のタスク

変更を加える前に、コードベースを監査して、OnBarcodeの使用箇所をすべて特定してください。

# Find all オンバーコード namespace imports
grep -rn "using OnBarcode" --include="*.cs" .

# Find all license configuration calls
grep -rn "SetLicense" --include="*.cs" .

# Find all generator usage
grep -rn "new Linear\|new QRCode\|drawBarcode\|BarcodeType\." --include="*.cs" .

# Find all reader usage
grep -rn "BarcodeScanner\|\.Scan(\|BarcodeType\[\]" --include="*.cs" .

# Find DLL references in project files
grep -rn "OnBarcode" --include="*.csproj" .
grep -rn "OnBarcode" --include="*.sln" .

# Find all オンバーコード namespace imports
grep -rn "using OnBarcode" --include="*.cs" .

# Find all license configuration calls
grep -rn "SetLicense" --include="*.cs" .

# Find all generator usage
grep -rn "new Linear\|new QRCode\|drawBarcode\|BarcodeType\." --include="*.cs" .

# Find all reader usage
grep -rn "BarcodeScanner\|\.Scan(\|BarcodeType\[\]" --include="*.cs" .

# Find DLL references in project files
grep -rn "OnBarcode" --include="*.csproj" .
grep -rn "OnBarcode" --include="*.sln" .

どのファイルが生成のみを使用し、どのファイルが読み取りのみを使用し、どのファイルが両方を使用するかを文書化する。 NuGet パッケージ参照の代わりに手動 <Reference> DLL ブロックを含むファイルに注意してください。

コード更新タスク

1. OnBarcode.Barcode.Generator NuGet パッケージを削除
2. OnBarcode.Barcode.Reader NuGet パッケージを削除
3. .csproj ファイルから手動 <Reference> DLL エントリをすべて削除
4. リポジトリからOnBarcode DLLファイルを削除します。
5. dotnet add package IronBarcode を実行
6. 各ファイルで using OnBarcode.Barcode を using IronBarCode に置き換え
7. 各ファイルで using OnBarcode.Barcode.Reader を using IronBarCode に置き換え
8. オンバーコード DLL <Reference> エントリ（ジェネレーターとリーダー）を両方削除 — 置き換えるランタイムライセンス呼び出しはありません
9. アプリケーションの起動時に IronBarCode.License.LicenseKey = "YOUR-KEY" を一度追加
10. 各 new Linear() または new QRCode() + プロパティ割り当てブロックを BarcodeWriter.CreateBarcode(data, encoding) に変換
11. barcode.drawBarcode("file.png") を .SaveAsPng("file.png") (または適切なフォーマットメソッド) に置き換え
12. new BarcodeScanner() { BarcodeTypes = [...] } + .Scan(path) を BarcodeReader.Read(path) に置き換え
13. BarcodeResults 上の string[] インデックス化から result.Value および result.Format への結果処理を更新
14. OnBarcodeのPDF制限を回避するために使用されていたPDFから画像へのレンダリングコードをすべて削除します。
15. PDF の複数ステップレンダリング + スキャンループを単一の BarcodeReader.Read("file.pdf") 呼び出しに置き換え

移行後のテスト

プロジェクトで使用されている各バーコードタイプ（Code 128、QR、EAN、Data Matrix、PDF417）がスキャン可能な出力を生成することを確認する。 生成されたバーコードを物理的なスキャナーまたはモバイルデバイスでスキャンして、読み取り可能であることを確認してください。

• バーコード読み取りが既知のテスト画像に対して正しい値を返すことを確認する
• PDF読み取りで複数ページのテスト文書に対して正しい値とページ番号が返されることを確認します。
• アプリケーションを任意の CI 環境で実行し、パイプライン内でライセンス キーの設定が正しく機能することを確認します。
• 移行が完了した後に .csproj、または設定ファイルに OnBarcode 文字列が残っていないことを確認