Entender Pdfium.NET

Pdfium.NET es un envoltorio .NET para la biblioteca PDFium de Google, famosa por su eficacia y velocidad en la representación de documentos PDF. Se ha convertido en una importante biblioteca para los desarrolladores que se adentran en los entresijos de la representación de PDF en aplicaciones C#, ya que proporciona una reproducción de alta fidelidad del contenido PDF en entornos .NET.

Sin embargo, a pesar de su destreza en el renderizado, las capacidades de Pdfium.NET para crear y manipular documentos PDF son limitadas. Se ha creado principalmente para aplicaciones que requieren mostrar contenido PDF con precisión, con menos énfasis en la modificación o creación de nuevos PDF.

Limitaciones críticas de Pdfium

1. Enfoque sólo en renderización: No se pueden crear PDF a partir de HTML, imágenes o mediante programación. Las capacidades de Pdfium se limitan a la visualización y representación de archivos PDF.

2. Sin manipulación de PDF: No se puede fusionar, dividir ni modificar el contenido de los PDF. La fusión de PDF no se admite de forma nativa, por lo que será necesario utilizar otra biblioteca como iTextSharp o PdfSharp.

3. Dependencias binarias nativas: Requiere binarios PDFium específicos de la plataforma. Los desarrolladores necesitan gestionar binarios PDFium nativos, un aspecto que añade complejidad durante el despliegue y la distribución.

4. Complejidad de despliegue: Debe agrupar y gestionar DLL nativas por plataforma con carpetas x86, x64 y tiempos de ejecución.

5. Extracción de texto limitada: extracción básica de texto sin formato. La extracción de texto requiere trabajo adicional con Pdfium.NET.

6. No HTML a PDF: No se puede convertir contenido web a PDF. La conversión de HTML a PDF no se admite de forma nativa en Pdfium.NET.

7. Sin encabezados/pies de página: No se pueden añadir números de página ni repetir contenidos.

8. Sin marcas de agua: No se pueden estampar documentos con superposiciones.

9. Sin soporte de formularios: No puede rellenar ni leer formularios PDF.

10. Sin funciones de seguridad: No puede cifrar ni proteger con contraseña los PDF.

Comparación entre Pdfium e IronPDF

Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDFproporciona una base totalmente gestionada que elimina la gestión binaria nativa a la vez que añade funciones completas de creación y manipulación de PDF.

Prerrequisitos

1. <Entorno .NET: .NET Framework 4.6.2+ o .NET Core 3.1+ / .NET 5/6/7/8/9+
2. Acceso a NuGet: Capacidad para instalar paquetes NuGet
3. Licencia IronPDF: Obtenga su clave de licencia en ironpdf.com

Cambios en el paquete NuGet

Cambios en el espacio de nombres

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

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

Core Class Mappings

Mapas de carga de documentos

Mapeo de propiedades de documentos

Mapas de extracción de texto

Guardar asignaciones de documentos

Mapas de renderizado de páginas

Nuevas funciones no disponibles en Pdfium

Ejemplo 1: Extracción de texto de un PDF

Antes (Pdfium):

using IronPdf;csharp // 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());
    }
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // 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);
}

} using IronPdf;

La diferencia aquí es significativa. Pdfium requiere un bucle manual a través de cada página con GetPdfText(pageIndex), construyendo un StringBuilder y gestionando la sentencia using para su correcta eliminación. El código señala que "PdfiumViewer tiene capacidades limitadas de extracción de texto" y "la extracción de texto requiere trabajo adicional."

IronPDF simplifica este proceso a tres líneas: carga con PdfDocument.FromFile(), extracción con ExtractAllText() y salida. El método ExtractAllText() maneja todas las páginas automáticamente con capacidades de extracción de texto más avanzadas. Si necesita una extracción por página, puede utilizar pdf.Pages[index].Text. Consulte la documentación de extracción de texto para obtener más opciones.

Ejemplo 2: Fusión de PDF

Antes (Pdfium):

using IronPdf;csharp // 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() { ListpdfFiles = new List{ "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");
}

} using IronPdf;

Después (IronPDF):

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

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

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

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

} using IronPdf;

