OCR in Azure vs. IronOCR : Quelle solution de reconnaissance optique de caractères convient le mieux aux projets .NET ?

La pile asynchrone WinRT

Chaque opération OCR de base avec Windows.Media.Ocr nécessite de naviguer à travers plusieurs couches de l'interface de l'API WinRT avant que la reconnaissance puisse commencer :

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

Imports System.Threading.Tasks
Imports Windows.Media.Ocr
Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Storage.Streams
Imports Windows.Globalization

Public Async Function ExtractTextAsync(imagePath As String) As Task(Of String)
    ' Step 1: WinRT file system access
    Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)

    ' Step 2: Open WinRT stream
    Using stream As IRandomAccessStream = Await file.OpenAsync(FileAccessMode.Read)

        ' Step 3: Create bitmap decoder
        Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)

        ' Step 4: Decode to SoftwareBitmap
        Dim bitmap As SoftwareBitmap = Await decoder.GetSoftwareBitmapAsync()

        ' Step 5: Check language availability — Nothing if not installed on this machine
        Dim engine As OcrEngine = OcrEngine.TryCreateFromLanguage(New Language("en-US"))
        If engine Is Nothing Then
            Throw New Exception("OCR engine not available for this language")
        End If

        ' Step 6: Recognize
        Dim result As OcrResult = Await engine.RecognizeAsync(bitmap)
        Return result.Text
    End Using
End Function

La vérification nulle sur engine n'est pas facultative. Si le pack de langue cible n'est pas installé sur la machine exécutant le code, TryCreateFromLanguage renvoie null et la reconnaissance est impossible. Il n'y a pas de solution de repli ; L'application doit signaler toute erreur à l'utilisateur ou échouer silencieusement.

Comparaison détaillée des fonctionnalités

Approche Windows.Media.OCR

La dépendance à WinRT se manifeste dans le fichier projet avant même l'exécution d'une seule ligne de code. Le TargetFramework doit spécifier une version de plateforme Windows :

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

Avec ce TFM, le projet ne peut pas être utilisé depuis un conteneur Linux. Une image Dockerbasée sur mcr.microsoft.com/dotnet/aspnet:8.0 — l'image de base Linuxstandard pour les déploiements ASP.NET — n'a pas de runtime WinRT. Tenter de référencer les types Windows.Media.Ocr dans un projet ciblant net8.0 (sans suffixe Windows) produit des erreurs de compilation, pas des erreurs d'exécution. Le verrouillage est imposé au moment de la compilation.

Lorsque des besoins en reconnaissance optique de caractères (OCR) apparaissent dans une architecture de microservices où le processus OCR s'exécute sous Linux, ou dans un pipeline CI/CD qui produit des images Dockermultiplateformes, Windows.Media.Ocr n'est pas une option à évaluer — il est éliminé avant même le premier pic d'utilisation.

Approche d'IronOCR

IronOCR cible net6.0, net7.0, net8.0, et net9.0 sans TFMs spécifiques à la plateforme. Le même package NuGet et le même fichier binaire d'application fonctionnent sous Windows, Linuxet macOS. Déployer IronOCR sur Docker nécessite une ligne apt-get pour libgdiplus sur l'image de base Linux, rien d'autre :

FROM mcr.microsoft.com/dotnet/aspnet:8.0
# Linuxdependency for System.Drawing
RUN apt-get update && apt-get install -y libgdiplus

COPY --from=build /app/publish /app
WORKDIR /app
ENTRYPOINT ["dotnet", "YourApp.dll"]

Le code de l'application lui-même reste inchangé entre les déploiements sous Windows et Linux :

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// Non platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// Non platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text As String = New IronTesseract().Read("document.jpg").Text

IronOCR fonctionne sur AWS Lambda , Azure Functions sur Linux et directement sur les serveurs Linux sans modification de code. La cible de déploiement relève de la configuration, et non d'une contrainte architecturale.

Approche Windows.Media.OCR

OcrEngine.TryCreateFromLanguage renvoie null lorsque la langue demandée n'est pas installée. TryCreateFromUserProfileLanguages renvoie null lorsqu'il n'existe aucun pack de langue OCR. Les deux méthodes nécessitent une gestion des valeurs nulles, et aucune ne propose de solution de récupération élégante : il est impossible d'installer un langage à partir du code ou de l'intégrer à l'application :

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

Imports Windows.Globalization
Imports Windows.Media.Ocr

' Windows.Media.Ocr: language availability is a runtime unknown
' Returns Nothing if the language pack is not installed on this machine

