GUíAS DE MIGRACIóN

Cómo migrar de PuppeteerSharp a IronPDF en C#

Actualizado:enero 7, 2026

Migrar de PuppeteerSharpa IronPDF: Guía completa de migración a C

La migración de PuppeteerSharpaIronPDFtransforma su flujo de trabajo de generación de PDF de una herramienta de automatización del navegador con dependencias de más de 300 MB a una biblioteca PDF creada específicamente con gestión automática de memoria. Esta guía proporciona una ruta de migración completa, paso a paso, que elimina las descargas de Chromium, resuelve los problemas de fugas de memoria y proporciona capacidades completas de manipulación de PDF.

Por qué migrar de PuppeteerSharpa IronPDF

Entendiendo PuppeteerSharp

PuppeteerSharp es una adaptación a .NET de Puppeteer de Google, que lleva las capacidades de automatización del navegador a C#. Genera archivos PDF utilizando la función integrada de impresión a PDF de Chrome, igual que si pulsaras Ctrl+P en un navegador. El resultado es un documento listo para imprimir y optimizado para el papel, que difiere de lo que se ve en pantalla.

PuppeteerSharp se diseñó para pruebas web y scraping, no para la generación de documentos. Aunque es capaz, el uso de PuppeteerSharppara la generación de PDF crea importantes retos de producción.

El problema de la automatización del navegador

PuppeteerSharp se diseñó para la automatización de navegadores, no para la generación de documentos. Esto plantea problemas fundamentales cuando se utiliza para PDF:

se requieren 300MB+ de descargas de Chromium antes del primer uso. Una desventaja significativa de PuppeteerSharpes su gran tamaño de despliegue, debido principalmente al binario Chromium que incluye. Este tamaño considerable puede inflar las imágenes de Docker y causar problemas de arranque en frío en entornos sin servidor.
Fugas de memoria bajo carga que requieren el reciclaje manual del navegador. Bajo carga pesada, PuppeteerSharpes conocido por experimentar fugas de memoria. La acumulación de memoria por parte de las instancias del navegador hace necesaria la intervención manual para la gestión y el reciclaje del proceso.
Patrones async complejos con gestión del ciclo de vida del navegador.
Print-to-PDF output (equivalente a Ctrl+P, no captura de pantalla). Los diseños pueden refluir, los fondos pueden omitirse por defecto y el resultado se pagina para la impresión en lugar de ajustarse a la ventana del navegador.
No es compatible con PDF/A ni PDF/UA por requisitos de conformidad. PuppeteerSharpno puede producir documentos PDF/A (archivo) o PDF/UA (accesibilidad).
Sin manipulación de PDF - sólo generación, sin fusión/división/edición. Aunque PuppeteerSharpes eficiente a la hora de generar archivos PDF, carece de capacidades para su manipulación posterior, como combinar, dividir, proteger o editar archivos PDF.

Comparación entre PuppeteerSharpy IronPDF

Aspecto	PuppeteerSharp	IronPDF
Finalidad principal	Automatización de navegadores	Generación de PDF
Dependencia de Chromium	descarga separada de más de 300 MB	Motor integrado optimizado
Complejidad de la API	Ciclo de vida asíncrono de navegador/página	Sincronización de frases
Inicialización	`BrowserFetcher.DownloadAsync()` + LaunchAsync	<código>new ChromePdfRenderer()</código
Gestión de memoria	Se requiere reciclaje manual del navegador	Automático
Memoria bajo carga	más de 500 MB con filtraciones	~50 MB estables
Inicio en frío	más de 45 segundos	~20 segundos
Soporte PDF/A	No disponible	Soporte completo
Accesibilidad PDF/UA	No disponible	Soporte completo
Edición de PDF	No disponible	Combinar, dividir, sellar, editar
Firmas digitales	No disponible	Soporte completo
Seguridad de hilos	Limitado	Completo
Soporte profesional	Comunidad	Comercial con SLA

Soporte de plataforma

Biblioteca	.NET Framework 4.7.2	.NET Core 3.1	.NET 6-8	.NET 10
IronPDF	Completo	Completo	Completo	Completo
PuppeteerSharp	Limitado	Completo	Completo	Pendiente