Este ejemplo pone de manifiesto una carencia fundamental. Pdfium no puede combinar PDF: el código indica explícitamente que "PdfiumViewer no admite de forma nativa la combinación de PDF" y que "tendría que utilizar otra biblioteca como iTextSharp o PdfSharp"

IronPDF proporciona fusión nativa con el método estático PdfDocument.Merge()que acepta directamente una lista de rutas de archivos. El resultado es un nuevo Documento PDFque se guarda con SaveAs(). Más información sobre mezclar y dividir archivos PDF.

Ejemplo 3: Conversión de HTML a PDF

Antes (Pdfium):

using IronPdf;csharp // 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 = "

Hello World

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

} using IronPdf;

Después (IronPDF):

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

class Program { static void Main() { var renderer = new ChromePdfRenderer(); string htmlContent = "

Hello World

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

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

} using IronPdf;

Este ejemplo muestra la diferencia de capacidad más significativa. Pdfium indica explícitamente "La conversión de HTML a PDF no se admite de forma nativa en Pdfium.NET" y "Tendrías que utilizar una biblioteca independiente para convertir HTML a PDF."

IronPDF ofrece conversión nativa de HTML a PDF a través de ChromePdfRenderer, que utiliza internamente un motor Chromium para una renderización precisa de HTML, CSS y JavaScript. El método RenderHtmlAsPdf() convierte cadenas HTML directamente en documentos PDF.IronPDFtambién puede renderizar URLs con RenderUrlAsPdf() y archivos HTML con RenderHtmlFileAsPdf(). Consulte la documentación HTML a PDF para ver ejemplos completos.

Antes (Pdfium) - Despliegue complejo

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

Después (IronPDF) - Implementación limpia

using IronPdf; MyApp/ ├── bin/ │├── MyApp.dll │ └── IronPDF.dll # Todo incluido using IronPdf;

Eliminar referencias binarias nativas

Conversión de escala a PPP

Pdfium utiliza factores de escala;IronPDFutiliza DPI:

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

Cambio de método de carga de documentos

using IronPdf;csharp // Pdfium PdfDocument.Load(path)

// IronPDF PdfDocument.FromFile(path) using IronPdf;

Cambio de método de guardado

using IronPdf;csharp // Pdfium document.Save(path)

// IronPDF pdf.SaveAs(path) using IronPdf;

Simplificación del patrón de eliminación

using IronPdf;csharp // Pdfium: Requeridoexplicit 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"); using IronPdf;

Eliminación de código específico de la plataforma

Pre-Migración

• [ ] Identificar todos los usos de Pdfium en el código base
• [ ] Documentar las dimensiones/escalas de renderizado utilizadas actualmente
• [ ] Lista de ubicaciones binarias nativas en el proyecto
• [ ] Comprobación del código de carga específico de la plataforma
• [ ] Identificar las necesidades de creación de PDF (¿utiliza actualmente herramientas distintas?)
• [ ] Revisar los patrones de eliminación para la conversión
• [ ] Obtener la clave de licencia de IronPDF

Cambios en el paquete

• [ ] Eliminar Pdfium.NET, Pdfium.Net.SDK, PdfiumViewer paquetes NuGet
• [ ] Eliminar binarios nativos pdfium.dll de carpetas x86/, x64/, runtimes/
• [ ] Eliminar la compilación condicional específica de la plataforma
• [ ] Actualizar .csproj para eliminar referencias binarias nativas
• [Instale el paquete NuGet IronPdf: dotnet add package IronPdf

Cambios de código

• [ ] Añadir configuración de clave de licencia al inicio
• [Reemplace PdfDocument.Load() por PdfDocument.FromFile()
• [Reemplace document.Save() por pdf.SaveAs()
• [Reemplace los bucles document.GetPdfText(i) por pdf.ExtractAllText()
• [ ] Convertir factores de escala a valores de PPP (PPP = 72 × escala)
• [ ] Simplificar los patrones de eliminación (eliminar las sentencias using anidadas)
• [ ] Eliminar código específico de la plataforma

Posmigración

• [ ] Comprobar la calidad del renderizado
• [ ] Comparar resultados de extracción de texto
• [ ] Prueba de despliegue multiplataforma
• [ ] Añadir nuevas funciones (HTML a PDF, fusión, marcas de agua, seguridad)
• [ ] Actualización de la documentación