Cómo migrar de PdfPig a IronPDF en C#
La migración de PdfPigaIronPDFamplía sus capacidades PDF de una biblioteca de sólo lectura a una solución PDF completa que gestiona la creación, la manipulación, la extracción de texto y las funciones de seguridad. Esta guía proporciona una ruta de migración completa, paso a paso, que conserva sus flujos de trabajo de extracción existentes al tiempo que añade la generación de PDF, la conversión HTML, la manipulación de documentos y las capacidades de seguridad que PdfPigno puede proporcionar.
Por qué migrar de PdfPiga IronPDF
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:
-
No se pueden generar PDF: no se pueden crear archivos PDF desde HTML, URL o mediante programación.
-
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.
-
Sin manipulación de documentos: no se pueden fusionar, dividir ni modificar archivos PDF.
-
Sin funciones de seguridad: no se pueden agregar contraseñas, cifrado ni firmas digitales.
-
Sin marcas de agua/sellos: no se pueden agregar superposiciones visuales a los documentos existentes.
- No se pueden rellenar formularios: no se pueden rellenar formularios PDF mediante programación.
Comparación entre PdfPige IronPDF
| Característica | PdfPig | IronPDF |
|---|---|---|
| Licencia | Código abierto (Apache 2.0) | Comercial |
| Lectura/Extracción de PDF | Excelente | Excelente |
| Generación de PDF | Limitado | Completo |
| HTML a PDF | No compatible | Se admite |
| Extracción de texto | Excelente | Excelente |
| Manipulación de PDF | No soportado | Combinar, dividir, rotar |
| Marcas de agua | No soportado | Se admite |
| Seguridad/Encriptación | No soportado | Se admite |
| Soporte y documentación | Apoyo a la comunidad | Soporte dedicado |
| Indexación de páginas | basado en 1 | basado en 0 |
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.
Antes de empezar
Prerrequisitos
- Entorno .NET : .NET Framework 4.6.2+ o .NET Core 3.1+ / .NET 5/6/7/8/9+
- Acceso a NuGet : Capacidad para instalar paquetes NuGet
- Licencia deIronPDF: Obtenga su clave de licencia en IronPDF
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";
' Add at application startup (Program.vb or Startup.vb)
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" .
Referencia completa de la API
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;
' Before: PdfPig
Imports UglyToad.PdfPig
Imports UglyToad.PdfPig.Content
Imports UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor
' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering
Mapas de carga de documentos
| PdfPig | IronPDF |
|---|---|
PdfDocument.Open(path) |
PdfDocument.FromFile(path) |
PdfDocument.Open(bytes) |
PdfDocument.FromBinaryData(bytes) |
PdfDocument.Open(stream) |
PdfDocument.FromStream(stream) |
using (var doc = ...) |
var pdf = ... |
Acceso a páginas y asignaciones de propiedades
| PdfPig | IronPDF |
|---|---|
document.NumberOfPages |
pdf.PageCount |
document.GetPages() |
pdf.Pages |
document.GetPage(1) |
pdf.Pages[0] |
Mapas de extracción de texto
| PdfPig | IronPDF |
|---|---|
page.Text |
pdf.Pages[i].Text |
page.GetWords() |
pdf.ExtractTextFromPage(i) |
| (manual loop) | pdf.ExtractAllText() |
Metadatos de acceso
| PdfPig | IronPDF |
|---|---|
document.Information.Title |
pdf.MetaData.Title |
document.Information.Author |
pdf.MetaData.Author |
document.Information.Subject |
pdf.MetaData.Subject |
document.Information.Creator |
pdf.MetaData.Creator |
document.Information.Producer |
pdf.MetaData.Producer |
Nuevas funciones no disponibles en PdfPig
| Características de IronPDF | Descripción |
|---|---|
renderer.RenderHtmlAsPdf(html) |
Conversión de HTML a PDF |
renderer.RenderUrlAsPdf(url) |
Conversión de URL a PDF |
PdfDocument.Merge(pdfs) |
Combinar varios PDF |
pdf.ApplyWatermark(html) |
Añadir marcas de agua |
pdf.SecuritySettings.UserPassword |
Protección mediante contraseña |
pdf.Sign(certificate) |
Firmas digitales |
Ejemplos de migración de código
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());
}
}
}
Imports UglyToad.PdfPig
Imports System
Imports System.Text
Class Program
Shared Sub Main()
Using document = PdfDocument.Open("input.pdf")
Dim text = New StringBuilder()
For Each page In document.GetPages()
text.AppendLine(page.Text)
Next
Console.WriteLine(text.ToString())
End Using
End Sub
End Class
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);
}
}
Imports IronPdf
Imports System
Class Program
Shared Sub Main()
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim text As String = pdf.ExtractAllText()
Console.WriteLine(text)
End Sub
End Class
Tanto PdfPigcomoIronPDFofrecen excelentes funciones de extracción de texto. La diferencia clave está en el patrón de código. PdfPigrequiere una declaración using con PdfDocument.Open(), iteración manual a través de las 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 la declaración using, no hay 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):
PdfPig no admite la conversión de HTML a PDF. PdfPiges una biblioteca de lectura y análisis de PDF, no una biblioteca de generación de PDF. Necesitaría utilizar una biblioteca diferente para la conversión de HTML a PDF.
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");
}
}
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>")
pdf.SaveAs("output.pdf")
End Sub
End Class
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 proporciona conversión nativa de HTML a PDF a través de ChromePdfRenderer. El método RenderHtmlAsPdf() acepta cadenas HTML y las convierte en documentos PDF utilizando un motor Chromium interno para una representación precisa de HTML, CSS y JavaScript. El PdfDocument resultante se puede guardar con SaveAs() o manipularlo 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}");
}
}
}
Imports UglyToad.PdfPig
Imports System
Class Program
Shared Sub Main()
Using document = PdfDocument.Open("input.pdf")
Dim 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}")
End Using
End Sub
End Class
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}");
}
}
Imports IronPdf
Imports System
Class Program
Shared Sub Main()
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim 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}")
End Sub
End Class
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 metadatos y pdf.PageCount para el recuento de páginas.
La migración es sencilla: reemplace PdfDocument.Open() con PdfDocument.FromFile(), document.Information con pdf.MetaData y document.NumberOfPages con pdf.PageCount. Elimine el contenedor de declaración using ya queIronPDFno lo requiere.
Notas de migración críticas
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;
' PdfPig: basado en 1indexing
Dim firstPage = document.GetPage(1) ' First page
' IronPDF: basado en 0indexing
Dim firstPage = pdf.Pages(0) ' First page
' Migration helper
Dim pdfPigIndex As Integer = 1
Dim ironPdfIndex As Integer = 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
Imports PdfPig
Imports IronPDF
Using document = PdfDocument.Open("input.pdf")
' ...
End Using
Dim 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");
Imports PdfPig
Imports IronPDF
Using document = PdfDocument.Open("input.pdf")
End Using
Dim 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;
' PdfPig: document.Information
Dim info = document.Information
' IronPDF: pdf.MetaData
Dim 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}");
' PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}")
' IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}")
Nuevas capacidades tras la migración
Tras migrar a IronPDF, obtendrá funciones que PdfPigno puede ofrecerle:
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");
Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim 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>");
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";
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);
Dim signature As New PdfSignature("certificate.pfx", "password") With {
.SigningContact = "support@company.com",
.SigningReason = "Document Approval"
}
pdf.Sign(signature)
Resumen comparativo de características
| Característica | PdfPig | IronPDF |
|---|---|---|
| Extracción de Texto | ✓ | ✓ |
| Acceso a metadatos | ✓ | ✓ |
| Extracción de imágenes | ✓ | ✓ |
| Creación de PDF | Limitado | ✓ |
| HTML a PDF | ✗ | ✓ |
| URL a PDF | ✗ | ✓ |
| Fusionar PDF | ✗ | ✓ |
| Dividir PDF | ✗ | ✓ |
| Marcas de agua | ✗ | ✓ |
| Relleno de formularios | ✗ | ✓ |
| Protección por contraseña | ✗ | ✓ |
| Firmas digitales | ✗ | ✓ |
| Datos de posición de palabras | ✓ | ✗ |
Lista de comprobación de la migración
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
PdfPigpaquete NuGet :dotnet remove package PdfPig - Instalar
IronPdfel paquete NuGet :dotnet add package IronPdf
Cambios de código
- Actualizar las importaciones del espacio de nombres (
using UglyToad.PdfPig;→using IronPdf;) - Reemplace
PdfDocument.Open()conPdfDocument.FromFile() - Reemplace
document.Informationconpdf.MetaData - Reemplace
document.NumberOfPagesconpdf.PageCount - Convertir índices de página de base 1 a base 0
- Eliminar las 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

