Comprendre PdfiumViewer

PdfiumViewer est un wrapper .NET pour PDFium, le moteur de rendu PDF de Google utilisé dans le navigateur Chrome. Il s'agit d'une solution simple mais efficace pour intégrer l'affichage des PDF directement dans les applications Windows Forms, offrant une capacité de rendu PDF haute performance et haute fidélité.

Toutefois, il est essentiel de se rappeler que PdfiumViewerest uniquement une visionneuse. Elle ne prend pas en charge la création, l'édition ou la manipulation de fichiers PDF, ce qui peut s'avérer contraignant pour les applications qui exigent plus que de simples capacités de visualisation. En outre, son statut de maintenance incertain crée un risque pour les applications de production - il y a une certaine incertitude quant à son développement et sa maintenance continus, ce qui peut être une préoccupation pour les projets à long terme.

Limitations critiques de PdfiumViewer

1. Fonctionnalité de visualisation uniquement : Il n'est pas possible de créer des PDF à partir de HTML, d'images ou par programmation. Les capacités de PdfiumViewersont limitées à la visualisation des PDF - contrairement aux bibliothèques telles qu'IronPdf, il ne prend pas en charge la création, l'édition, la fusion ou d'autres fonctions de manipulation des PDF.

2. <Spécifique à Windows Forms : la bibliothèque est axée sur les applications Windows Forms et ne prend pas en charge d'autres cadres d'interface utilisateur.

3. Pas de manipulation de PDF : Il n'est pas possible de fusionner, de diviser ou de modifier le contenu d'un PDF.

4. Dépendances binaires natives : Nécessite des binaires PDFium spécifiques à la plateforme (fichiers pdfium.dll x86 et x64).

5. Maintenance incertaine : Mises à jour limitées et assistance à long terme incertaine.

6. Pas d'extraction de texte : PdfiumViewerne dispose pas d'une fonction d'extraction de texte intégrée. Vous devez utiliser la reconnaissance optique de caractères (OCR) ou une autre bibliothèque. Il ne peut restituer les pages que sous forme d'images.

7. Pas de HTML vers PDF : PdfiumViewerest avant tout un visualiseur/rendeur de PDF, et non un générateur. Il n'est pas possible de convertir directement du HTML en PDF. Vous devrez utiliser une autre bibliothèque comme wkhtmltopdf ou similaire.

8. 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.

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

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 PdfiumViewervs IronPDF

Pour les équipes qui prévoient l'adoption de .NET 10 et C# 14 jusqu'en 2025 et 2026,IronPDFconstitue une base complète et activement entretenue qui fonctionne pour tous les types d'applications .NET, en éliminant la restriction Windows Forms et la complexité des binaires natifs.

Prérequis

1. Environnement .NET : .NET Framework4.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 PdfiumViewerpackages
dotnet remove package PdfiumViewer
dotnet remove package PdfiumViewer.Native.x86.v8-xfa
dotnet remove package PdfiumViewer.Native.x64.v8-xfa

# Install IronPDF
dotnet add package IronPdf

# Remove PdfiumViewerpackages
dotnet remove package PdfiumViewer
dotnet remove package PdfiumViewer.Native.x86.v8-xfa
dotnet remove package PdfiumViewer.Native.x64.v8-xfa

# 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 PdfiumViewer

# Find PdfiumViewerusage
grep -r "PdfiumViewer\|PdfViewer\|PdfDocument\.Load" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|Native\.x86\|Native\.x64" --include="*.csproj" .

# Find viewer control usage
grep -r "PdfViewer" --include="*.cs" --include="*.Designer.cs" .

# Find PdfiumViewerusage
grep -r "PdfiumViewer\|PdfViewer\|PdfDocument\.Load" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|Native\.x86\|Native\.x64" --include="*.csproj" .

# Find viewer control usage
grep -r "PdfViewer" --include="*.cs" --include="*.Designer.cs" .

Modifications de l'espace de nommage

// PdfiumViewer
using PdfiumViewer;

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

// PdfiumViewer
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 de rendu de page

Enregistrement des documents Mappings

Nouvelles fonctionnalités non disponibles dans PdfiumViewer

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

Avant (PdfiumViewer):

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

string pdfPath = "document.pdf";

