Comprendre Pdfium.NET

Pdfium.NET est un wrapper .NET pour la bibliothèque PDFium de Google, réputée pour son efficacité et sa rapidité dans le rendu des documents PDF. Elle s'est imposée comme une bibliothèque importante pour les développeurs qui se plongent dans les subtilités du rendu PDF au sein des applications C#, fournissant une réplication haute-fidélité du contenu PDF dans les environnements .NET.

Cependant, malgré ses prouesses en matière de rendu, les capacités de Pdfium.NET en matière de création et de manipulation de documents PDF sont limitées. Elle est principalement conçue pour les applications qui nécessitent l'affichage précis du contenu PDF, sans mettre l'accent sur la modification ou la création de nouveaux PDF.

Limites critiques de Pdfium

1. Rendering-Only Focus : Impossible de créer des PDF à partir de HTML, d'images ou par programmation. Les capacités de Pdfium sont limitées à l'affichage et au rendu des PDF.

2. Pas de manipulation de PDF : Il n'est pas possible de fusionner, de diviser ou de modifier le contenu d'un PDF. La fusion de PDF n'est pas prise en charge en mode natif - vous devrez utiliser une autre bibliothèque comme iTextSharp ou PdfSharp.

3. Dépendances binaires natives : Nécessite des binaires PDFium spécifiques à la plate-forme. Les développeurs doivent gérer les binaires PDFium natifs, un aspect qui ajoute de la complexité lors du déploiement et de la distribution.

4. Complexité du déploiement : Doit regrouper et gérer les DLL natives par plateforme avec des dossiers x86, x64 et runtimes.

5. Extraction de texte limitée : Extraction de texte de base sans formatage. L'extraction de texte nécessite un travail supplémentaire avec Pdfium.NET.

6. Pas de HTML vers PDF : Il n'est pas possible de convertir du contenu web en PDF. La conversion de HTML en PDF n'est pas prise en charge de manière native dans Pdfium.NET.

7. Pas d'en-têtes/pieds de page : Il n'est pas possible d'ajouter des numéros de page ou du contenu répétitif.

8. <Pas de filigrane : Il n'est pas possible d'apposer un cachet sur les documents à l'aide de superpositions.

9. Aucune prise en charge des formulaires : Impossible de remplir ou de lire des formulaires PDF.

10. Aucune fonction de sécurité : Il n'est pas possible de crypter ou de protéger les PDF par un mot de passe.

Comparaison IronPdf vs IronPDF

Pour les équipes qui prévoient l'adoption de .NET 10 et C# 14 d'ici 2025 et 2026,IronPDFconstitue une base entièrement gérée qui élimine la gestion des binaires natifs tout en ajoutant des fonctionnalités complètes de création et de manipulation de PDF.

Prérequis

1. Environnement .NET : .NET Framework 4.6.2+ ou .NET Core 3.1+ / .NET 5/6/7/8/9+
2. Accès NuGet : Capacité à installer des paquets NuGet
3. Licence IronPDF : Obtenez votre clé de licence sur ironpdf.com

Modifications du paquet NuGet

# Remove Pdfium packages
dotnet remove package Pdfium.NET
dotnet remove package Pdfium.Net.SDK
dotnet remove package PdfiumViewer

# Install IronPDF
dotnet add package IronPdf

# Remove Pdfium packages
dotnet remove package Pdfium.NET
dotnet remove package Pdfium.Net.SDK
dotnet remove package PdfiumViewer

# Install IronPDF
dotnet add package IronPdf

Configuration de la licence

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

Identifier l'utilisation de Pdfium

# Find Pdfium usage
grep -r "Pdfium\|PdfDocument\.Load\|\.Render\(" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|pdfium\.so\|pdfium\.dylib" --include="*.csproj" --include="*.config" .

# Find platform-specific code
grep -r "#if.*64\|WIN32\|WIN64\|LINUX\|OSX" --include="*.cs" .