La amplia compatibilidad deIronPDFcon todas las plataformas .NET garantiza que los desarrolladores puedan utilizarlo en varios entornos sin encontrar problemas de compatibilidad, lo que proporciona una opción flexible para las aplicaciones .NET modernas hasta 2025 y 2026.

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

Cambios en el paquete NuGet

# Remove PuppeteerSharp
dotnet remove package PuppeteerSharp

# Remove downloaded Chromium binaries (~300MB recovered)
# Delete the .local-chromium folder

# Add IronPDF
dotnet add package IronPdf

# Remove PuppeteerSharp
dotnet remove package PuppeteerSharp

# Remove downloaded Chromium binaries (~300MB recovered)
# Delete the .local-chromium folder

# Add IronPDF
dotnet add package IronPdf

SHELL

No se requiere BrowserFetcher.DownloadAsync() con IronPDF - el motor de renderizado se incluye automáticamente.

Configuración de licencias

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Referencia completa de la API

Cambios en el espacio de nombres

// Before: PuppeteerSharp
using PuppeteerSharp;
using PuppeteerSharp.Media;
using System.Threading.Tasks;

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

// Before: PuppeteerSharp
using PuppeteerSharp;
using PuppeteerSharp.Media;
using System.Threading.Tasks;

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Core API Mappings

API de PuppeteerSharp	API de IronPDF	Notas
`new BrowserFetcher().DownloadAsync()`	No es necesario	Sin descarga de navegador
<código>Puppeteer.LaunchAsync(options)</código	No es necesario	Sin gestión de navegador
<código>browser.NewPageAsync()</código	No es necesario	Sin contexto de página
<código>page.GoToAsync(url)</código	<código>renderer.RenderUrlAsPdf(url)</código	Traducción directa
<código>page.SetContentAsync(html)</código	`renderer.RenderHtmlAsPdf(html)`	Traducción directa
<código>page.PdfAsync(ruta)</código	<código>pdf.SaveAs(ruta)</código	Después de la traducción
`esperar page.CloseAsync()`	No es necesario	Limpieza automática
`espera browser.CloseAsync()`	No es necesario	Limpieza automática
<código>PdfOptions.Format</código	<código>RenderingOptions.PaperSize</código	Tamaño del papel
<código>PdfOptions.Landscape</código	<código>RenderingOptions.PaperOrientation</código	Orientación
<código>PdfOptions.MarginOptions</código	<código>RenderingOptions.MarginTop/Bottom/Left/Right</código	Márgenes individuales
<código>PdfOptions.PrintBackground</código	<código>RenderingOptions.PrintHtmlBackgrounds</código	Impresión de fondo
<código>PdfOptions.HeaderTemplate</código	<código>RenderingOptions.HtmlHeader</código	Encabezados HTML
<código>PdfOptions.FooterTemplate</código	<código>RenderingOptions.HtmlFooter</código	Pies de página HTML
<código>page.WaitForSelectorAsync()</código	<código>RenderingOptions.WaitFor.HtmlElementId</código	Esperar elemento

Ejemplos de migración de código

Ejemplo 1: Conversión básica de HTML a PDF

