La migración de PdfiumViewera IronPDF traslada su flujo de trabajo PDF .NET de una biblioteca de visualización de Windows Forms con dependencias binarias nativas a una solución PDF completa que gestiona la creación, manipulación, extracción de texto y representación en todos los tipos de aplicaciones .NET. Esta guía proporciona una ruta de migración completa, paso a paso, que elimina las restricciones de plataforma a la vez que añade capacidades que PdfiumViewerno puede proporcionar.
PdfiumViewer es una envoltura .NET para PDFium, el motor de renderizado de PDF de Google utilizado en el navegador Chrome. Ofrece una solución sencilla pero potente para integrar la visualización de PDF directamente en las aplicaciones Windows Forms, proporcionando una capacidad de renderizado de PDF de alto rendimiento y alta fidelidad.
Sin embargo, es crucial recordar que PdfiumVieweres únicamente un visor. No es compatible con la creación, edición o manipulación de PDF, lo que puede suponer una limitación para las aplicaciones que exigen algo más que capacidades de visualización. Además, su incierto estado de mantenimiento crea un riesgo para las aplicaciones de producción: existe cierta incertidumbre sobre su desarrollo y mantenimiento continuos, lo que puede ser preocupante para proyectos a largo plazo.
Funcionalidad de solo visualización: no se pueden crear archivos PDF a partir de HTML, imágenes o mediante programación. Las capacidades de PdfiumViewerse limitan a la visualización de PDF; a diferencia de bibliotecas como IronPDF, no admite la creación, edición, fusión u otras funciones de manipulación de PDF.
Específico de Windows Forms: la biblioteca está centrada en aplicaciones de Windows Forms y no ofrece soporte para otros marcos de interfaz de usuario.
Sin manipulación de PDF: no se puede fusionar, dividir ni modificar el contenido del PDF.
Dependencias binarias nativas: requiere binarios PDFium específicos de la plataforma (archivos pdfium.dll x86 y x64).
Mantenimiento incierto: actualizaciones limitadas y soporte a largo plazo poco claro.
Sin extracción de texto: PdfiumViewerno tiene extracción de texto incorporada; necesitará utilizar OCR u otra biblioteca. Sólo puede renderizar páginas como imágenes.
No HTML a PDF: PdfiumVieweres principalmente un visor/renderizador de PDF, no un generador. No puede convertir directamente HTML a PDF. Sería necesario utilizar otra biblioteca como wkhtmltopdf o similar.
Sin encabezados/pies de página: no se pueden agregar números de página ni repetir contenido.
Sin marcas de agua: no se pueden estampar documentos con superposiciones.
Sin funciones de seguridad: no se pueden cifrar ni proteger con contraseña los archivos PDF.
| Aspecto | PdfiumViewer | IronPDF |
|---|---|---|
| Enfoque principal | Visor de PDF WinForms | Solución PDF completa |
| Licencia | Apache 2.0 | Comercial |
| Creación de PDF | ✗ | ✓(HTML, URL, imágenes) |
| Manipulación de PDF | ✗ | ✓(fusionar, dividir, editar) |
| HTML a PDF | ✗ | ✓(motor Chromium) |
| Extracción de texto | ✗ | ✓ |
| Marcas de agua | ✗ | ✓ |
| Cabeceras/Pies de página | ✗ | ✓ |
| Seguridad | ✗ | ✓ |
| Visor integrado | ✓ | ✗(centrado en el backend) |
| Soporte de Plataforma | Solo Windows Forms | Consola, Web, Escritorio |
| Soporte de Framework | .NET Framework | .NET Framework, Core, 5+ |
| Mantenimiento | Incierto | Activo |
Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDF proporciona una base completa y mantenida activamente que funciona en todos los tipos de aplicaciones .NET, eliminando la restricción de Windows Forms y la complejidad binaria nativa.
# 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// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"# 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" .// PdfiumViewer
using PdfiumViewer;
// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;Imports PdfiumViewer
Imports IronPdf
Imports IronPdf.Rendering
Imports IronPdf.Editing| PdfiumViewer | IronPDF |
|---|---|
PdfDocument | PdfDocument |
PdfViewer | (sin equivalente) |
PdfRenderer | ChromePdfRenderer |
| (no disponible) | HtmlHeaderFooter |
| PdfiumViewer | IronPDF |
|---|---|
PdfDocument.Load(path) | PdfDocument.FromFile(path) |
PdfDocument.Load(stream) | PdfDocument.FromStream(stream) |
PdfDocument.Load(bytes) | PdfDocument.FromBinaryData(bytes) |
| PdfiumViewer | IronPDF |
|---|---|
document.PageCount | document.PageCount |
document.PageSizes | document.Pages[i].Width/Height |
document.GetPageSize(index) | document.Pages[index].Width/Height |
| PdfiumViewer | IronPDF |
|---|---|
document.Render(pageIndex, dpiX, dpiY, forPrinting) | pdf.ToBitmap(pageIndex) |
document.Render(pageIndex, width, height, dpiX, dpiY, flags) | pdf.RasterizeToImageFiles(path, dpi) |
| PdfiumViewer | IronPDF |
|---|---|
document.Save(path) | pdf.SaveAs(path) |
document.Save(stream) | pdf.Stream |
| (no disponible) | pdf.BinaryData |
| Características de IronPDF | Descripción |
|---|---|
pdf.ExtractAllText() | Extraer texto de todas las páginas |
pdf.ExtractTextFromPage(index) | Extraer texto de una página específica |
ChromePdfRenderer.RenderHtmlAsPdf() | Crear a partir de HTML |
ChromePdfRenderer.RenderUrlAsPdf() | Crear a partir de URL |
PdfDocument.Merge() | Combinar PDF |
pdf.CopyPages() | Extraer páginas |
pdf.RemovePages() | Eliminar páginas |
pdf.ApplyWatermark() | Añadir marcas de agua |
pdf.AddHtmlHeaders() | Añadir encabezados |
pdf.AddHtmlFooters() | Añadir pies de página |
pdf.SecuritySettings | Protección mediante contraseña |
pdf.Form | Relleno de formularios |
Antes (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
Imports PdfiumViewer
Imports System
Dim pdfPath As String = "document.pdf"
' PDFiumViewer has limited text extraction capabilities
' It's primarily designed for rendering, not text extraction
Using document = PdfDocument.Load(pdfPath)
Dim pageCount As Integer = 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 i As Integer = 0 To pageCount - 1
Dim pageImage = document.Render(i, 96, 96, False)
Console.WriteLine($"Rendered page {i + 1}")
Next
End UsingDespué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}");Imports IronPdf
Imports System
Module Program
Sub Main()
Dim pdfPath As String = "document.pdf"
' Open and extract text from PDF
Dim pdf As PdfDocument = PdfDocument.FromFile(pdfPath)
' Extract text from all pages
Dim allText As String = pdf.ExtractAllText()
Console.WriteLine("Extracted Text:")
Console.WriteLine(allText)
' Extract text from specific page
Dim pageText As String = pdf.ExtractTextFromPage(0)
Console.WriteLine(vbCrLf & "First page text: " & pageText)
Console.WriteLine(vbCrLf & "Total pages: " & pdf.PageCount)
End Sub
End ModuleEste ejemplo pone de manifiesto una carencia fundamental. PdfiumViewerafirma explícitamente que "no tiene extracción de texto incorporada" y que "sería necesario utilizar OCR u otra biblioteca". Si necesitas texto de un PDF con PdfiumViewer, te ves obligado a convertirlo en una imagen y ejecutar el OCR.
IronPDF proporciona extracción de texto nativa con ExtractAllText() para todo el documento o ExtractTextFromPage(index) para páginas específicas. Sin OCR ni soluciones alternativas: extracción directa del texto a partir del contenido del PDF. Consulte la documentación de extracción de texto para obtener opciones adicionales.
Antes (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);
}Imports PdfiumViewer
Imports System.IO
Imports 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:
Dim htmlContent As String = "<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:
Dim existingPdfPath As String = "output.pdf"
Using document = PdfDocument.Load(existingPdfPath)
' Can only render/display existing PDF
Dim image = document.Render(0, 300, 300, True)
End UsingDespué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!");Imports IronPdf
Imports System
Module Program
Sub Main()
Dim htmlContent As String = "<h1>Hello World</h1><p>This is a test document.</p>"
' Create a PDF from HTML string
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
' Save the PDF
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF created successfully!")
End Sub
End ModuleEste ejemplo muestra la diferencia más significativa entre las capacidades de las dos bibliotecas. PdfiumViewerafirma explícitamente "Esta funcionalidad NO está disponible en PDFiumViewer" y "Necesitarías una biblioteca diferente como wkhtmltopdf o similar"-PdfiumViewer sólo puede abrir y mostrar PDFs existentes.
IronPDF proporciona conversión nativa de HTML a PDF a través de ChromePdfRenderer, que utiliza un motor Chromium internamente para una representación precisa de HTML, CSS y JavaScript. El método RenderHtmlAsPdf() convierte cadenas HTML directamente en documentos PDF.IronPDF también puede renderizar URL con RenderUrlAsPdf() y archivos HTML con RenderHtmlFileAsPdf(). Consulte la documentación HTML a PDF para ver ejemplos completos.
Antes (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
Imports PdfiumViewer
Imports System
Imports System.Drawing
Imports System.Drawing.Imaging
Dim pdfPath As String = "document.pdf"
Dim outputImage As String = "page1.png"
' PDFiumViewer excels at rendering PDFs to images
Using document As PdfDocument = PdfDocument.Load(pdfPath)
' Render first page at 300 DPI
Dim dpi As Integer = 300
Using image As Image = document.Render(0, dpi, dpi, True)
' Save as PNG
image.Save(outputImage, ImageFormat.Png)
Console.WriteLine($"Page rendered to {outputImage}")
End Using
' Render all pages
For i As Integer = 0 To document.PageCount - 1
Using pageImage As Image = document.Render(i, 150, 150, True)
pageImage.Save($"page_{i + 1}.png", ImageFormat.Png)
End Using
Next
End UsingDespué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}");Imports IronPdf
Imports System
Imports System.Linq
Module Module1
Sub Main()
Dim pdfPath As String = "document.pdf"
Dim outputImage As String = "page1.png"
' Open PDF and convert to images
Dim pdf As PdfDocument = PdfDocument.FromFile(pdfPath)
' Convert first page to image
Dim firstPageImage = pdf.ToBitmap(0)
firstPageImage(0).Save(outputImage)
Console.WriteLine($"Page rendered to {outputImage}")
' Convert all pages to images
Dim allPageImages = pdf.ToBitmap()
For i As Integer = 0 To allPageImages.Length - 1
allPageImages(i).Save($"page_{i + 1}.png")
Console.WriteLine($"Saved page {i + 1}")
Next
Console.WriteLine($"Total pages converted: {pdf.PageCount}")
End Sub
End ModuleEsta es un área en la que PdfiumViewerdestaca: el renderizado de PDF a imágenes es su punto fuerte. Ambas bibliotecas se encargan de esta tarea con eficacia, pero con patrones diferentes.
PdfiumViewer utiliza document.Render(pageIndex, dpiX, dpiY, forPrinting) con declaraciones using anidadas para una eliminación adecuada. Debe importar System.Drawing y System.Drawing.Imaging para la enumeración ImageFormat.
IronPDF utiliza pdf.ToBitmap(pageIndex) que devuelve una matriz de mapa de bits. El patrón es más sencillo, sin requisitos de disposición anidados. Para operaciones por lotes, ToBitmap() sin parámetros devuelve todas las páginas. También puede utilizar RasterizeToImageFiles() para la salida directa de archivos. Consulte Documentación de PDF a imagen para obtener más opciones de conversión.
Una de las ventajas significativas de migrar de PdfiumViewera IronPDFes la eliminación de la gestión nativa de binarios.
MyApp/
├── papelera/
│├── MyApp.dll
│├── PdfiumViewer.dll
│ ├── x86/
││└── pdfium.dll
│ └── x64/
│ └── pdfium.dllMyApp/
├── papelera/
│├── MyApp.dll
│ └── IronPDF.dll # Todo incluido# 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" />IronPDF se centra en el backend y no incluye un control visual del visor de 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) With {.UseShellExecute = True})Para necesidades de visualización, considere usar Process.Start() para abrir en el visor de PDF predeterminado, un control WebBrowser con la ruta PDF o controles de visor de terceros como Syncfusion, DevExpress o Telerik.
// PdfiumViewer
PdfDocument.Load(path)
// IronPDF
PdfDocument.FromFile(path)' PdfiumViewer
PdfDocument.Load(path)
' IronPDF
PdfDocument.FromFile(path)// PdfiumViewer
document.Save(path)
// IronPDF
pdf.SaveAs(path)net// 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");Imports System.Drawing.Imaging
' PdfiumViewer: Returns image with nested using
Using image = document.Render(0, 150, 150, True)
image.Save("page.png", ImageFormat.Png)
End Using
' IronPDF: Returns bitmap array
Dim images = pdf.ToBitmap(0)
images(0).Save("page.png")// 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
Dim size = document.PageSizes(index)
Console.WriteLine($"{size.Width} x {size.Height}")
' IronPDF
Dim page = pdf.Pages(index)
Console.WriteLine($"{page.Width} x {page.Height}")| Característica | PdfiumViewer | IronPDF |
|---|---|---|
| Cargar PDF | ✓ | ✓ |
| Renderizado a imagen | ✓ | ✓ |
| Visor incorporado | ✓ | ✗ |
| Imprimir PDF | ✓ | ✓ |
| Extraer texto | ✗ | ✓ |
| Crear a partir de HTML | ✗ | ✓ |
| Crear a partir de URL | ✗ | ✓ |
| Fusionar PDF | ✗ | ✓ |
| Dividir PDF | ✗ | ✓ |
| Añadir marcas de agua | ✗ | ✓ |
| Encabezados/pies de página | ✗ | ✓ |
| Relleno de formularios | ✗ | ✓ |
| Protección por contraseña | ✗ | ✓ |
| Compatibilidad con WinForms | ✓ | ✓ |
| Soporte ASP.NET | ✗ | ✓ |
| compatibilidad con .NET Core | Limitado | ✓ |
| Mantenimiento activo | Incierto | ✓ |
PdfiumViewerPdfiumViewer.Native.x86.v8-xfaPdfiumViewer.Native.x64.v8-xfaIronPdf el paquete NuGet : dotnet add package IronPdfPdfDocument.Load() con PdfDocument.FromFile()document.Save() con pdf.SaveAs()document.Render() con pdf.ToBitmap() o RasterizeToImageFiles()document.PageSizes[i] con pdf.Pages[i].Width/Height
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
