C# 中的 OCR CodeProject Tutorial：使用 IronOCR 從影像中萃取文字

如何在.NET專案中安裝IronOCR？

將 OCR 新增至 .NET 10 專案的最快方法是透過 NuGet 套件管理器。 在專案目錄中開啟終端機並執行 dotnet CLI 命令，或使用 Visual Studio 中的套件管理器控制台：

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

安裝完成後，NuGet 套件管理員會自動下載所有必要的組件並連接參考。 IronOCR 的目標框架為 .NET Framework 4.6.2+、.NET Core 3.1+ 以及 .NET 5 至 .NET 10，因此它可以在控制台應用程式、ASP.NET Core 服務、WPF 應用程式和 Azure Functions 中運行。

您無需註冊許可證金鑰即可在本機上進行測試－在套用許可證之前，輸出結果會顯示試用浮水印。 新增 using 指令，並在準備投入生產環境時，在啟動時傳遞一次金鑰：

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronOcr

' Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

有關定價和啟用詳情，請參閱IronOCR 授權頁面。

如何從圖像文件中提取文字？

核心 OCR 工作流程涉及三個物件：IronTesseract（引擎）、OcrInput（輸入容器）和 OcrResult（輸出）。 下面的範例讀取一個 PNG 文件，並將識別出的文字列印到控制台。

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.LoadImage("sample-document.png")

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

如何處理掃描文件和TIFF文件？

在文件掃描工作流程中，多頁 TIFF 檔案很常見。 IronOCR 使用 LoadImageFrames 來處理它們，這樣您就可以精確地選擇要處理的訊框（頁面）——當您只需要大型存檔的子集時非常有用。

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    Dim pageIndices As Integer() = {0, 1, 2}
    input.LoadImageFrames("scanned-documents.tiff", pageIndices)

    ' Correct skew and remove noise before reading
    input.Deskew()
    input.DeNoise()

    Dim result As OcrResult = ocr.Read(input)

    For Each page In result.Pages
        Console.WriteLine($"Page {page.PageNumber}:")
        Console.WriteLine(page.Text)
    Next
End Using

如何設定 OCR 的語言支援？

IronOCR 預設讀取英文文字。 若要處理其他語言的文檔，請安裝相符的語言 NuGet 套件，並在 IronTesseract 實例上設定 Language 屬性。

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

然後配置引擎，對於雙語文檔，添加第二種語言：

using IronOcr;
using IronOcr.Languages;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.German;

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronOcr.Languages;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.German;

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr
Imports IronOcr.Languages

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.German

' For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French)

Using input As New OcrInput()
    input.LoadImage("german-invoice.png")

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

IronOCR 支援超過 125 種語言，每種語言都以單獨的輕量級 NuGet 套件的形式分發。 這樣可以保持生產二進位檔案的大小—只包含應用程式實際需要的語言資料。 當您呼叫 AddSecondaryLanguage 時，引擎會在辨識過程中融合主要語言模型和輔助語言模型。

如何處理 OCR 錯誤並提高識別結果？

生產應用需要針對OCR流程進行錯誤處理。影像品質問題、檔案缺失或格式不支援都可能導致異常。 將呼叫包裹在 try/catch 區塊中，可以得到一個清晰的恢復路徑。

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.English

Try
    Using input As New OcrInput()
        input.LoadImage("document.png")
        input.DeNoise()
        input.Deskew()

        Dim result As OcrResult = ocr.Read(input)

        If result.Text.Length > 0 Then
            Console.WriteLine("Recognised text:")
            Console.WriteLine(result.Text)
        Else
            Console.WriteLine("No text was detected in the image.")
        End If
    End Using
Catch ex As Exception
    Console.WriteLine($"OCR error: {ex.Message}")
End Try

以下幾個設定有助於提高準確率：

• ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto -- 讓 Tesseract 自動選擇單列、多列和單字佈局
• ocr.Configuration.ReadBarCodes = false -- 如果您正在處理純文字文件並希望提高吞吐量，請停用條碼檢測
• ocr.Configuration.TesseractVersion = TesseractVersion.Tesseract5 -- 確保您使用最快的可用引擎

