基本的な問題

型推測ループは、必須のBarCodeType制約の最も目立つ症状です。 Spire.Barcodeのコードベースで、複数のソースからのドキュメントを処理する場合、このパターンが繰り返し現れます。

// Spire.Barcode: growing candidate loop with silent misses
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: growing candidate loop with silent misses
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

IronBarcodeはループを完全に排除します。 フォーマット検出機能はライブラリに組み込まれています。

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarcode

' IronBarcode: single call, all formats, type included in result
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

ステップ 1: NuGet パッケージを置き換える

現在使用中のSpireパッケージを削除してください。

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

バーコード抽出以外のドキュメント操作にSpire.PDFが使用されている場合、それを保持し、バーコード関連のコードパスのみを削除してください。

IronBarcodeをインストールしてください：

dotnet add package IronBarcode

dotnet add package IronBarcode

ステップ 2: 名前空間の更新

すべてのSpire名前空間インポートをIronBarcode名前空間で置き換えます：

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

Imports IronBarCode

ステップ 3: ライセンスの初期化

Spireライセンスの初期化処理を、アプリケーション起動時のIronBarcodeプロパティの単一割り当てに置き換えてください。キーフォーマットと展開オプションについては、IronBarcodeライセンスページを参照してください。

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key")

' Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key")

' Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

DockerおよびCI環境の場合、ライセンスキーは環境変数から指定できます。

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

Imports System

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

既知形式のバーコードの読み取り

Spire.Barcodeでの単一フォーマット読み込みは、明示的に型を渡し、string[]を受け取ります。

Spire.Barcode アプローチ:

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("shipping-label.png", BarCodeType.Code128)

If results.Length > 0 Then
    ProcessShipment(results(0))
End If

IronBarcodeのアプローチ：

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

Imports IronBarCode

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

If results.Any() Then
    ProcessShipment(results.First().Value)
End If

BarCodeTypeパラメーターは削除されます。 下流のロジックで検出されたフォーマットを確認する必要がある場合、results.First().Formatが別の状態変数を必要とせずに提供します。

混合フォーマット型ループの折りたたみ

Spire.Barcodeのコードベースが複数のフォーマットを含む可能性のあるドキュメントを処理する場合、新しいフォーマットがワークフローに加わるにつれて、タイプ推測のループが時間とともに蓄積されます。

Spire.Barcode アプローチ:

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates As BarCodeType() = {
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
}

Dim allValues As New List(Of String)()
For Each type As BarCodeType In candidates
    Dim found As String() = scanner.Scan("document-scan.png", type)
    allValues.AddRange(found)
Next

IronBarcodeのアプローチ：

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

Imports IronBarCode

' The entire loop is replaced by a single call
Dim results = BarcodeReader.Read("document-scan.png")
Dim allValues As List(Of String) = results.Select(Function(r) r.Value).ToList()

IronBarcodeの画像読み取り機能は、50種類以上のシンボル体系すべてを一度の処理で対応します。 大量のバッチ処理のために読み取り速度を調整する必要がある場合に、BarcodeReaderOptionsは、フォーマット固有の分岐を追加せずにその制御を提供します：

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim results = BarcodeReader.Read("document-scan.png", options)

適切なReadingSpeed値の選択についてのガイダンスは、読み取り速度オプションのドキュメンテーションを参照してください。

バーコードの生成

Spire.Barcodeの生成では、GenerateImage()を呼び出す必要があります。

Spire.Barcode アプローチ:

using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "SHIP-9842-XZ";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("shipping-label.png", ImageFormat.Png);

