Cómo migrar de PdfPig a IronPDF en C#

Entendiendo PdfPig

PdfPig es una biblioteca de lectura y extracción de PDF de código abierto diseñada específicamente para C#. Como rama del reputado proyecto Apache PDFBox, esta biblioteca permite a los desarrolladores acceder al contenido de los PDF con notable precisión. Aunque PdfPigbrilla por sus capacidades de extracción, su alcance es muy limitado en comparación con otras bibliotecas más completas disponibles en el mercado.

PdfPig proporciona a los desarrolladores herramientas fiables para extraer texto, imágenes, datos de formularios y metadatos de archivos PDF. Esto lo convierte en una opción adecuada para aplicaciones centradas principalmente en el análisis de documentos y la minería de datos. Sin embargo, las capacidades de PdfPigse limitan fundamentalmente al análisis sintáctico de documentos existentes.

La limitación de sólo lectura

PdfPig se centra exclusivamente en la lectura de PDF. Cuando su aplicación necesita crecer más allá de la extracción, PdfPigno puede ayudarle:

1. No se pueden generar PDF: no se pueden crear archivos PDF desde HTML, URL o mediante programación.

2. No HTML-to-PDF: PdfPiges una biblioteca de lectura/análisis de PDF, no una biblioteca de generación de PDF. Para la conversión de HTML a PDF es necesario utilizar una biblioteca diferente.

3. Sin manipulación de documentos: no se pueden fusionar, dividir ni modificar archivos PDF.

4. Sin funciones de seguridad: no se pueden agregar contraseñas, cifrado ni firmas digitales.

5. Sin marcas de agua/sellos: no se pueden agregar superposiciones visuales a los documentos existentes.

6. No se pueden rellenar formularios: no se pueden rellenar formularios PDF mediante programación.

Comparación entre PdfPige IronPDF

IronPDF es compatible con un conjunto completo de funciones para crear, leer, editar y firmar archivos PDF. Esta versatilidad permite a los desarrolladores gestionar archivos PDF de principio a fin. Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDFofrece una solución completa para el ciclo de vida de PDF que va más allá de las capacidades de lectura de PdfPig.

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 de IronPDF: Obtenga su clave de licencia en ironpdf.com

Cambios en el paquete NuGet

# Remove PdfPig
dotnet remove package PdfPig

# Install IronPDF
dotnet add package IronPdf

# Remove PdfPig
dotnet remove package PdfPig

# Install IronPDF
dotnet add package IronPdf

Configuración de licencias

// 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";

Identificar el uso de PdfPig

# Find PdfPigusage
grep -r "UglyToad\.PdfPig\|PdfDocument\.Open\|GetPages\(\)" --include="*.cs" .

# Find page index references (may need 1→0 conversion)
grep -r "GetPage(\|NumberOfPages" --include="*.cs" .

# Find PdfPigusage
grep -r "UglyToad\.PdfPig\|PdfDocument\.Open\|GetPages\(\)" --include="*.cs" .

# Find page index references (may need 1→0 conversion)
grep -r "GetPage(\|NumberOfPages" --include="*.cs" .

Cambios en el espacio de nombres

// Before: PdfPig
using UglyToad.PdfPig;
using UglyToad.PdfPig.Content;
using UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

// Before: PdfPig
using UglyToad.PdfPig;
using UglyToad.PdfPig.Content;
using UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

Mapas de carga de documentos

Acceso a páginas y asignaciones de propiedades

Mapas de extracción de texto

Metadatos de acceso

Nuevas funciones no disponibles en PdfPig

Ejemplo 1: Extracción de texto de un PDF

Antes (PdfPig):

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var text = new StringBuilder();
            foreach (var page in document.GetPages())
            {
                text.AppendLine(page.Text);
            }
            Console.WriteLine(text.ToString());
        }
    }
}

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var text = new StringBuilder();
            foreach (var page in document.GetPages())
            {
                text.AppendLine(page.Text);
            }
            Console.WriteLine(text.ToString());
        }
    }
}