// PDFiumViewer has limited text extraction capabilities
// It's primarily designed for rendering, not text extraction
using (var document = PdfDocument.Load(pdfPath))
{
    int pageCount = document.PageCount;
    Console.WriteLine($"Total pages: {pageCount}");

    // PDFiumViewer does not have built-in text extraction
    // You would need to use OCR or another library
    // It can only render pages as images
    for (int i = 0; i < pageCount; i++)
    {
        var pageImage = document.Render(i, 96, 96, false);
        Console.WriteLine($"Rendered page {i + 1}");
    }
}

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

string pdfPath = "document.pdf";

// PDFiumViewer has limited text extraction capabilities
// It's primarily designed for rendering, not text extraction
using (var document = PdfDocument.Load(pdfPath))
{
    int pageCount = document.PageCount;
    Console.WriteLine($"Total pages: {pageCount}");

    // PDFiumViewer does not have built-in text extraction
    // You would need to use OCR or another library
    // It can only render pages as images
    for (int i = 0; i < pageCount; i++)
    {
        var pageImage = document.Render(i, 96, 96, false);
        Console.WriteLine($"Rendered page {i + 1}");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

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

string pdfPath = "document.pdf";

// Open and extract text from PDF
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Extract text from all pages
string allText = pdf.ExtractAllText();
Console.WriteLine("Extracted Text:");
Console.WriteLine(allText);

// Extract text from specific page
string pageText = pdf.ExtractTextFromPage(0);
Console.WriteLine($"\nFirst page text: {pageText}");

Console.WriteLine($"\nTotal pages: {pdf.PageCount}");

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

string pdfPath = "document.pdf";

// Open and extract text from PDF
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Extract text from all pages
string allText = pdf.ExtractAllText();
Console.WriteLine("Extracted Text:");
Console.WriteLine(allText);

// Extract text from specific page
string pageText = pdf.ExtractTextFromPage(0);
Console.WriteLine($"\nFirst page text: {pageText}");

Console.WriteLine($"\nTotal pages: {pdf.PageCount}");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Cet exemple met en évidence une lacune fondamentale en matière de capacités. PdfiumViewerindique explicitement qu'il "n'a pas d'extraction de texte intégrée" et que "vous devriez utiliser l'OCR ou une autre bibliothèque" - il ne peut rendre les pages que sous forme d'images. Si vous avez besoin de texte à partir d'un PDF avec PdfiumViewer, vous êtes obligé d'effectuer un rendu sous forme d'image et d'exécuter l'OCR.

IronPDF fournit une extraction de texte native avec ExtractAllText() pour l'ensemble du document ou ExtractTextFromPage(index) pour des pages spécifiques. Pas d'OCR, pas de solutions de contournement - extraction directe du texte à partir du contenu du PDF. Voir la documentation sur l'extraction de texte pour des options supplémentaires.

Exemple 2 : Conversion de HTML en PDF

Avant (PdfiumViewer):

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

// PDFiumViewer is primarily a PDF viewer/renderer, not a generator
// It cannot directly convert HTML to PDF
// You would need to use another library to first create the PDF
// Then use PDFiumViewer to display it:

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// This functionality is NOT available in PDFiumViewer
// You would need a different library like wkhtmltopdf or similar
// PDFiumViewer can only open and display existing PDFs:

string existingPdfPath = "output.pdf";
using (var document = PdfDocument.Load(existingPdfPath))
{
    // Can only render/display existing PDF
    var image = document.Render(0, 300, 300, true);
}

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

// PDFiumViewer is primarily a PDF viewer/renderer, not a generator
// It cannot directly convert HTML to PDF
// You would need to use another library to first create the PDF
// Then use PDFiumViewer to display it:

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// This functionality is NOT available in PDFiumViewer
// You would need a different library like wkhtmltopdf or similar
// PDFiumViewer can only open and display existing PDFs:

string existingPdfPath = "output.pdf";
using (var document = PdfDocument.Load(existingPdfPath))
{
    // Can only render/display existing PDF
    var image = document.Render(0, 300, 300, true);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

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

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// Create a PDF from HTML string
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the PDF
pdf.SaveAs("output.pdf");

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

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

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// Create a PDF from HTML string
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the PDF
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 entre les deux bibliothèques. PdfiumViewerindique explicitement "Cette fonctionnalité n'est PAS disponible dans PDFiumViewer" et "Vous auriez besoin d'une bibliothèque différente comme wkhtmltopdf ou similaire"- PdfiumViewerne peut qu'ouvrir et afficher des PDF existants.

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.

Exemple 3 : Conversion de PDF en images

Avant (PdfiumViewer):

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

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// PDFiumViewer excels at rendering PDFs to images
using (var document = PdfDocument.Load(pdfPath))
{
    // Render first page at 300 DPI
    int dpi = 300;
    using (var image = document.Render(0, dpi, dpi, true))
    {
        // Save as PNG
        image.Save(outputImage, ImageFormat.Png);
        Console.WriteLine($"Page rendered to {outputImage}");
    }

    // Render all pages
    for (int i = 0; i < document.PageCount; i++)
    {
        using (var pageImage = document.Render(i, 150, 150, true))
        {
            pageImage.Save($"page_{i + 1}.png", ImageFormat.Png);
        }
    }
}

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

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// PDFiumViewer excels at rendering PDFs to images
using (var document = PdfDocument.Load(pdfPath))
{
    // Render first page at 300 DPI
    int dpi = 300;
    using (var image = document.Render(0, dpi, dpi, true))
    {
        // Save as PNG
        image.Save(outputImage, ImageFormat.Png);
        Console.WriteLine($"Page rendered to {outputImage}");
    }

    // Render all pages
    for (int i = 0; i < document.PageCount; i++)
    {
        using (var pageImage = document.Render(i, 150, 150, true))
        {
            pageImage.Save($"page_{i + 1}.png", ImageFormat.Png);
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

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

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// Open PDF and convert to images
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Convert first page to image
var firstPageImage = pdf.ToBitmap(0);
firstPageImage[0].Save(outputImage);
Console.WriteLine($"Page rendered to {outputImage}");

// Convert all pages to images
var allPageImages = pdf.ToBitmap();
for (int i = 0; i < allPageImages.Length; i++)
{
    allPageImages[i].Save($"page_{i + 1}.png");
    Console.WriteLine($"Saved page {i + 1}");
}

Console.WriteLine($"Total pages converted: {pdf.PageCount}");

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

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// Open PDF and convert to images
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Convert first page to image
var firstPageImage = pdf.ToBitmap(0);
firstPageImage[0].Save(outputImage);
Console.WriteLine($"Page rendered to {outputImage}");

// Convert all pages to images
var allPageImages = pdf.ToBitmap();
for (int i = 0; i < allPageImages.Length; i++)
{
    allPageImages[i].Save($"page_{i + 1}.png");
    Console.WriteLine($"Saved page {i + 1}");
}

Console.WriteLine($"Total pages converted: {pdf.PageCount}");

IRON VB CONVERTER ERROR developers@ironsoftware.com

C'est un domaine dans lequel PdfiumViewerexcelle - le rendu des PDF en images est sa principale force. Les deux bibliothèques s'acquittent efficacement de cette tâche, mais selon des schémas différents.

PdfiumViewer utilise document.Render(pageIndex, dpiX, dpiY, forPrinting)avec des déclarations imbriquées using pour une élimination appropriée. Vous devez importer System.Drawing et System.Drawing.Imaging pour l'enum ImageFormat.

IronPDF utilise pdf.ToBitmap(pageIndex)qui renvoie un tableau de bitmaps. Le modèle est plus simple, sans exigences d'élimination imbriquées. Pour les opérations par lots, ToBitmap() sans paramètres renvoie toutes les pages. Vous pouvez également utiliser RasterizeToImageFiles() pour une sortie de fichier directe. Voir la documentation sur le passage du PDF à l'image pour des options de rendu supplémentaires.

Avant (PdfiumViewer) - Déploiement complexe

MyApp/
├── bin/
│ ├─── MyApp.dll
│ ├── PdfiumViewer.dll
│ ├── x86/
│ │ └── pdfium.dll
│ └── x64/
│ └── 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 native package references
# <PackageReference Include="PdfiumViewer.Native.x86.v8-xfa" />
# <PackageReference Include="PdfiumViewer.Native.x64.v8-xfa" />

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

# Remove from .csproj native package references
# <PackageReference Include="PdfiumViewer.Native.x86.v8-xfa" />
# <PackageReference Include="PdfiumViewer.Native.x64.v8-xfa" />

Aucune commande de visualisation intégrée

IronPDF est axé sur le backend et n'inclut pas de contrôle visuel de visualisation des PDF :

// PdfiumViewer: Built-in viewer control
pdfViewer.Document = document;

// IronPDF: Use external viewer or web-based approach
pdf.SaveAs(tempPath);
Process.Start(new ProcessStartInfo(tempPath) { UseShellExecute = true });

// PdfiumViewer: Built-in viewer control
pdfViewer.Document = document;

// IronPDF: Use external viewer or web-based approach
pdf.SaveAs(tempPath);
Process.Start(new ProcessStartInfo(tempPath) { UseShellExecute = true });

IRON VB CONVERTER ERROR developers@ironsoftware.com

Pour les besoins de visualisation, envisagez d'utiliser Process.Start() pour ouvrir dans la visionneuse PDF par défaut, un contrôle WebBrowser avec le chemin PDF, ou des contrôles de visionneuse tiers tels que Syncfusion, DevExpress, ou Telerik.

Modification de la méthode de chargement des documents

// PdfiumViewer
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

// PdfiumViewer
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

IRON VB CONVERTER ERROR developers@ironsoftware.com

Enregistrer le changement de méthode

// PdfiumViewer
document.Save(path)

// IronPDF
pdf.SaveAs(path)

// PdfiumViewer
document.Save(path)

// IronPDF
pdf.SaveAs(path)

IRON VB CONVERTER ERROR developers@ironsoftware.com

Modification de la méthode de rendu

// PdfiumViewer: Returns image with nested using
using (var image = document.Render(0, 150, 150, true))
{
    image.Save("page.png", ImageFormat.Png);
}

// IronPDF: Returns bitmap array
var images = pdf.ToBitmap(0);
images[0].Save("page.png");

// PdfiumViewer: Returns image with nested using
using (var image = document.Render(0, 150, 150, true))
{
    image.Save("page.png", ImageFormat.Png);
}

// IronPDF: Returns bitmap array
var images = pdf.ToBitmap(0);
images[0].Save("page.png");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Modification de la taille de la page

// PdfiumViewer
var size = document.PageSizes[index];
Console.WriteLine($"{size.Width} x {size.Height}");

// IronPDF
var page = pdf.Pages[index];
Console.WriteLine($"{page.Width} x {page.Height}");

// PdfiumViewer
var size = document.PageSizes[index];
Console.WriteLine($"{size.Width} x {size.Height}");

// IronPDF
var page = pdf.Pages[index];
Console.WriteLine($"{page.Width} x {page.Height}");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Pré-migration

• [Identifier toutes les utilisations de PdfiumViewerdans la base de code
• [Liste WinForms à l'aide du contrôle PdfViewer
• [Documenter les paramètres DPI de rendu actuels
• [Vérifier les références binaires natives
• [Identifier l'utilisation des fonctionnalités d'impression
• [ ] Planifier une stratégie de remplacement du contrôle des téléspectateurs
• [Obtenir la clé de licence IronPDF

Modifications du paquet

• supprimer le paquet NuGet PdfiumViewer [ ]
• [Supprimer le paquet PdfiumViewer.Native.x86.v8-xfa
• [Supprimer le paquet PdfiumViewer.Native.x64.v8-xfa
• [Supprimer les binaires natifs pdfium.dll des dossiers x86/ et x64/
• [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 document.Render() par pdf.ToBitmap() ou RasterizeToImageFiles()
• [Remplacer document.PageSizes[i] par pdf.Pages[i].Width/Height
• [Remplacer le contrôle PdfViewer par un viewer externe ou Process.Start()
• [Ajouter de nouvelles fonctionnalités (extraction de texte, HTML vers PDF, etc.)

Post-Migration

• [Tester la qualité du rendu
• [Tester la fonctionnalité de l'impression
• [Test sur les plateformes cibles
• [Ajouter de nouvelles fonctionnalités (HTML vers PDF, fusion, filigranes, sécurité)
• [Mise à jour de la documentation