Dim engine = OcrEngine.TryCreateFromLanguage(New Language("fr-FR"))

If engine Is Nothing Then
    ' French OCR is simply unavailable — no recovery path
    ' User must go to Windows Settings > Language to install French
    Throw New InvalidOperationException("French OCR unavailable. Install the French language pack in Windows Settings.")
End If

Dim result = Await engine.RecognizeAsync(bitmap)

Le déploiement d'une application de traitement de documents multilingue avec Windows.Media.Ocr nécessite la coordination de l'installation du module linguistique Windows sur chaque machine de la cible de déploiement. Sur un serveur partagé ou sur la machine d'un utilisateur gérée par une stratégie de groupe, cela ne dépend pas du développeur.

Approche d'IronOCR

IronOCR distribue les modèles de langage sous forme de packages NuGet dédiés qui se déploient en même temps que le binaire de l'application. Les données linguistiques sont incluses dans le fichier de compilation, et non dans la configuration du système d'exploitation. Supporting 125+ languages is a dotnet add package operation:

dotnet add package IronOcr.Languages.French, IronOcr.Languages.German, IronOcr.Languages.Arabic, IronOcr.Languages.ChineseSimplified

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.French
ocr.AddSecondaryLanguage(OcrLanguage.German)

' Works on any machine, any OS, zero OS configuration required
Dim result = ocr.Read("multilingual-document.jpg")
Console.WriteLine(result.Text)

Le catalogue complet des langues couvre le latin, le CJK, l'arabe, l'hébreu, le devanagari, le cyrillique et des ensembles spécialisés incluant la notation mathématique. Chaque version de pack de langue est liée à la version du package IronOCR , de sorte que le modèle de langue en production corresponde à celui testé localement.

Approche Windows.Media.OCR

L'API accepte un SoftwareBitmap et renvoie du texte. La qualité d'image qui évolue entre ces deux points n'est pas configurable. Les développeurs qui doivent améliorer la précision sur des entrées sub-optimales doivent implémenter le prétraitement manuellement en utilisant les APIs de composant d'imagerie Windows avant de construire le SoftwareBitmap. Il s'agit d'un code source distinct, avec ses propres contraintes de maintenance, et il reste spécifique à Windows pour la même raison que l'API OCR elle-même :

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

Imports System.Threading.Tasks

' Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
' Skewed, noisy, or low-resolution images degrade accuracy with no remedy
' Manual preprocessing via separate Windows Imaging APIs is the only option

Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
' bitmap goes directly to recognition with no quality improvement
Dim result = Await engine.RecognizeAsync(bitmap)

Pour les numérisations de documents standard et propres (environnement de numérisation contrôlé, éclairage constant, 300 DPI minimum, orientation correcte), cette limitation est gérable. Pour les chaînes de traitement de documents qui reçoivent des images provenant d'appareils photo de téléphones portables, de scanners à plat avec un mauvais alignement de l'alimentation automatique, de documents faxés ou de photocopies, cela signifie soit construire une couche de prétraitement à partir de zéro, soit accepter une dégradation de la précision.

Approche d'IronOCR

La classe OcrInput d'IronOCR offre un pipeline de prétraitement avec des méthodes de filtre individuelles qui s'appliquent en séquence. Les filtres de correction de la qualité d'image permettent de corriger les principaux facteurs de perte de précision dans le traitement des documents de production :

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

' IronOCR: explicit preprocessing pipeline
' Each filter targets a specific quality defect
Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")

    input.Deskew()              ' Correct page rotation up to ~40 degrees
    input.DeNoise()             ' Remove scanner speckle and compression artifacts
    input.Contrast()            ' Boost contrast on faded or washed-out text
    input.Binarize()            ' Convert to black/white with optimal threshold
    input.EnhanceResolution(300) ' Scale image to 300 DPI for recognition

    Dim result = New IronTesseract().Read(input)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

Pour le cas général, IronOCR applique un prétraitement automatique lors de l'appel à Read directement sur un chemin de fichier — le moteur détecte les problèmes de qualité et les corrige sans configuration explicite du filtre. Le tutoriel des filtres d'images couvre l'ensemble complet de filtres, y compris Sharpen, Dilate, Erode, Invert, et ToGrayScale pour des scénarios spécialisés. Les filtres de correction des couleurs et la correction de l'orientation étendent encore davantage le processus pour les documents présentant des profils de couleur non standard ou une rotation multi-angle.

Approche Windows.Media.OCR

