基本的な問題

MessagingToolkit.Barcode は System.Drawing への依存と現代の .NET と互換性のないインスタンスベースのワークフローを強制しています。

// MessagingToolkit.Barcode: only compiles on .NET Framework 4.5 or earlier
// System.Drawing.Bitmap throws PlatformNotSupportedException on Linux/.NET 6+
using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))  // Windows-only in .NET 6+
{
    var result = decoder.Decode(bitmap);          // Single result or null
    if (result != null)
    {
        Console.WriteLine(result.Text);
    }
}

// MessagingToolkit.Barcode: only compiles on .NET Framework 4.5 or earlier
// System.Drawing.Bitmap throws PlatformNotSupportedException on Linux/.NET 6+
using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))  // Windows-only in .NET 6+
{
    var result = decoder.Decode(bitmap);          // Single result or null
    if (result != null)
    {
        Console.WriteLine(result.Text);
    }
}

Imports MessagingToolkit.Barcode
Imports System.Drawing

Dim decoder As New BarcodeDecoder()
Using bitmap As New Bitmap("barcode.png") ' Windows-only in .NET 6+
    Dim result = decoder.Decode(bitmap) ' Single result or Nothing
    If result IsNot Nothing Then
        Console.WriteLine(result.Text)
    End If
End Using

IronBarcode は System.Drawing の依存を完全に排除し、Windows、Linux、macOS、および Docker コンテナで同一に動作します。

// IronBarcode: runs on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

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

var results = BarcodeReader.Read("barcode.png");  // なし Bitmap, no System.Drawing
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

// IronBarcode: runs on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

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

var results = BarcodeReader.Read("barcode.png");  // なし Bitmap, no System.Drawing
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

Imports IronBarCode

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

Dim results = BarcodeReader.Read("barcode.png") ' なし Bitmap, no System.Drawing
For Each result In results
    Console.WriteLine(result.Value)
Next

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

MessagingToolkit.Barcode パッケージを削除します。

dotnet remove package MessagingToolkit.Barcode

dotnet remove package MessagingToolkit.Barcode

プロジェクトが MessagingToolkit.Barcode.dll を <HintPath> エントリを通じて .csproj ファイルに直接参照している場合、その参照も削除してください。

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

dotnet add package IronBarcode

dotnet add package IronBarcode

IronBarcodeは.NET Framework 4.6.2から.NET 9までをサポートしています。すべての依存関係がバンドルされた単一パッケージとしてインストールされるため、別途グラフィックライブラリやZXingの参照は必要ありません。

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

MessagingToolkit 名前空間を参照するすべてのファイルで IronBarcode 名前空間に置き換えます:

// Remove this
using MessagingToolkit.Barcode;
using System.Drawing;  // if used only for Bitmap input to MessagingToolkit

// Add this
using IronBarCode;

// Remove this
using MessagingToolkit.Barcode;
using System.Drawing;  // if used only for Bitmap input to MessagingToolkit

// Add this
using IronBarCode;

Imports IronBarCode

MessagingToolkit.Barcode と共に使用される Bitmap 型のためだけに System.Drawing をインポートしていたファイルは、IronBarcode が導入されるとそのインポートを削除できます。

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

アプリケーションの起動時にライセンス初期化を一度行ってください — Startup.cs、または同等のエントリーポイントで。 実運用にはライセンスキーが必要です。 図書館は、それがなくても試用モードで運営されています。

// Add once at application startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add once at application startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add once at application startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

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

過去のアプローチでは、ファイルパスから Bitmap を構築し、それを BarcodeDecoder インスタンスに渡す必要がありました。 IronBarcodeはファイルパスを直接受け付けます。

MessagingToolkit.バーコードアプローチ:

using MessagingToolkit.Barcode;
using System.Drawing;

public string ReadBarcodeValue(string imagePath)
{
    var decoder = new BarcodeDecoder();
    using (var bitmap = new Bitmap(imagePath))
    {
        var result = decoder.Decode(bitmap);
        return result?.Text;
    }
}

using MessagingToolkit.Barcode;
using System.Drawing;

public string ReadBarcodeValue(string imagePath)
{
    var decoder = new BarcodeDecoder();
    using (var bitmap = new Bitmap(imagePath))
    {
        var result = decoder.Decode(bitmap);
        return result?.Text;
    }
}

Imports MessagingToolkit.Barcode
Imports System.Drawing

