Spire.Barcode 與 IronBarcode：C# 條碼庫比較

類型規格要求

Spire.Barcode 的 BarcodeScanner.Scan() 沒有隻接受檔案路徑的重載。 每次讀取操作都要求呼叫程式碼預先聲明條碼格式。 對於單一格式的工作流程，這種方法是可行的，但對於混合格式的文件處理，它會產生一個候選迭代循環：

// Spire.Barcode: multi-format detection requires a guessing loop
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: multi-format detection requires a guessing loop
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

候選數組中每增加一種類型，就需要額外進行一次掃描。 清單中未列出的任何格式都會被默默忽略。 開發人員負責維護詳盡的類型清單，並在新格式進入工作流程時進行重新測試。

詳細功能比較

Spire.條碼方法

Spire.Barcode 的 BarcodeScanner.Scan() 每次呼叫都需要一個 BarCodeType 參數。 當格式已知且有保證時，單一類型呼叫是適當的：

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

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

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

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

Imports Spire.Barcode

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

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

當格式事先未知時，唯一可行的方法是遍歷候選類型。每次遍歷都是一次完整的掃描，任何不在清單中的格式都會被忽略。 結果是一個 string[]，它不攜帶任何類型信息，因此基於格式的下游路由需要呼叫者進行額外的狀態管理。

IronBarcode方法

IronBarcode 的 BarcodeReader.Read() 不需要型別參數。 該庫只需一次掃描即可自動偵測所有受支援符號體系的格式。 無論來源影像包含多少種不同的條碼格式，從影像中讀取條碼都只需要一次方法呼叫：

//IronBarcode— auto-detection built in
var results = BarcodeReader.Read("barcode.png");

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

//IronBarcode— auto-detection built in
var results = BarcodeReader.Read("barcode.png");

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

Imports IronBarcode

'IronBarcode— auto-detection built in
Dim results = BarcodeReader.Read("barcode.png")

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

每個結果物件包含 BarcodeType、Value 和位置元資料。 基於格式的下游路由不需要額外的狀態－類型本身就存在於結果中。

Spire.Barcode 免費層

FreeSpire.Barcode 會在產生的條碼影像上套用大型評估浮水印。 水印覆蓋了條碼，使其不適合生產使用，並妨礙了對生產品質的有效評估。 免費版有意降低了掃描效能，這意味著評估期間進行的吞吐量測量並不能代表 Spire.Barcode 的商業效能。 免費版軟體套件還需要從 E-iceblue 取得註冊金鑰，才能在執行過程中抑制警告對話方塊。 免費版提供的符號集是商業版符號集的子集。 這些限制共同意味著，基於 FreeSpire.Barcode 進行的評估並不能準確反映商業產品的功能。

IronBarcode試用模式

IronBarcode 的試用版是無需許可證金鑰即可使用的授權軟體包。 閱讀功能以全速運行，支援所有符號，且無行為限制。 閱讀速度和準確度選項在試用模式和授權模式下表現完全相同。 試用模式下產生的條碼輸出影像邊緣帶有一個小浮水印； 它不會遮擋條碼本身。IronBarcode評估期間測量的行為是最終部署到生產環境中的行為。

Spire.條碼方法

Spire.Barcode本身不具備PDF讀取功能。 要從 PDF 文件中提取條碼，開發人員必須安裝單獨的 Spire.PDF 軟體包，購買單獨的 Spire.PDF 許可證，並編寫手動頁面迭代和圖像提取程式碼，然後才能開始條碼掃描：

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

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

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

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

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

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

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required even here
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

此模式需要兩個 NuGet 套件、兩份授權協議以及開發人員編寫的頁面管理程式碼。 如果條碼嵌入在 PDF 的向量內容中而不是柵格圖像中，則圖像提取方法可能會完全錯過它們。

IronBarcode方法

IronBarcode 可原生處理 PDF 文件，無需任何額外依賴。 從 PDF 文件中讀取條碼只需呼叫一個方法，使用與圖像檔案相同的 BarcodeReader.Read() API。 每個結果物件中都包含頁碼：

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

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

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

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

Imports IronBarcode

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

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

無需手動提取頁面，無需二級軟體包，也無需額外購買許可證。

Spire.條碼方法

Spire.Barcode 的生成模型以可變的 BarcodeSettings 配置物件為中心。 開發人員實例化設置，分別分配屬性，將設定物件傳遞給 BarCodeGenerator，然後呼叫 GenerateImage():

// Spire.Barcode generation
using Spire.Barcode;

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

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