using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "SHIP-9842-XZ";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("shipping-label.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "SHIP-9842-XZ"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("shipping-label.png", ImageFormat.Png)

IronBarcodeのアプローチ：

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

可変のBarCodeGeneratorインスタンスは、流暢なチェーンを持つ単一の静的ファクトリー呼び出しに置き換えられます。 各CreateBarcode()呼び出しが独立しているため、同時呼び出しで設定が誤って共有されるリスクはありません。

PDF文書からバーコードを読み取る

Spire.BarcodeはPDFファイルを直接読み込むことはできません。 Spireに基づくアプローチでは、ファイルを開き、ページを繰り返し処理し、各ページからラスター画像を抽出し、その画像をバーコードスキャナーに1つずつ渡すために、別のSpire.PDFパッケージを必要とします。

Spire.Barcode アプローチ:

using Spire.Pdf;
using Spire.Barcode;

var pdf = new PdfDocument();
pdf.LoadFromFile("invoices.pdf");

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

using Spire.Pdf;
using Spire.Barcode;

var pdf = new PdfDocument();
pdf.LoadFromFile("invoices.pdf");

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

Imports Spire.Pdf
Imports Spire.Barcode

Dim pdf As New PdfDocument()
pdf.LoadFromFile("invoices.pdf")

Dim scanner As New BarcodeScanner()
Dim extractedValues As New List(Of String)()

For Each page As PdfPageBase In pdf.Pages
    Dim images() As Image = page.ExtractImages()
    For Each image As Image In images
        Dim found() As String = scanner.Scan(image, BarCodeType.QRCode)
        extractedValues.AddRange(found)
    Next
Next

IronBarcodeのアプローチ：

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

IronBarcodeは、Spire.PDFや手動のページ管理が不要で、直接PDFドキュメントを読み取ります。 各バーコードが抽出されたページ番号は、結果オブジェクトに含まれています。 PDF読み取りコードを置換した後、プロジェクトからusing Spire.Pdf;インポートを削除できます。

問題1：BarCodeTypeパラメータの削除

Spire.Barcode: scanner.Scan(path, BarCodeType.Code128) — メソッドシグネチャで型引数が必要です。 それを削除するとコンパイルエラーが発生します。

解決策：呼び出し全体をBarcodeReader.Read(path)に置き換えます。 コードベースでBarCodeType.を検索して、すべての発生を特定します。 型推測ループ（BarCodeType[]候補配列を繰り返し処理するforeachブロック）は完全に削除できます； 単一のBarcodeReader.Read()呼び出しでループを置き換えます。

問題2：string[]の戻り値の型

Spire.Barcode: string[]を返します。 下流のコードがこれをstring[]を期待するメソッドに渡したりすると、移行後にコンパイルエラーが発生します。

解決策：呼び出しサイトをBarcodeResultsで動作するように更新します。 単純な文字列配列を取得するには、.Select(r => r.Value).ToArray()を使用します。 最初の結果にアクセスするには、.First()?.Valueを使用します。 検出されたフォーマットが下流で必要な場合、.Formatを介して結果オブジェクトに利用可能です — 別の状態変数は必要ありません。

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

Imports System.Linq

' If a plain string array is needed:
Dim texts As String() = BarcodeReader.Read("barcode.png") _
    .Select(Function(r) r.Value) _
    .ToArray()

' If only the first value is needed:
Dim first As String = BarcodeReader.Read("barcode.png").FirstOrDefault()?.Value

第3号：Spire.PDFパッケージのクリーンアップ

Spire.Barcode: PDF読み取りワークフローは、ページアクセスと画像抽出にSpire.PDFに依存しています。 プロジェクトにはパッケージへの参照があり、PdfDocument / PdfPageBaseの使用が複数のファイルにわたって含まれています。

解決策：すべてのPDFバーコード抽出コードをSpire.Pdf参照がないことを確認します：

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

すべての参照がクリアされた後にのみ、パッケージを削除してください。

dotnet remove package Spire.PDF

dotnet remove package Spire.PDF

第4号：名前空間の変更

Spire.Barcode: BarCodeTypeが含まれています。 BarcodeReaderOptionsが含まれています。

解決策：using IronBarCode;にグローバルに置き換えます。 生成に使用されるBarcodeEncodingに置き換えられます。 読み取りに使用されるBarCodeType列挙型には、IronBarcodeに相当するものはありません — これは単に削除されます。なぜなら、フォーマット検出は自動的に行われるからです。

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

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

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

• BarCodeType候補配列（削除すべき型推測ループ）を含むすべてのファイルを文書化します
• Scan()から結果を受け取り、型の更新が必要なものを特定します
• Spire.PDFがバーコード抽出以外の操作に使用されているかどうかを確認します

コード更新タスク

1. Spire.BarcodeNuGetパッケージを削除します
2. バーコード抽出が唯一の用途であった場合は、Spire.PDFNuGetパッケージを削除します
3. IronBarcodeNuGetパッケージをインストールします
4. すべてのusing IronBarCode;に置き換えます
5. 不要になったusing Spire.Pdf;インポートをすべて削除します
6. ライセンス初期化を置き換えます：IronBarCode.License.LicenseKey = "key"に
7. すべてのnew BarcodeScanner()インスタンスを削除します
8. すべてのBarcodeReader.Read(path)に置き換えます
9. 型推測を行うforeachループを削除する。 それぞれを単一のBarcodeReader.Read()呼び出しに置き換える
10. PDFページの反復処理と画像抽出のブロックを削除します。 BarcodeReader.Read("file.pdf")に置き換える
11. .Select(r => r.Value).ToArray()を使用するように更新します
12. BarcodeWriter.CreateBarcode(data, encoding)チェインに置き換えます
13. new BarCodeGenerator(settings)インスタンスを削除します
14. .GenerateImage() + .SaveAsJpeg()に置き換えます
15. 生成で使用されるBarcodeEncoding.Xに置き換えます

移行後のテスト

• 候補ループを介して以前にスキャンされたすべてのフォーマットがBarcodeReader.Read()によって正しく検出されることを確認します バッチ処理のスループットを測定し、生産要件を満たしていることを確認する。 PDFバーコード抽出で正しい値とページ番号が生成されることを確認する 生成されたバーコードの出力品質とスキャン可能性を、物理スキャナーまたはソフトウェアスキャナーで確認してください。
• ライセンスキーがすべてのデプロイ環境（ローカル、ステージング、本番、CI/CD）に正しくロードされていることを確認してください。
• 移行前タスクから grep 監査コマンドを実行して、Spire への参照が残っていないことを確認します。