Después (IronPDF):

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();
        Console.WriteLine(text);
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();
        Console.WriteLine(text);
    }
}

Tanto PdfPigcomoIronPDFofrecen excelentes funciones de extracción de texto. La diferencia clave está en el patrón de código. PdfPigrequiere una sentencia using con PdfDocument.Open(), iteración manual a través de páginas con GetPages(), y un StringBuilder para acumular texto de cada propiedad page.Text.

IronPDF simplifica esto a una sola llamada: PdfDocument.FromFile() carga el documento, y ExtractAllText() devuelve todo el contenido de texto a la vez. No se requiere una declaración using, ni iteración manual, ni StringBuilder. Consulte la documentación sobre extracción de texto para obtener más opciones.

Ejemplo 2: Conversión de HTML a PDF

Antes (PdfPig):

// PdfPigdoes not support HTML a PDFconversion
// PdfPigis a PDF reading/parsing library, not a PDF generation library
// You would need to use a different library for HTML a PDFconversion

// PdfPigdoes not support HTML a PDFconversion
// PdfPigis a PDF reading/parsing library, not a PDF generation library
// You would need to use a different library for HTML a PDFconversion

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>");
        pdf.SaveAs("output.pdf");
    }
}

Este ejemplo pone de manifiesto la carencia más significativa. PdfPigafirma explícitamente que "no admite la conversión de HTML a PDF" y que "es una biblioteca de lectura y análisis de PDF, no una biblioteca de generación de PDF" Si necesita crear PDF a partir de HTML con PdfPig, tendrá que utilizar una biblioteca completamente distinta.

IronPDF ofrece conversión nativa de HTML a PDF mediante ChromePdfRenderer. El método RenderHtmlAsPdf() acepta cadenas HTML y las convierte en documentos PDF utilizando internamente un motor Chromium para una renderización precisa de HTML, CSS y JavaScript. El PdfDocument resultante puede guardarse con SaveAs() o manipularse aún más antes de guardarlo. Consulte la documentación HTML a PDF para ver ejemplos completos.

Ejemplo 3: Lectura de metadatos PDF

Antes (PdfPig):

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var info = document.Information;
            Console.WriteLine($"Title: {info.Title}");
            Console.WriteLine($"Author: {info.Author}");
            Console.WriteLine($"Subject: {info.Subject}");
            Console.WriteLine($"Creator: {info.Creator}");
            Console.WriteLine($"Producer: {info.Producer}");
            Console.WriteLine($"Number of Pages: {document.NumberOfPages}");
        }
    }
}

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var info = document.Information;
            Console.WriteLine($"Title: {info.Title}");
            Console.WriteLine($"Author: {info.Author}");
            Console.WriteLine($"Subject: {info.Subject}");
            Console.WriteLine($"Creator: {info.Creator}");
            Console.WriteLine($"Producer: {info.Producer}");
            Console.WriteLine($"Number of Pages: {document.NumberOfPages}");
        }
    }
}

Después (IronPDF):

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        var info = pdf.MetaData;
        Console.WriteLine($"Title: {info.Title}");
        Console.WriteLine($"Author: {info.Author}");
        Console.WriteLine($"Subject: {info.Subject}");
        Console.WriteLine($"Creator: {info.Creator}");
        Console.WriteLine($"Producer: {info.Producer}");
        Console.WriteLine($"Number of Pages: {pdf.PageCount}");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        var info = pdf.MetaData;
        Console.WriteLine($"Title: {info.Title}");
        Console.WriteLine($"Author: {info.Author}");
        Console.WriteLine($"Subject: {info.Subject}");
        Console.WriteLine($"Creator: {info.Creator}");
        Console.WriteLine($"Producer: {info.Producer}");
        Console.WriteLine($"Number of Pages: {pdf.PageCount}");
    }
}

Ambas bibliotecas proporcionan acceso a metadatos con patrones casi idénticos. PdfPigaccede a los metadatos a través de document.Information y al recuento de páginas a través de document.NumberOfPages.IronPDFutiliza pdf.MetaData para los metadatos y <código>pdf.PageCount</códigopara el recuento de páginas.