Public Function ReadBarcodeValue(imagePath As String) As String
    Dim decoder As New BarcodeDecoder()
    Using bitmap As New Bitmap(imagePath)
        Dim result = decoder.Decode(bitmap)
        Return If(result IsNot Nothing, result.Text, Nothing)
    End Using
End Function

IronBarcodeのアプローチ：

using IronBarCode;

public string ReadBarcodeValue(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value;
}

using IronBarCode;

public string ReadBarcodeValue(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value;
}

Imports IronBarCode

Public Function ReadBarcodeValue(imagePath As String) As String
    Dim results = BarcodeReader.Read(imagePath)
    Return results.FirstOrDefault()?.Value
End Function

IronBarcode バージョンは Bitmap の構築と単一オブジェクトに対する null コンディショナルパターンを除去します。 BarcodeReader.Read() はコレクションを返します — 何も見つからない場合は空のコレクション — したがって旧の単一結果の戻り値に対する null チェックを .FirstOrDefault() に置き換えます。

結果からフォーマット情報にアクセスする

MessagingToolkit.Barcode は検出されたフォーマットを result.BarcodeFormat を通じて公開していました。 IronBarcode はそれを result.Format を通じて公開します。 どちらも結果オブジェクト上の列挙値であり、列挙型の名称が異なります。

MessagingToolkit.バーコードアプローチ:

using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))
{
    var result = decoder.Decode(bitmap);
    if (result != null)
    {
        Console.WriteLine($"Value: {result.Text}");
        Console.WriteLine($"Format: {result.BarcodeFormat}");
    }
}

using MessagingToolkit.Barcode;
using System.Drawing;

var decoder = new BarcodeDecoder();
using (var bitmap = new Bitmap("barcode.png"))
{
    var result = decoder.Decode(bitmap);
    if (result != null)
    {
        Console.WriteLine($"Value: {result.Text}");
        Console.WriteLine($"Format: {result.BarcodeFormat}");
    }
}

Imports MessagingToolkit.Barcode
Imports System.Drawing

Dim decoder As New BarcodeDecoder()
Using bitmap As New Bitmap("barcode.png")
    Dim result = decoder.Decode(bitmap)
    If result IsNot Nothing Then
        Console.WriteLine($"Value: {result.Text}")
        Console.WriteLine($"Format: {result.BarcodeFormat}")
    End If
End Using

IronBarcodeのアプローチ：

using IronBarCode;

var results = BarcodeReader.Read("barcode.png");
var first = results.FirstOrDefault();
if (first != null)
{
    Console.WriteLine($"Value: {first.Value}");
    Console.WriteLine($"Format: {first.Format}");
}

using IronBarCode;

var results = BarcodeReader.Read("barcode.png");
var first = results.FirstOrDefault();
if (first != null)
{
    Console.WriteLine($"Value: {first.Value}");
    Console.WriteLine($"Format: {first.Format}");
}

Imports IronBarCode

Dim results = BarcodeReader.Read("barcode.png")
Dim first = results.FirstOrDefault()
If first IsNot Nothing Then
    Console.WriteLine($"Value: {first.Value}")
    Console.WriteLine($"Format: {first.Format}")
End If

プロパティ名は .Text から .Value 、.BarcodeFormat から .Format に変更されます。 列挙型は BarcodeFormat (MessagingToolkit) から BarcodeEncoding (IronBarcode) に変更されますが、.Format.ToString() は表示またはログ記録のための同等の可読文字列を生成します。

バーコードの生成

MessagingToolkit.Barcode はインスタンスベースの BarcodeEncoder を使用し、.Encode() を呼び出す前にプロパティセットフォーマットを持っていました。 IronBarcodeは、エンコードタイプをパラメータとして受け取る静的メソッドを使用します。

MessagingToolkit.バーコードアプローチ:

using MessagingToolkit.Barcode;

public void GenerateQrCode(string data, string outputPath)
{
    var encoder = new BarcodeEncoder();
    encoder.Format = BarcodeFormat.QrCode;
    var bitmap = encoder.Encode(data);
    bitmap.Save(outputPath);
}

using MessagingToolkit.Barcode;

public void GenerateQrCode(string data, string outputPath)
{
    var encoder = new BarcodeEncoder();
    encoder.Format = BarcodeFormat.QrCode;
    var bitmap = encoder.Encode(data);
    bitmap.Save(outputPath);
}

Imports MessagingToolkit.Barcode

Public Sub GenerateQrCode(data As String, outputPath As String)
    Dim encoder As New BarcodeEncoder()
    encoder.Format = BarcodeFormat.QrCode
    Dim bitmap = encoder.Encode(data)
    bitmap.Save(outputPath)