對於欄位位置可預測的結構化表單，請使用基於區域的 OCR僅讀取重要區域：

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr
Imports IronSoftware.Drawing

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    Dim region As New CropRectangle(x:=50, y:=200, width:=600, height:=100)
    input.LoadImage("form.png", region)

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

將辨識範圍限制在裁切矩形區域內，可減少大影像處理時間高達 90%。 此技術非常適合用於提取發票號碼、讀取表單欄位和掃描身分證件。 更多詳情請參閱區域 OCR 使用指南。

如何從識別的文本創建可搜尋的 PDF？

將掃描影像存檔轉換為可搜尋的 PDF 檔案是 OCR 最有價值的應用案例之一。 生成的檔案保留了原始的視覺外觀，同時嵌入了一個不可見的文字層，PDF 檢視器、搜尋引擎和螢幕閱讀器可以對其進行索引。

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

Imports IronOcr

Dim ocr As New IronTesseract()

Using input As New OcrInput()
    input.Title = "Quarterly Report Q1 2026"
    input.LoadImage("page1.png")
    input.LoadImage("page2.png")
    input.LoadImage("page3.png")

    Dim result As OcrResult = ocr.Read(input)
    result.SaveAsSearchablePdf("searchable-output.pdf")

    Console.WriteLine("Searchable PDF created.")
    Console.WriteLine($"Pages processed: {result.Pages.Count}")
End Using

如何解讀條碼和文字？

IronOCR 可讀取嵌入在與印刷文字相同影像中的條碼和二維碼，無需執行單獨的條碼庫。 透過一個配置屬性啟用該功能：

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

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

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

支援的條碼格式包括 Code 128、Code 39、EAN-13、EAN-8、UPC-A、UPC-E、PDF417、Data Matrix 和 QR 碼。 詳細資訊請參閱IronOCR 條碼讀取指南。

這項功能在物流、醫療保健和零售應用中尤其有用，因為運輸標籤、病人腕帶和產品標籤都包含人可讀文字和機器可讀條碼。

如何將 IronOCR 與其他 .NET OCR 選項進行比較？

開發人員在評估 .NET 的 OCR 程式庫時，通常會考慮 IronOCR、Tesseract.NET 以及 Google Cloud Vision 或 Azure電腦視覺 等雲端服務。 下表總結了主要區別：

Tesseract是由 Google 維護的開源項目，它為 IronOCR 和 Tesseract.NET 提供底層技術支援。 IronOCR 增加了 .NET 慣用的打包方式、自動模型管理以及原始 Tesseract 綁定所缺乏的生產輸出功能（可搜尋的 PDF、hOCR 匯出）。 Azure 電腦視覺提供最先進的雲端精確度，但引入了網路延遲和每次呼叫成本，不適合高容量或離線工作流程。

對於資料隱私法規禁止將文件傳送到外部服務的情況（例如醫療記錄、法律文件、財務報表），像 IronOCR 這樣的本地庫是合適的選擇。

下一步計劃是什麼？

現在，您擁有了向任何 .NET 10 應用程式添加 OCR 的構建模組：透過 NuGet 安裝、基本圖像到文字提取、多頁 TIFF 處理、語言配置、錯誤處理、基於區域的讀取、條碼檢測和可搜尋的 PDF 生成。

如需深入了解，請瀏覽以下 IronOCR 資源：

IronOCR 文件主頁——完整的 API 參考和功能指南 影像濾鏡教學－所有預處理濾鏡的詳細指南 條碼讀取指南－二維碼和線性條碼及文本 -區域 OCR 使用指南－基於作物的表單和 ID 識別 -語言參考-- 超過 125 種支援語言的完整列表

• API 參考——所有類別、方法和屬性

有關許可問題或在生產環境中部署 IronOCR，請造訪IronOCR 許可頁面。 免費試用授權可在評估期間移除輸出浮水印， Iron Software 的支援團隊可解答任何程度的技術問題。

!{--01001100010010010100001001010010010000010101001001011001010111110100011101000101010101 01000101111101010011010101000100000101010010010101000100010101000100010111110101011101001000110 1010101000100100001011111010100000101001001001111010001000101010101010000110101010100101010101011 10101010001010010010010010010000010100110001011111010000100100110001001111101000011010010111111010000110100101110--