La migración es sencilla: sustituir PdfDocument.Open() por PdfDocument.FromFile(), document.Information por pdf.MetaData, y documento.NúmeroDePáginaspor pdf.PageCount. Elimine la envoltura de la sentencia using, ya queIronPDFno la necesita.

Cambio en la indexación de páginas

PdfPig utiliza indexación basada en 1;IronPDFutiliza la base 0:

// PdfPig: basado en 1indexing
var firstPage = document.GetPage(1);  // First page

// IronPDF: basado en 0indexing
var firstPage = pdf.Pages[0];  // First page

// Migration helper
int pdfPigIndex = 1;
int ironPdfIndex = pdfPigIndex - 1;

// PdfPig: basado en 1indexing
var firstPage = document.GetPage(1);  // First page

// IronPDF: basado en 0indexing
var firstPage = pdf.Pages[0];  // First page

// Migration helper
int pdfPigIndex = 1;
int ironPdfIndex = pdfPigIndex - 1;

Declaración de uso no obligatoria

// PdfPig: Requires using for disposal
using (var document = PdfDocument.Open("input.pdf"))
{
    // ...
}

// IronPDF: No using required (but can use for cleanup)
var pdf = PdfDocument.FromFile("input.pdf");
// ...
// pdf.Dispose(); // Optional

// PdfPig: Requires using for disposal
using (var document = PdfDocument.Open("input.pdf"))
{
    // ...
}

// IronPDF: No using required (but can use for cleanup)
var pdf = PdfDocument.FromFile("input.pdf");
// ...
// pdf.Dispose(); // Optional

Cambio de carga del documento

// PdfPig: PdfDocument.Open()
using (var document = PdfDocument.Open("input.pdf"))

// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("input.pdf");

// PdfPig: PdfDocument.Open()
using (var document = PdfDocument.Open("input.pdf"))

// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("input.pdf");

Cambio de nombre de propiedad de metadatos

// PdfPig: document.Information
var info = document.Information;

// IronPDF: pdf.MetaData
var info = pdf.MetaData;

// PdfPig: document.Information
var info = document.Information;

// IronPDF: pdf.MetaData
var info = pdf.MetaData;

Cambio de la propiedad de recuento de páginas

// PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}");

// IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}");

// PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}");

// IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}");

Fusión de PDF

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

Marcas de agua

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

Protección con contraseña

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

Firmas digitales

var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningReason = "Document Approval"
};
pdf.Sign(signature);

var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningReason = "Document Approval"
};
pdf.Sign(signature);

Pre-Migración

• Inventariar todo el uso de PdfPigen el código base
• Identifique si necesita datos de posición a nivel de palabra (considere un enfoque híbrido)
• Tenga en cuenta todas las referencias de índice de página (es necesario convertir de base 1 a base 0)
• Planifique el almacenamiento de la clave de licencia deIronPDF(se recomiendan variables de entorno)
• Pruebe primero con la licencia de prueba de IronPDF

Cambios en el paquete

• Eliminar el paquete NuGet PdfPig : dotnet remove package PdfPig
• Instalar el paquete NuGet IronPdf : dotnet add package IronPdf

Cambios de código

• Actualizar las importaciones del espacio de nombres ( using UglyToad.PdfPig; → using IronPdf; )
• Reemplace PdfDocument.Open() con PdfDocument.FromFile()
• Reemplazar document.Information con pdf.MetaData
• Reemplace documento.NúmeroDePáginascon pdf.PageCount
• Convertir índices de página de base 1 a base 0
• Eliminar declaraciones using (opcional,IronPDFno las requiere)
• Agregue la clave de licencia deIronPDFal iniciar la aplicación

Posmigración

• La salida de la extracción de texto de prueba coincide con las expectativas
• Probar todos los escenarios de generación de PDF
• Agregue nuevas capacidades (fusión, marcas de agua, seguridad) según sea necesario
• Instalar dependencias de Linux si se realiza la implementación en Linux