L'API ne contient pas de chemin d'accès aux fichiers PDF. Pour OCRiser un PDF scanné avec Windows.Media.Ocr, le développeur doit : rendre chaque page vers un SoftwareBitmap en utilisant une bibliothèque de rendu PDF séparée (aucune d'entre elles n'étant intégrée dans Windows), itérer les pages, appeler RecognizeAsync par page, et concaténer les résultats manuellement. Cette bibliothèque de rendu elle-même implique des considérations supplémentaires en matière de licences et de déploiement. Le code Windows.Media.Ocr représente la plus petite partie de l'implémentation totale :

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

' Windows.Media.Ocr: no PDF support
' Requires external PDF renderer to rasterize pages before OCR
' Conceptual pattern — a PDF rendering library is not provided by Windows APIs

' Step 1: Use external PDF library to render page to bitmap (not shown)
' Step 2: Pass rendered bitmap to Windows OCR
' Dim bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex) ' external library required

Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
If engine Is Nothing Then
    Throw New Exception("No OCR language available")
End If

' Step 3: Recognize the rasterized page
' Dim result = Await engine.RecognizeAsync(bitmap)
' Step 4: Collect and concatenate results across all pages manually

L'étape de rendu PDF externe ajoute à elle seule une dépendance, une courbe d'apprentissage supplémentaire et une surface d'échec supplémentaire à ce qui était initialement une solution " gratuite et intégrée ".

Approche d'IronOCR

IronOCR lit les fichiers PDF nativement. Aucun moteur de rendu externe, aucune étape de rastérisation, aucun assemblage manuel de pages. La même méthode IronTesseract.Read qui accepte les chemins d'images accepte aussi les chemins de PDF. La reconnaissance optique de caractères (OCR) des fichiers PDF en .NET se fait sur une seule ligne :

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// PDF consultable output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// PDF consultable output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

' IronOCR: native PDF support — no external renderer needed
Dim text As String = New IronTesseract().Read("scanned-document.pdf").Text

' Password-protected PDFs
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
End Using

' PDF consultable output: make a scanned PDF text-searchable
Dim ocrResult = New IronTesseract().Read("scanned-archive.pdf")
ocrResult.SaveAsSearchablePdf("searchable-output.pdf")

La fonction PDF consultable intègre une couche de texte par-dessus l'image numérisée originale, produisant un PDF qui préserve la fidélité visuelle tout en permettant la recherche en texte intégral et le copier-coller. Il s'agit d'une exigence courante pour les systèmes de gestion documentaire et les archives de conformité. Windows.Media.Ocr ne peut pas produire ce résultat à aucun niveau de son API.

L'application dépasse les capacités d'un bureau Windows.

Le déclencheur le plus courant est une modification des exigences qui introduit une cible de déploiement non-Windows. Un utilitaire de bureau, initialement conçu comme un outil interne à Windows, est promu en service web, en microservice basé sur Dockerou en fonction cloud. Dès que cela se produit, Windows.Media.Ocr devient un bloqueur. Le composant OCR nécessite une réécriture complète car l'API n'existe pas sur la plateforme cible : il n'y a ni portage, ni adaptateur de compatibilité, ni option de compilation conditionnelle pour résoudre le problème. Les équipes qui avaient anticipé cette réécriture avec IronOCR ne sont pas concernées.

Les exigences linguistiques dépassent le nombre de packs installés.

Les chaînes de traitement de documents étendent souvent leur portée. Un système conçu pour traiter les factures en anglais doit désormais également gérer les documents en français, en allemand, en arabe ou en japonais. Avec Windows.Media.Ocr, la prise en charge de ces langues nécessite la coordination de l'installation du module linguistique du système d'exploitation sur chaque cible de déploiement : machines de développement, machines virtuelles de test, serveurs de production et tous les conteneurs impliqués. Dans les environnements gérés par stratégie de groupe ou dans les machines virtuelles cloud avec une empreinte système minimale, cette coordination est impraticable. Les packs de langue d'IronOCR basés sur NuGet sont déployés avec l'application et ne nécessitent aucune coordination avec le système d'exploitation.

Le traitement des fichiers PDF est ajouté au périmètre.

Lorsque la demande initiale était " des images OCR provenant d'un scanner à plat ", Windows.Media.Ocr fonctionne. Lorsque l'exigence s'étend au " traitement également du retard accumulé dans les fichiers PDF numérisés de nos archives ", une deuxième bibliothèque entre en jeu. Cette bibliothèque représente une dépendance supplémentaire, une considération supplémentaire en matière de licences et une surface de défaillance supplémentaire. Les équipes qui ont besoin à la fois de la reconnaissance optique de caractères (OCR) d'images et de PDF sur une API unifiée constatent IronOCR élimine d'emblée l'architecture à deux bibliothèques.