// Spire.Barcode generation
using Spire.Barcode;

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

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

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

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
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("barcode.png", ImageFormat.Png)

由於設定物件是可變的，因此當在多個生成操作中重複使用單一實例時，配置可能會意外地在多個呼叫之間共用。 生成器類別增加了一個額外的實例化步驟，該步驟本身不包含任何配置邏輯。

IronBarcode方法

IronBarcode 使用靜態工廠方法，並可選擇進行流暢的鍊式呼叫。 沒有設定對象，也沒有生成器實例需要管理：

//IronBarcodegeneration
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

//IronBarcodegeneration
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' IronBarcode generation
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

所有IronBarcode許可等級均提供帶有自訂徽標的二維碼：

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

混合格式文件處理

最初只使用一種條碼格式的團隊，往往會發現隨著時間的推移，其條碼格式會變得越來越多樣化。例如，一個最初使用 Code128 標籤的倉儲應用，現在可能會收到供應商使用 DataMatrix、GS1-128 或二維碼的貨物。 每次有新格式進入工作流程時，都需要更新類型猜測循環中的候選數組，重新測試偵測邏輯，並確認迭代順序不會改變現有格式。 當格式多樣性達到一定程度，使得該循環的維護開銷成為持續的開發成本時，團隊會評估自動檢測是否可以完全消除這種負擔。

PDF集成

文件密集型應用程式經常會遇到需要從 PDF 文件而不是獨立圖像中提取條碼的情況。 在 Spire.Barcode 工作流程中，這種轉變需要獲得 Spire.PDF 許可證，整合第二個軟體包，並編寫頁面迭代和圖像提取基礎架構，然後才能進行任何條碼讀取。 如果團隊在最初購買時沒有預料到這一要求，他們就會發現自己需要管理兩個產品許可證和兩個 API 接口，而這項任務在概念上屬於條碼讀取。 發現 PDF 支援需要單獨購買，是促使用戶重新評估產品選擇的常見原因。

免費層級評估限制

評估過 FreeSpire.Barcode 並購買了商業許可證的團隊有時會反映，商業產品的實際表現與他們的評估結果有所不同。 這是有意為之：免費層級故意降低讀取效能並限制符號集，這意味著在評估期間進行的基準測試和格式覆蓋率測試無法轉移到商業部署中。 當團隊在購買後發現這種差異時，他們通常會尋找替代品，這些替代品的試用行為能夠代表生產行為。

減少產品數量

對技術堆疊進行標準化的組織有時會將 Spire.Barcode 視為不斷成長的 E-iceblue 產品庫中的一個元件，每個元件都有自己的授權費用和續約週期。 如果 Spire.Barcode 的主要驅動力是在文件處理流程中讀取條碼，而不是與 Spire.Doc 或 Spire.XLS 深度集成，那麼團隊會評估一個獨立的條碼庫是否可以降低許可複雜性和支援範圍。

移除 BarCodeType 參數

Spire.Barcode 程式碼庫中的每個 scanner.Scan() 呼叫都帶有一個 BarCodeType 參數。 將這些呼叫替換為 BarcodeReader.Read() 可以完全移除型別參數。 類型猜測迴圈（遍歷候選 BarCodeType 值的 foreach 區塊）可以完全刪除； 一次呼叫 BarcodeReader.Read() 即可替換整個循環。

更新退貨類型

Spire.Barcode 的 Scan() 回傳 string[]。IronBarcode回傳一個 BarcodeResults 集合。 呼叫指派給 string[] 或將結果傳遞給期望該類型的方法的網站需要更新。 將值提取為數組使用 .Select(r => r.Value).ToArray(); 訪問第一個結果使用 .First()?.Value。

移除 Spire.PDF 包

如果安裝 Spire.PDF 只是為了支援從 PDF 檔案中提取條碼，那麼在遷移到IronBarcode後可以將其刪除。 所有 using Spire.Pdf; 導入和手動頁面迭代塊都被單一 BarcodeReader.Read("file.pdf") 呼叫所取代。 如果 Spire.PDF 用於條碼擷取以外的其他文件操作，則應保留該條碼，並且僅替換與條碼相關的程式碼路徑。

命名空間變更

將 using Spire.Barcode; 替換為 using IronBarCode;。 枚舉 BarCodeType 被 BarcodeEncoding 替換以進行生成，讀取時不需要等效項。 許可證初始化從 BarcodeSettings.ApplyKey() 或 Spire.License.LicenseProvider.SetLicenseKey() 更改為在應用程式啟動時分配單一 IronBarCode.License.LicenseKey 屬性。