# Find Pdfium usage
grep -r "Pdfium\|PdfDocument\.Load\|\.Render\(" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|pdfium\.so\|pdfium\.dylib" --include="*.csproj" --include="*.config" .

# Find platform-specific code
grep -r "#if.*64\|WIN32\|WIN64\|LINUX\|OSX" --include="*.cs" .

Modifications de l'espace de nommage

// Pdfium.NET
using Pdfium;
using Pdfium.Net;
using PdfiumViewer;

// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

// Pdfium.NET
using Pdfium;
using Pdfium.Net;
using PdfiumViewer;

// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Mappages de classes de base

Mappages de chargement de documents

Mappages de propriétés de documents

Mappages d'extraction de texte

Enregistrement des documents Mappings

Mappages de rendu de page

Nouvelles fonctionnalités non disponibles dans Pdfium

Exemple 1 : Extraction de texte à partir d'un PDF

Avant (Pdfium):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        using (var document = PdfDocument.Load(pdfPath))
        {
            StringBuilder text = new StringBuilder();

            for (int i = 0; i < document.PageCount; i++)
            {
                // Note: PdfiumViewer has limited text extraction capabilities
                // Text extraction requires additional work with Pdfium.NET
                string pageText = document.GetPdfText(i);
                text.AppendLine(pageText);
            }

            Console.WriteLine(text.ToString());
        }
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        using (var document = PdfDocument.Load(pdfPath))
        {
            StringBuilder text = new StringBuilder();

            for (int i = 0; i < document.PageCount; i++)
            {
                // Note: PdfiumViewer has limited text extraction capabilities
                // Text extraction requires additional work with Pdfium.NET
                string pageText = document.GetPdfText(i);
                text.AppendLine(pageText);
            }

            Console.WriteLine(text.ToString());
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        var pdf = PdfDocument.FromFile(pdfPath);
        string text = pdf.ExtractAllText();

        Console.WriteLine(text);
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        var pdf = PdfDocument.FromFile(pdfPath);
        string text = pdf.ExtractAllText();

        Console.WriteLine(text);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

La différence est ici significative. Pdfium nécessite une boucle manuelle à travers chaque page avec GetPdfText(pageIndex), la construction d'un StringBuilder et la gestion de la déclaration using pour une élimination appropriée. Le code indique que "PdfiumViewer a des capacités d'extraction de texte limitées" et que "l'extraction de texte nécessite un travail supplémentaire"

IronPDF simplifie cela en trois lignes : charger avec PdfDocument.FromFile(), extraire avec ExtractAllText(), et sortir. La méthode ExtractAllText() traite toutes les pages automatiquement avec des capacités d'extraction de texte plus avancées. Si vous avez besoin d'une extraction par page, vous pouvez utiliser pdf.Pages[index].Text. Voir la documentation sur l'extraction de texte pour des options supplémentaires.

Exemple 2 : fusion de fichiers PDF

Avant (Pdfium):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.IO;
using System.Collections.Generic;

// Note: PdfiumViewer does not have native PDF merging functionality
// You would need to use additional libraries or implement custom logic
class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        // PdfiumViewer is primarily for rendering/viewing
        // PDF merging is not natively supported
        // You would need to use another library like iTextSharp or PdfSharp

        Console.WriteLine("PDF merging not natively supported in PdfiumViewer");
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.IO;
using System.Collections.Generic;

// Note: PdfiumViewer does not have native PDF merging functionality
// You would need to use additional libraries or implement custom logic
class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        // PdfiumViewer is primarily for rendering/viewing
        // PDF merging is not natively supported
        // You would need to use another library like iTextSharp or PdfSharp

        Console.WriteLine("PDF merging not natively supported in PdfiumViewer");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        var pdf = PdfDocument.Merge(pdfFiles);
        pdf.SaveAs("merged.pdf");

        Console.WriteLine("PDFs merged successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        var pdf = PdfDocument.Merge(pdfFiles);
        pdf.SaveAs("merged.pdf");

        Console.WriteLine("PDFs merged successfully");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Cet exemple met en évidence une lacune fondamentale en matière de capacités. Pdfium ne peut pas fusionner des PDF - le code indique explicitement que "la fusion de PDF n'est pas prise en charge en mode natif dans PdfiumViewer" et que "vous devriez utiliser une autre bibliothèque comme iTextSharp ou PdfSharp"

IronPDF fournit une fusion native avec la méthode statique PdfDocument.Merge()qui accepte directement une liste de chemins de fichiers. Le résultat est un nouveau Document PDFque vous enregistrez avec SaveAs(). En savoir plus sur la fusion et la division de PDF.

Exemple 3 : Conversion HTML vers PDF

Avant (Pdfium):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System.IO;
using System.Drawing.Printing;

// Note: PdfiumViewer is primarily for viewing/rendering PDFs, not creating them from HTML
// For HTML to PDF with Pdfium.NET, you would need additional libraries
// This example shows a limitation of Pdfium.NET
class Program
{
    static void Main()
    {
        // Pdfium.NET does not have native HTML to PDF conversion
        // You would need to use a separate library to convert HTML to PDF
        // then use Pdfium for manipulation
        string htmlContent = "<h1>Hello World</h1>";

        // This functionality is not directly available in Pdfium.NET
        Console.WriteLine("HTML to PDF conversion not natively supported in Pdfium.NET");
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System.IO;
using System.Drawing.Printing;

// Note: PdfiumViewer is primarily for viewing/rendering PDFs, not creating them from HTML
// For HTML to PDF with Pdfium.NET, you would need additional libraries
// This example shows a limitation of Pdfium.NET
class Program
{
    static void Main()
    {
        // Pdfium.NET does not have native HTML to PDF conversion
        // You would need to use a separate library to convert HTML to PDF
        // then use Pdfium for manipulation
        string htmlContent = "<h1>Hello World</h1>";

        // This functionality is not directly available in Pdfium.NET
        Console.WriteLine("HTML to PDF conversion not natively supported in Pdfium.NET");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<h1>Hello World</h1>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<h1>Hello World</h1>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF created successfully");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Cet exemple illustre la différence de capacité la plus importante. Pdfium indique explicitement que "la conversion de HTML en PDF n'est pas prise en charge en mode natif dans Pdfium.NET" et que "vous devrez utiliser une bibliothèque distincte pour convertir HTML en PDF"

IronPDF fournit une conversion native de HTML en PDF grâce à ChromePdfRenderer, qui utilise un moteur Chromium en interne pour un rendu précis de HTML, CSS et JavaScript. La méthode RenderHtmlAsPdf() convertit les chaînes HTML directement en documents PDF.IronPDFpeut également rendre des URL avec RenderUrlAsPdf() et des fichiers HTML avec RenderHtmlFileAsPdf(). Consultez la documentation HTML vers PDF pour des exemples complets.

Avant (Pdfium) - Déploiement complexe

MyApp/
├── bin/
│ ├─── MyApp.dll
│ ├── Pdfium.NET.dll
│ ├── x86/
│ │ └── pdfium.dll
│ └── x64/
│ └── pdfium.dll
├── runtimes/
│ ├── win-x86/native/
│ │ └── pdfium.dll
│ └── win-x64/native/
│ └── pdfium.dll

Après (IronPDF) - Déploiement propre

MyApp/
├── bin/
│ ├─── MyApp.dll
│ └── IronPdf.dll # Everything included

Supprimer les références binaires natives

# Delete native PDFium binaries
rm -rf x86/ x64/ runtimes/

# Remove from .csproj
# Delete any <Content Include="pdfium.dll" /> entries
# Delete any <None Include="x86/pdfium.dll" /> entries

# Delete native PDFium binaries
rm -rf x86/ x64/ runtimes/

# Remove from .csproj
# Delete any <Content Include="pdfium.dll" /> entries
# Delete any <None Include="x86/pdfium.dll" /> entries

Conversion de l'échelle en DPI

Pdfium utilise des facteurs d'échelle ;IronPDFutilise le DPI :

// Formula:IronPDFDPI = 72 × Pdfium scale
// Pdfium scale 2.0 →IronPDFDPI 144
pdf.RasterizeToImageFiles("*.png", DPI: 144);

// Formula:IronPDFDPI = 72 × Pdfium scale
// Pdfium scale 2.0 →IronPDFDPI 144
pdf.RasterizeToImageFiles("*.png", DPI: 144);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Modification de la méthode de chargement des documents

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

IRON VB CONVERTER ERROR developers@ironsoftware.com

Enregistrer le changement de méthode

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

IRON VB CONVERTER ERROR developers@ironsoftware.com

Simplification du modèle d'élimination

// Pdfium: Les exigences sont les suivantesexplicit disposal
using (var document = PdfDocument.Load(path))
using (var page = document.Pages[0])
using (var bitmap = page.Render(1024, 768))
{
    bitmap.Save("output.png");
}

// IronPDF: Simplified
var pdf = PdfDocument.FromFile(path);
pdf.RasterizeToImageFiles("output.png");

// Pdfium: Les exigences sont les suivantesexplicit disposal
using (var document = PdfDocument.Load(path))
using (var page = document.Pages[0])
using (var bitmap = page.Render(1024, 768))
{
    bitmap.Save("output.png");
}

// IronPDF: Simplified
var pdf = PdfDocument.FromFile(path);
pdf.RasterizeToImageFiles("output.png");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Suppression du code spécifique à la plateforme

// Pdfium: Les exigences sont les suivantesplatform detection
#if WIN64
    // Load x64 pdfium.dll
#else
    // Load x86 pdfium.dll
#endif

// IronPDF: Remove all platform-specific code
// Just use the API directly

// Pdfium: Les exigences sont les suivantesplatform detection
#if WIN64
    // Load x64 pdfium.dll
#else
    // Load x86 pdfium.dll
#endif

// IronPDF: Remove all platform-specific code
// Just use the API directly

IRON VB CONVERTER ERROR developers@ironsoftware.com

Pré-migration

• [Identifier toutes les utilisations de Pdfium dans la base de code
• [Documenter les dimensions/échelles de rendu actuellement utilisées
• [Liste des emplacements binaires natifs dans le projet
• [Vérifier la présence d'un code de chargement spécifique à la plateforme
• [Identifier les besoins en matière de création de PDF (utilise-t-on actuellement des outils distincts ?)
• [ ] Examiner les modèles d'élimination en vue d'une conversion
• [Obtenir la clé de licence IronPDF

Modifications du paquet

• [ ] Supprimer les paquets NuGet Pdfium.NET, Pdfium.Net.SDK, PdfiumViewer
• [Supprimer les binaires natifs pdfium.dll des dossiers x86/, x64/, runtimes/
• [Supprimer la compilation conditionnelle spécifique à la plate-forme
• [Mise à jour de .csproj pour supprimer les références binaires natives
• [Installer le package NuGet IronPdf : dotnet add package IronPdf

Modifications du code

• [Ajouter la configuration de la clé de licence au démarrage
• [Remplacer PdfDocument.Load() par PdfDocument.FromFile()
• [Remplacer document.Save() par pdf.SaveAs()
• [Remplacer les boucles document.GetPdfText(i) par pdf.ExtractAllText()
• [Convertir les facteurs d'échelle en valeurs DPI (DPI = 72 × échelle)
• [Simplifier les modèles d'élimination (supprimer les instructions d'utilisation imbriquées)
• [Supprimer le code spécifique à la plateforme

Post-Migration

• [Tester la qualité du rendu
• [Comparer les résultats de l'extraction de texte
• [Tester le déploiement multiplateforme
• [Ajouter de nouvelles fonctionnalités (HTML vers PDF, fusion, filigranes, sécurité)
• [Mise à jour de la documentation