Antes (PuppeteerSharp):

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Hello World</h1><p>This is a PDF document.</p>");
        await page.PdfAsync("output.pdf");
    }
}

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Hello World</h1><p>This is a PDF document.</p>");
        await page.PdfAsync("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

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

// NuGet: Install-Package IronPdf
using IronPdf;

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Este ejemplo demuestra la diferencia arquitectónica fundamental. PuppeteerSharprequiere seis operaciones async: BrowserFetcher.DownloadAsync() (300MB+ Chromium download), Puppeteer.LaunchAsync(), browser.NewPageAsync(), page.SetContentAsync(), y page.PdfAsync(), además de su correcta eliminación con await using.

IronPDF elimina toda esta complejidad: cree un ChromePdfRenderer, llame a RenderHtmlAsPdf() y SaveAs(). Ni patrones asíncronos, ni ciclo de vida del navegador, ni descargas de Chromium. El enfoque deIronPDFofrece una sintaxis más limpia y una mejor integración con las aplicaciones .NET modernas. Consulte la documentación HTML a PDF para ver ejemplos completos.

Ejemplo 2: Conversión de URL a PDF

Antes (PuppeteerSharp):

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.GoToAsync("https://www.example.com");
        await page.PdfAsync("webpage.pdf");
    }
}

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.GoToAsync("https://www.example.com");
        await page.PdfAsync("webpage.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

PuppeteerSharp utiliza GoToAsync() para navegar a una URL seguida de PdfAsync().IronPDFproporciona un único método RenderUrlAsPdf() que gestiona la navegación y la generación de PDF en una sola llamada. Más información en nuestros tutoriales.

Ejemplo 3: Configuración de página personalizada con márgenes

Antes (PuppeteerSharp):

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using PuppeteerSharp.Media;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");

        await page.PdfAsync("custom.pdf", new PdfOptions
        {
            Format = PaperFormat.A4,
            Landscape = true,
            MarginOptions = new MarginOptions
            {
                Top = "20mm",
                Bottom = "20mm",
                Left = "20mm",
                Right = "20mm"
            }
        });
    }
}

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using PuppeteerSharp.Media;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");

        await page.PdfAsync("custom.pdf", new PdfOptions
        {
            Format = PaperFormat.A4,
            Landscape = true,
            MarginOptions = new MarginOptions
            {
                Top = "20mm",
                Bottom = "20mm",
                Left = "20mm",
                Right = "20mm"
            }
        });
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;

        var pdf = renderer.RenderHtmlAsPdf("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");
        pdf.SaveAs("custom.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;

        var pdf = renderer.RenderHtmlAsPdf("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");
        pdf.SaveAs("custom.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Este ejemplo muestra la correspondencia entre las opciones PDF de las dos bibliotecas. PuppeteerSharputiliza PdfOptions con Format, Landscape y MarginOptions que contienen valores de cadena ("20mm").IronPDFutiliza propiedades RenderingOptions con enums directos de tamaño de papel, enums de orientación y valores numéricos de margen en milímetros.

Asignaciones clave:

Formato = PaperFormat.A4 → TamañoPapel = PdfPaperSize.A4
Landscape = true → PaperOrientation = PdfPaperOrientation.Landscape
MarginOptions.Top = "20mm" → MarginTop = 20 (milímetros numéricos)

El problema de las fugas de memoria

PuppeteerSharp es notorio por la acumulación de memoria bajo carga sostenida:

// ❌ PuppeteerSharp- Memory grows with each operation
// Requires explicit browser recycling every N operations
for (int i = 0; i < 1000; i++)
{
    var page = await browser.NewPageAsync();
    await page.SetContentAsync($"<h1>Document {i}</h1>");
    await page.PdfAsync($"doc_{i}.pdf");
    await page.CloseAsync(); // Memory still accumulates!
}
// Must periodically: await browser.CloseAsync(); and re-launch

// ✅IronPDF- Stable memory, reuse renderer
var renderer = new ChromePdfRenderer();
for (int i = 0; i < 1000; i++)
{
    var pdf = renderer.RenderHtmlAsPdf($"<h1>Document {i}</h1>");
    pdf.SaveAs($"doc_{i}.pdf");
    // Memory managed automatically
}

// ❌ PuppeteerSharp- Memory grows with each operation
// Requires explicit browser recycling every N operations
for (int i = 0; i < 1000; i++)
{
    var page = await browser.NewPageAsync();
    await page.SetContentAsync($"<h1>Document {i}</h1>");
    await page.PdfAsync($"doc_{i}.pdf");
    await page.CloseAsync(); // Memory still accumulates!
}
// Must periodically: await browser.CloseAsync(); and re-launch

// ✅IronPDF- Stable memory, reuse renderer
var renderer = new ChromePdfRenderer();
for (int i = 0; i < 1000; i++)
{
    var pdf = renderer.RenderHtmlAsPdf($"<h1>Document {i}</h1>");
    pdf.SaveAs($"doc_{i}.pdf");
    // Memory managed automatically
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF elimina la necesidad de la infraestructura de agrupación de navegadores que requiere PuppeteerSharp:

// Before (PuppeteerSharp - delete entire class)
public class PuppeteerBrowserPool
{
    private readonly ConcurrentBag<IBrowser> _browsers;
    private readonly SemaphoreSlim _semaphore;
    private int _operationCount;
    // ... recycling logic ...
}

// After (IronPDF - simple reuse)
public class PdfService
{
    private readonly ChromePdfRenderer _renderer = new();

    public byte[] Generate(string html)
    {
        return _renderer.RenderHtmlAsPdf(html).BinaryData;
    }
}

// Before (PuppeteerSharp - delete entire class)
public class PuppeteerBrowserPool
{
    private readonly ConcurrentBag<IBrowser> _browsers;
    private readonly SemaphoreSlim _semaphore;
    private int _operationCount;
    // ... recycling logic ...
}

// After (IronPDF - simple reuse)
public class PdfService
{
    private readonly ChromePdfRenderer _renderer = new();

    public byte[] Generate(string html)
    {
        return _renderer.RenderHtmlAsPdf(html).BinaryData;
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Notas de migración críticas

Conversión de Async a Sync

PuppeteerSharp requiere async/await en todo momento;IronPDFadmite operaciones síncronas:

// PuppeteerSharp: Async required
public async Task<byte[]> GeneratePdfAsync(string html)
{
    await new BrowserFetcher().DownloadAsync();
    await using var browser = await Puppeteer.LaunchAsync(...);
    await using var page = await browser.NewPageAsync();
    await page.SetContentAsync(html);
    return await page.PdfDataAsync();
}

// IronPDF: Sync default
public byte[] GeneratePdf(string html)
{
    var renderer = new ChromePdfRenderer();
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}

// Or async when needed
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

// PuppeteerSharp: Async required
public async Task<byte[]> GeneratePdfAsync(string html)
{
    await new BrowserFetcher().DownloadAsync();
    await using var browser = await Puppeteer.LaunchAsync(...);
    await using var page = await browser.NewPageAsync();
    await page.SetContentAsync(html);
    return await page.PdfDataAsync();
}

// IronPDF: Sync default
public byte[] GeneratePdf(string html)
{
    var renderer = new ChromePdfRenderer();
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}

// Or async when needed
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Conversión de unidades de margen

PuppeteerSharp utiliza unidades de cadena;IronPDFutiliza milímetros numéricos:

// PuppeteerSharp- string units
MarginOptions = new MarginOptions
{
    Top = "1in",      // 25.4mm
    Bottom = "0.75in", // 19mm
    Left = "1cm",     // 10mm
    Right = "20px"    // ~7.5mm at 96dpi
}

//IronPDF- numeric millimeters
renderer.RenderingOptions.MarginTop = 25;    // mm
renderer.RenderingOptions.MarginBottom = 19;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 8;

// PuppeteerSharp- string units
MarginOptions = new MarginOptions
{
    Top = "1in",      // 25.4mm
    Bottom = "0.75in", // 19mm
    Left = "1cm",     // 10mm
    Right = "20px"    // ~7.5mm at 96dpi
}

//IronPDF- numeric millimeters
renderer.RenderingOptions.MarginTop = 25;    // mm
renderer.RenderingOptions.MarginBottom = 19;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 8;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Conversión de marcadores de posición de encabezado/pie

Clase PuppeteerSharp	Marcador de posición IronPDF
<código> class="pageNumber"></código>	`{page}`
<código> class="totalPages"></código>	`{total de páginas}`
<código> class="fecha"></código>	`{fecha}`
<código> class="title"></código>	`{html-title}`

Nuevas capacidades tras la migración

Después de migrar a IronPDF, obtendrá capacidades que PuppeteerSharpno puede proporcionar:

Fusión de PDF

var pdf1 = renderer.RenderHtmlAsPdf(html1);
var pdf2 = renderer.RenderHtmlAsPdf(html2);
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = renderer.RenderHtmlAsPdf(html1);
var pdf2 = renderer.RenderHtmlAsPdf(html2);
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Marcas de agua

var watermark = new TextStamper
{
    Text = "CONFIDENTIAL",
    FontSize = 48,
    Opacity = 30,
    Rotation = -45
};
pdf.ApplyStamp(watermark);

var watermark = new TextStamper
{
    Text = "CONFIDENTIAL",
    FontSize = 48,
    Opacity = 30,
    Rotation = -45
};
pdf.ApplyStamp(watermark);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Protección con contraseña

pdf.SecuritySettings.OwnerPassword = "admin";
pdf.SecuritySettings.UserPassword = "readonly";
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SecuritySettings.OwnerPassword = "admin";
pdf.SecuritySettings.UserPassword = "readonly";
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Firmas digitales

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Cumplimiento de PDF/A

pdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b);

pdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Resumen comparativo de prestaciones

Métrica	PuppeteerSharp	IronPDF	Mejora
Primer PDF (Cold Start)	45s+	~20s	55%+ más rápido
PDF posteriores	Variable	Consistente	Predecible
Uso de memoria	500MB+ (crece)	~50 MB (estable)	90% menos de memoria
Espacio en disco (Chromium)	mÁS DE 300 MB	0	Eliminar descargas
Navegador Descargar	Requerido	No es necesario	Cero configuración
Seguridad de los hilos	Limitado	Completo	Concurrencia fiable
Tiempo de generación de PDF	45s	20s	55% más rápido

Lista de comprobación de la migración

Pre-Migración

[ ] Identificar todos los usos de PuppeteerSharpen el código base
[ ] Valores de márgenes de documentos (convertir cadenas a milímetros)
[ ] Tenga en cuenta la sintaxis del encabezado/pie de página para la conversión
[ ] Eliminar la infraestructura de agrupación/reciclaje de navegadores
[ ] Obtenga la clave de licencia deIronPDFen ironpdf.com

Cambios en el paquete

[ ] Eliminar el paquete NuGet PuppeteerSharp
[ ] Elimine la carpeta .local-chromium para recuperar ~300 MB de espacio en disco
[Instale el paquete NuGet IronPdf: dotnet add package IronPdf

Cambios de código

[ ] Actualizar las importaciones de espacios de nombres
[ ] Eliminar las llamadas BrowserFetcher.DownloadAsync()
[ ] Eliminar Puppeteer.LaunchAsync() y la gestión del navegador
[ ] Sustituya page.SetContentAsync() + page.PdfAsync() por RenderHtmlAsPdf()
[Reemplace page.GoToAsync() + page.PdfAsync() por RenderUrlAsPdf()
[ ] Convertir cadenas de márgenes en valores milimétricos
[ ] Convertir la sintaxis de los marcadores de posición de encabezado/pie de página
[ ] Eliminar todo el código de eliminación de navegadores/páginas
[ ] Eliminar la infraestructura de agrupación de navegadores
[ ] Añadir inicialización de licencia al inicio de la aplicación

Posmigración

[ ] Comparación visual de la salida PDF
[ ] Prueba de carga para la estabilidad de la memoria (debe permanecer estable sin reciclaje)
[ ] Verificar la representación de encabezado/pie de página con números de página
[ ] Añadir nuevas funciones (seguridad, marcas de agua, fusión) según sea necesario

Conclusión

A la hora de elegir entre PuppeteerSharpe IronPDF, tenga en cuenta las necesidades específicas de su proyecto. PuppeteerSharpdestaca en situaciones en las que se requiere un renderizado HTML preciso y la sobrecarga de gestionar las dependencias de Chromium es justificable. Por el contrario,IronPDFofrece un paquete completo con amplias capacidades de manipulación de PDF, una facilidad de implementación inigualable y una gestión de memoria superior que resulta ideal para los desarrolladores que buscan simplicidad y versatilidad.

Los cambios clave en esta migración son:

Arquitectura: Herramienta de automatización de navegadores → Biblioteca PDF de propósito específico
Dependencias: Descarga de Chromium de más de 300 MB → Motor de renderizado incluido
Complejidad: 6+ operaciones asíncronas → 3 llamadas síncronas
Memoria: 500MB+ con fugas → ~50MB estable
Gestión de navegadores: Ciclo de vida manual y reciclaje → Gestión automática
Margenes: Unidades de cadena ("20mm") → Milímetros numéricos (20)
Placeholders: Clases CSS (<span> class="pageNumber">) → llaves ({page})
Rendimiento: 45sarranque en frío → ~20sarranque en frío
Nuevas funciones: Fusión y división de PDF, marcas de agua, seguridad, firmas digitales, conformidad con PDF/A

Ambas bibliotecas tienen sus puntos fuertes y débiles, y comprenderlos puede guiarle a la hora de seleccionar la herramienta adecuada para sus necesidades de generación y manipulación de PDF.

Explore la documentación completa IronPDF, tutoriales, y API reference para acelerar su migración a PuppeteerSharp.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

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

Cómo migrar de QuestPDF a IronPDF en C#

Cómo migrar de PrinceXML a IronPDF...

Destacado del Cliente:

Enfoque del Desarrollador:

Webinars:

Cómo migrar de PuppeteerSharp a IronPDF en C#

Migrar de PuppeteerSharpa IronPDF: Guía completa de migración a C

Por qué migrar de PuppeteerSharpa IronPDF

Entendiendo PuppeteerSharp

El problema de la automatización del navegador

Comparación entre PuppeteerSharpy IronPDF

Soporte de plataforma

Antes de empezar

Prerrequisitos

Cambios en el paquete NuGet

Configuración de licencias

Referencia completa de la API

Cambios en el espacio de nombres

Core API Mappings

Ejemplos de migración de código

Ejemplo 1: Conversión básica de HTML a PDF

Ejemplo 2: Conversión de URL a PDF

Ejemplo 3: Configuración de página personalizada con márgenes

El problema de las fugas de memoria

Notas de migración críticas

Conversión de Async a Sync

Conversión de unidades de margen

Conversión de marcadores de posición de encabezado/pie

Nuevas capacidades tras la migración

Fusión de PDF

Marcas de agua

Protección con contraseña

Firmas digitales

Cumplimiento de PDF/A

Resumen comparativo de prestaciones

Lista de comprobación de la migración

Pre-Migración

Cambios en el paquete

Cambios de código

Posmigración

Conclusión

Cómo migrar de PuppeteerSharp a IronPDF en C#

Migrar de PuppeteerSharpa IronPDF: Guía completa de migración a C

Por qué migrar de PuppeteerSharpa IronPDF

Entendiendo PuppeteerSharp

El problema de la automatización del navegador

Comparación entre PuppeteerSharpy IronPDF

Soporte de plataforma

Antes de empezar

Prerrequisitos

Cambios en el paquete NuGet

Configuración de licencias

Referencia completa de la API

Cambios en el espacio de nombres

Core API Mappings

Ejemplos de migración de código

Ejemplo 1: Conversión básica de HTML a PDF

Ejemplo 2: Conversión de URL a PDF

Ejemplo 3: Configuración de página personalizada con márgenes

El problema de las fugas de memoria

Notas de migración críticas

Conversión de Async a Sync

Conversión de unidades de margen

Conversión de marcadores de posición de encabezado/pie

Nuevas capacidades tras la migración

Fusión de PDF

Marcas de agua

Protección con contraseña

Firmas digitales

Cumplimiento de PDF/A

Resumen comparativo de prestaciones

Lista de comprobación de la migración

Pre-Migración

Cambios en el paquete

Cambios de código

Posmigración

Conclusión

Artículos Relacionados

Cómo migrar de WebView2 a IronPDF en C#

Cómo migrar de iText a IronPDF en C#

Cómo migrar de GemBox PDF a IronPDF en C#

Próximo paso: Comenzar prueba gratuita de 30 días

Próximo paso: Comenzar prueba gratuita de 30 días

Confiado por más de 2 millones de ingenieros en todo el mundo