如何使用 C# 和 IronOCR 讀取特殊文件

Curtis Chau
Curtis Chau
已更新: 2026年8月2日

用單一的通用方法準確解讀標準文字文件、車牌、護照和照片等特定文件是非常困難的。 這些挑戰源自於每種文件類型的格式、佈局和內容的多樣性,以及影像品質、失真和專業內容的差異。 此外,隨著文件類型範圍的擴大,實現上下文理解以及平衡效能和效率變得更加複雜。

IronOCR 引入了針對特定文件(例如標準文字檔案、車牌、護照和照片)執行 OCR 的具體方法,以實現最佳的準確性和性能。

快速開始:一行代碼讀取護照

使用IronOCR的ReadPassport擴展,可以在最少的設置下提取所有重要的護照詳細信息。只需一行代碼 - 假設您已安裝IronOCR和AdvancedScan - 您就能快速且輕鬆地獲得結構化的結果數據,如姓名、護照號碼、國家等。

  1. 1使用 IronOCR 安裝 NuGet Package Manager

    PM > Install-Package IronOcr

  2. 2複製並運行這段程式碼。

    var result = new IronTesseract().ReadPassport(new OcrInput().LoadImage("passport.jpg"));
  3. 3部署到您的生產環境進行測試

    立即在您的項目中開始使用 IronOCR,並使用 免費試用
    arrow pointer

關於包裹

方法 ReadLicensePlate、ReadPassport、ReadPhoto 和 ReadScreenShot 是基礎IronOCR程式庫的擴充方法,並需要安裝IronOcr.Extensions.AdvancedScan 套件。

這些方法與OCR引擎配置一起使用,如黑名單和白名單。所有方法均支援多種語言,包括中文、日文、韓文和拉丁字母,除了ReadPassport方法。 請注意,每一種語言都需要額外的語言包,IronOcr.Languages。

在 .NET Framework 上使用進階掃描功能需要專案在 x64 架構上運作。 進入專案配置,取消選取「首選 32 位元」選項即可實現此目的。 在以下故障排除指南中了解更多: ".NET Framework上的Advanced Scan"。

閱讀文件範例

ReadDocument方法是一種可靠的文件閱讀方法,專門用於包含大量文字的掃描文件或紙質文件的照片。 PageSegmentationMode配置對於讀取不同佈局的文字檔案非常重要。

例如, SingleBlock和SparseText類型可以從表格佈局中檢索大量資訊。 這是因為SingleBlock假定文字保持為一個區塊,而SparseText假定文字分散在整個文件中。

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

// Configure OCR engine
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleBlock;

using var input = new OcrInput();

input.LoadPdf("Five.pdf");

// Perform OCR
OcrResult result = ocr.ReadDocument(input);

Console.WriteLine(result.Text);

以下方法是IronOCR基本包的擴展方法,需要安裝IronOcr.Extensions.AdvancedScan包。

讀取車牌範例

ReadLicensePlate方法已優化,用於從照片中讀取車牌。 此方法傳回的特殊資訊是Licenseplate屬性,其中包含所提供文件中車牌位置的資訊。

using IronOcr;
using IronSoftware.Drawing;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputLicensePlate = new OcrInput();

inputLicensePlate.LoadImage("LicensePlate.jpeg");

// Perform OCR
OcrLicensePlateResult result = ocr.ReadLicensePlate(inputLicensePlate);

// Retrieve license plate coordinates
Rectangle rectangle = result.Licenseplate;

// Retrieve license plate value
string output = result.Text;

閱讀護照範例

ReadPassport方法已優化,可通過掃描機器可讀區域(MRZ)內容來從護照照片中讀取並提取護照資訊。 MRZ 是護照、身分證和簽證等官方文件中特別定義的區域。 MRZ通常包含重要的個人信息,例如持有者的姓名、出生日期、國籍和文件號碼。 目前,此方法僅支援英語。

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPassport = new OcrInput();

inputPassport.LoadImage("Passport.jpg");

// Perform OCR
OcrPassportResult result = ocr.ReadPassport(inputPassport);

// Output passport information
Console.WriteLine(result.PassportInfo.GivenNames);
Console.WriteLine(result.PassportInfo.Country);
Console.WriteLine(result.PassportInfo.PassportNumber);
Console.WriteLine(result.PassportInfo.Surname);
Console.WriteLine(result.PassportInfo.DateOfBirth);
Console.WriteLine(result.PassportInfo.DateOfExpiry);

