型別規範要求

Spire.Barcode 的 BarcodeScanner.Scan() 沒有只接受檔案路徑的重載。 每次讀取操作都要求呼叫程式碼提前宣告條碼格式。 對於單格式工作流程，這是可行的，但對於混合格式文件處理，它會產生候選迴圈：

// Spire.Barcode: multi-format detection iterates through candidate types
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 iterates through candidate types
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.Barcode 方法

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: automatic format detection
var results = BarcodeReader.Read("barcode.png");

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

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

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

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

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

每個結果物件都包括 Value 和位置元資料。 基於格式的下游路由不需要額外狀態 - 型別已存在於結果中。

Spire.Barcode 免費層

FreeSpire.Barcode 在生成的條碼影像中應用大水印。 水印覆蓋條碼，使其不適合生產使用，並隱藏生成質量的有效評估。 在免費版本中，有意降低掃描性能，這意味著在評估期間進行的傳輸量測量不代表商業 Spire.Barcode 性能。 免費套件還需要從 E-iceblue 獲取的註冊金鑰，在執行期間壓制警告對話框。 免費層中的可用符號集是商業提供中的一個子集。 這些限制共同意味著基於 FreeSpire.Barcode 的評估不準確代表商業產品的交付。

IronBarcode試用模式

IronBarcode 的試用是使用無授權金鑰的已授權套件。 讀取以全速運行，具備完整的符號支援，無行為限制。 讀取速度和準確性選項 在試用和許可模式下表現完全相同。 試用模式下生成的條碼輸出在影像邊緣攜帶小水印； 不會遮蔽條碼本身。 在評估IronBarcode期間測量的行為即出貨到生產環境的行為。

Spire.Barcode 方法

Spire.Barcode 沒有原生的 PDF 讀取能力。 要從 PDF 文件中提取條碼，開發者必須安裝單獨的 Spire.PDF 套件，購買單獨的 Spire.PDF 授權，並寫手動頁面迭代和影像提取程式碼，才能開始條碼掃描：

// Spire.Barcode + Spire.PDF: separate package and license required
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 for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
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 for each scan call
        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 for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

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

IronBarcode方法

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

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

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

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

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

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

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

無需手動頁面提取、無需第二個套件、無需額外購買授權。

Spire.Barcode 方法

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")

帶自訂徽標的 QR 碼在所有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 或 QR 碼的供應商的出貨。 每一個進入工作流程的新格式都需要更新型別猜測迴圈中候選陣列，重新測試檢測邏輯，並確認現有格式未被迭代順序取代。 當格式多樣性達到造成該迴圈維護開銷成為重複開發成本的地步時，團隊會評估自動檢測是否完全消除這一負擔。

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 用於生成時替換，讀取時不需要對應。 授權初始化從 Spire.License.LicenseProvider.SetLicenseKey() 變更為在應用啟動時進行單個 IronBarCode.License.LicenseKey 屬性指定。