End Sub

IronBarcodeのアプローチ：

using IronBarCode;

public void GenerateQrCode(string data, string outputPath)
{
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
        .SaveAsPng(outputPath);
}

using IronBarCode;

public void GenerateQrCode(string data, string outputPath)
{
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode)
        .SaveAsPng(outputPath);
}

Imports IronBarCode

Public Sub GenerateQrCode(data As String, outputPath As String)
    BarcodeWriter.CreateBarcode(data, BarcodeEncoding.QRCode) _
        .SaveAsPng(outputPath)
End Sub

Code 128やその他の1次元バーコードを作成する場合、異なるエンコード定数を使用するだけで、同じ静的パターンが適用されます。

// Code 128
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// EAN-13
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("ean13.png");

// Code 128
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// EAN-13
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("ean13.png");

' Code 128
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' EAN-13
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("ean13.png")

ターゲットフレームワークの更新

MessagingToolkit.Barcode が削除され、すべての参照が置き換えられたら、プロジェクトファイルのターゲットフレームワークを更新できます。 この変更は古い依存関係によって妨げられていましたが、それを削除することで可能になります。

MessagingToolkit.Barcode Approach（プロジェクトファイル）：

<PropertyGroup>
  <TargetFramework>net472</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net472</TargetFramework>
</PropertyGroup>

IronBarcodeのアプローチ（プロジェクトファイル）：

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
</PropertyGroup>

IronBarcodeは.NET Framework 4.6.2から.NET 9までをサポートしているため、フレームワークのアップグレードが完了する前にインストールできます。 これにより、移行を段階的に行うことができます。IronBarcodeをMessagingToolkit.Barcodeと並行してインストールし、すべての使用箇所を置き換え、新しいコードを検証し、古いパッケージを削除し、最後にターゲットフレームワークを変更します。

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

MessagingToolkit.BarcodeにはPDFのサポートがありませんでした。 PDFファイルからバーコードを読み取るには、バーコードデコーダーを呼び出す前に、各ページから別のライブラリを通して画像を抽出する必要があります。 IronBarcodeは、画像と同じ方法でPDFファイルを直接読み取ります。

MessagingToolkit.バーコードアプローチ:

// Not supported — required external PDF page extraction before decode
// なし equivalent exists in MessagingToolkit.Barcode

// Not supported — required external PDF page extraction before decode
// なし equivalent exists in MessagingToolkit.Barcode

' Not supported — required external PDF page extraction before decode
' なし equivalent exists in MessagingToolkit.Barcode

IronBarcodeのアプローチ：

using IronBarCode;

// Read all barcodes from every page of a PDF document
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

using IronBarCode;

// Read all barcodes from every page of a PDF document
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

Imports IronBarCode

' Read all barcodes from every page of a PDF document
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})")
Next

スキャンされた文書、出荷明細書、または複数ページの請求書バッチを処理するアプリケーションは、追加のライブラリや設定なしに、移行の一環としてこの機能を利用できるようになります。

問題1：パッケージ更新後に名前空間が見つからない

問題: MessagingToolkit.Barcode を削除し IronBarcode を追加した後、CS0246: The type or namespace name 'BarcodeDecoder' could not be found でコンパイルに失敗します。

解決策: 古い名前空間 using MessagingToolkit.Barcode; は、古いライブラリを参照するすべてのファイルで using IronBarCode; (大文字の C に注意) に置き換える必要があります。 プロジェクト全体で古い名前空間文字列を検索すると、影響を受けるすべてのファイルが見つかります。

grep -r "using MessagingToolkit.Barcode" --include="*.cs" .
grep -r "BarcodeDecoder\|BarcodeEncoder" --include="*.cs" .

grep -r "using MessagingToolkit.Barcode" --include="*.cs" .
grep -r "BarcodeDecoder\|BarcodeEncoder" --include="*.cs" .

問題2：バーコードリーダーにおける名前空間間の曖昧さ

問題: プロジェクトが両方の MessagingToolkit.Barcode と IronBarcode を分割移行中に参照している場合、BarcodeReader が両方の名前空間間で曖昧さを持つ可能性があります。

解決策：移行期間中は参照を明示的に修飾する。

// Use the fully qualified name while both packages are installed
var results = IronBarCode.BarcodeReader.Read("barcode.png");

// Use the fully qualified name while both packages are installed
var results = IronBarCode.BarcodeReader.Read("barcode.png");