結果

閱讀護照

請確保文件中僅包含護照照片。 任何頁首和頁尾文字都可能幹擾該方法,並導致意外的輸出。

查看照片範例

ReadPhoto方法已優化,用於讀取包含難讀文本的圖片。 該方法返回TextRegions屬性,其中包含有關檢測到的文本的重要信息,例如Region、TextInRegion和PageNumber。

using IronOcr;
using IronSoftware.Drawing;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPhoto = new OcrInput();
inputPhoto.LoadImageFrame("photo.tif", 2);

// Perform OCR
OcrPhotoResult result = ocr.ReadPhoto(inputPhoto);

// index number refer to region order in the page
int number = result.TextRegions[0].PageNumber;
string textinregion = result.TextRegions[0].TextInRegion;
Rectangle region = result.TextRegions[0].Region;

閱讀螢幕截圖範例

ReadScreenShot方法已優化,用於讀取包含難讀文本的截圖。 與 ReadPhoto 方法類似,它也傳回TextRegions屬性。

using IronOcr;
using System;
using System.Linq;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputScreenshot = new OcrInput();
inputScreenshot.LoadImage("screenshot.png");

// Perform OCR
OcrPhotoResult result = ocr.ReadScreenShot(inputScreenshot);

// Output screenshoot information
Console.WriteLine(result.Text);
Console.WriteLine(result.TextRegions.First().Region.X);
Console.WriteLine(result.TextRegions.Last().Region.Width);
Console.WriteLine(result.Confidence);

常見問題

IronOCR可以讀取哪些類型的文件?

IronOCR可以讀取多種文件類型,包括標準文本文件、車牌、護照和照片。它提供了專門的方法,例如ReadPassport、ReadLicensePlate、ReadPhoto和ReadScreenShot,以針對每種文件類型優化準確性和性能。

IronOCR如何增強特定文件類型的閱讀效果?

IronOCR通過使用考慮多種格式、佈局和內容類型的定制方法來增強特定文件類型的閱讀效果。例如,專門的功能用於閱讀車牌和護照,通過聚焦於護照機讀區等相關區域來提高準確性。

IronOCR可以從護照中提取MRZ信息嗎?

可以,IronOCR中的ReadPassport方法專門用於從護照照片的機讀區提取信息,提供持有人姓名、國籍和護照號等詳細資訊。

.NET Framework中使用IronOCR是否需要額外配置?

是的,當在.NET Framework中使用IronOCR的高級掃描功能時,重要的是要通過取消勾選專案配置中的'Prefer 32-bit'選項,在x64架構上執行專案。

IronOCR是否支持多種語言的OCR處理?

IronOCR支持多種語言的OCR處理,包括中文、日文、韓文和拉丁字母,通過額外的語言包。然而,ReadPassport方法目前僅支持英語。

IronOCR中的`ReadPhoto`方法是用來做什麼的?

IronOCR中的ReadPhoto方法針對包含難以閱讀文字的圖像進行了優化,提供文本區域和頁碼等詳細資訊,以獲得更好的文字提取結果。

IronOCR如何處理從截圖中提取文本?

IronOCR使用ReadScreenShot方法從截圖中提取文字。此方法經過優化,可偵測並提供文字區域信息,允許從屏幕截圖中有效提取文字。

IronOCR中`ReadLicensePlate`方法的用途是什麼?

IronOCR中的ReadLicensePlate方法經過優化,用於從照片中讀取車牌,允許提取車牌的坐標和值,這對交通監控和車輛識別系統等應用至關重要。

使用`ReadPassport`方法時應該注意什麼?

在使用ReadPassport方法時,確保圖像僅包含護照照片,以避免混淆和意外的輸出。任何額外的文字,如標頭和頁腳,應予以排除。

如何安裝IronOCR以在C#中進行文件閱讀?

IronOCR可以通過NuGet軟體包管理器安裝。確保安裝了IronOCR和IronOcr.Extensions.AdvancedScan,以利用閱讀專門文件類型的方法,例如車牌和護照。

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 6,394,824版本:2026.11剛剛發布