La précision se dégrade avec les entrées du monde réel

Les environnements de numérisation contrôlés produisent des images nettes. Les données d'entrée réelles (photos prises avec des téléphones portables, numérisations à plat légèrement déformées, documents reçus par fax plus anciens, photocopies) entraînent une dégradation de la précision qui ne peut être corrigée dans Windows.Media.Ocr. Lorsque les plaintes des clients concernant les SMS non reçus commencent à arriver, les équipes découvrent que l'étape de prétraitement qu'elles avaient négligée est devenue nécessaire. L'adaptation du prétraitement à l'aide des API d'imagerie Windows représente un effort de développement considérable qui limite la solution à Windows uniquement. Le pipeline de prétraitement d'IronOCR est déjà en place.

La question du déploiement du serveur se pose

La documentation de Windows.Media.Ocr positionne explicitement l'API pour les applications clientes. Son exécution dans un contexte serveur (une application ASP.NET traitant des documents téléchargés par l'utilisateur, un service Windows consommant une file d'attente de documents) nécessite un environnement Serveur Windowsavec l'expérience utilisateur de bureau installée, ce qui représente un profil de machine virtuelle plus lourd et plus coûteux qu'un conteneur Linux. Lorsque l'équipe d'infrastructure demande si le processus OCR peut s'exécuter sur une instance Linuxpour réduire les coûts d'hébergement, la réponse concernant Windows.Media.Ocr est non.

Modification du fichier projet TFM

Windows.Media.Ocr nécessite un TFM spécifique à Windows dans le fichier de projet (net8.0-windows10.0.19041.0 ou similaire). Supprimer cette dépendance pour prendre en charge les cibles multiplateformes implique de supprimer le suffixe TFM. IronOCR cible net6.0, net8.0, et net9.0 sans suffixe spécifique à Windows. Lors de la migration, vérifiez qu'aucune autre dépendance de l'API WinRT du projet ne nécessite le TFM Windows ; d'autres fonctionnalités de la plateforme Windows (intégration à l'interface, notifications Windows, etc.) peuvent devoir être abstraites derrière des vérifications de la plateforme.

Migration asynchrone vers synchrone

Windows.Media.Ocr est entièrement asynchrone — RecognizeAsync renvoie IAsyncOperation<OcrResult> qui se mappe à Task<OcrResult> via interop WinRT. IronOCR propose des chemins synchrones et asynchrones. Le ocr.Read("file.jpg") synchrone remplace directement la chaîne d'attente à plusieurs étapes. Pour les applications serveur où l'appel OCR se trouve dans un service en arrière-plan ou un pipeline basé sur des tâches, le chemin asynchrone est également disponible. Dans les deux cas, la transition de plus de 6 étapes asynchrones à un seul appel est simple :

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After: IronOCR — 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After: IronOCR — 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Media.Ocr

' Before: Windows.Media.Ocr — 6+ await operations
Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)
Using stream = Await file.OpenAsync(FileAccessMode.Read)
    Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)
    Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
    Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
    Dim winResult = Await engine.RecognizeAsync(bitmap)
    Dim text As String = winResult.Text
End Using

' After: IronOCR — 1 call, same result, any platform
Dim text As String = New IronTesseract().Read(imagePath).Text

Remplacement du pack de langue

Pour chaque langue précédemment résolue via OcrEngine.TryCreateFromLanguage(new Windows.Globalization.Language("fr-FR")), installez le pack de langues correspondant d'IronOCR et définissez ocr.Language = OcrLanguage.French. Le catalogue de langues IronOCR répertorie l'ensemble des plus de 125 packs disponibles. Les codes de langue se mappent directement depuis les balises BCP-47 à l'énum OcrLanguage.

Suppression de la gestion du moteur nul

Windows.Media.Ocr exige une vérification de valeur nulle à chaque appel de création de moteur. IronOCR génère des exceptions structurées plutôt que de renvoyer null en cas d'échec de configuration ou d'initialisation. Supprimez les clauses de protection contre les valeurs nulles et remplacez-les par une gestion standard des exceptions lorsque cela est nécessaire. Le résultat est un site d'appel plus propre, sans mode de défaillance lié à une " langue silencieusement indisponible ".