Imports IronBarCode

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

MessagingToolkit.Barcode へのすべての参照が置き換えられ、古いパッケージが削除された後は、修飾子を削除し、using IronBarCode; ディレクティブが十分です。

問題3：パッケージ削除後もターゲットフレームワークがnet472に設定されたままになっている

問題: MessagingToolkit.Barcode を削除し IronBarcode をインストールした後も、プロジェクトファイルは net472 をターゲットにしています。 ビルド警告は、最新 for .NET APIが利用できないことを示しています。

解決策: 依存関係が削除された後、.csproj ファイルの <TargetFramework> 要素を更新してください。 IronBarcode は net472 (.NET Framework 4.6.2 互換性を介して) と現代のターゲットをサポートします。 net8.0 への変更は、プロジェクトに他のレガシー依存関係が残っていないことを確認する必要があります。

<TargetFramework>net8.0</TargetFramework>

<TargetFramework>net8.0</TargetFramework>

変更後に dotnet build を実行して、対応が必要な残存するレガシー依存関係を特定してください。

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

コードベースを監査して、MessagingToolkit.Barcode を参照しているすべての箇所を特定します。

# Find all using statements
grep -r "using MessagingToolkit.Barcode" --include="*.cs" .

# Find decoder instantiations
grep -r "BarcodeDecoder" --include="*.cs" .

# Find encoder instantiations
grep -r "BarcodeEncoder" --include="*.cs" .

# Find decode calls
grep -r "\.Decode(" --include="*.cs" .

# Find encode calls
grep -r "\.Encode(" --include="*.cs" .

# Find project file references
grep -r "MessagingToolkit" --include="*.csproj" .
grep -r "MessagingToolkit" --include="packages.config" .

# Find all using statements
grep -r "using MessagingToolkit.Barcode" --include="*.cs" .

# Find decoder instantiations
grep -r "BarcodeDecoder" --include="*.cs" .

# Find encoder instantiations
grep -r "BarcodeEncoder" --include="*.cs" .

# Find decode calls
grep -r "\.Decode(" --include="*.cs" .

# Find encode calls
grep -r "\.Encode(" --include="*.cs" .

# Find project file references
grep -r "MessagingToolkit" --include="*.csproj" .
grep -r "MessagingToolkit" --include="packages.config" .

変更が必要なすべてのファイルを文書化してください。 System.Drawing.Bitmap がデコーダーへの入力として使用された場所をメモします — これらの使用法も更新する必要があります。

コード更新タスク

1. dotnet remove package MessagingToolkit.Barcode を実行してパッケージを削除します
2. dotnet add package IronBarcode を実行して IronBarcode をインストールします
3. アプリケーションの起動時に IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; を追加します
4. すべての using MessagingToolkit.Barcode; 文を using IronBarCode; に置き換えます
5. すべての new BarcodeDecoder() パターンを BarcodeReader.Read() 静的呼び出しに置き換えます
6. すべての new BarcodeEncoder() パターンを BarcodeWriter.CreateBarcode() 静的呼び出しに置き換えます
7. すべての result.Text 参照を result.Value に更新します
8. すべての result.BarcodeFormat 参照を result.Format に更新します
9. すべての barcodeWriter.Format = BarcodeFormat.X パターンを更新して、エンコーディングをパラメータとして渡します
10. bitmap.Save() を .SaveAsPng() または IronBarcode 結果の適切な出力メソッドに置き換えます。
11. MessagingToolkit 用に Bitmap 入力のみで使用された using System.Drawing; インポートを削除します
12. フレームワークのアップグレードが移行の一部である場合は、プロジェクトファイルの <TargetFramework> を更新してください

移行後のテスト

• dotnet build がエラーゼロで MessagingToolkit への参照ゼロで完了することを確認します
• grep -r "MessagingToolkit" --include="*.cs" . を実行し、ゼロの結果を確認します
• 実際のバーコード画像を使用してバーコード読み取りをテストし、.Value が期待される文字列を返すことを確認します
• 複数のバーコード画像を使用してバーコード読み取りをテストし、コレクション内のすべてのバーコードが返されることを確認します。
• バーコード生成をテストし、出力ファイルが想定される形式とエンコーディングに一致することを確認します。 PDF読み取り機能を使用する場合は、代表的なPDF文書でテストを行い、ページ番号メタデータが正しいことを確認してください。 ターゲットフレームワークが変更された場合は、新しいランタイムでテストSuite全体を実行して、その他の互換性の問題を特定してください。