Comprensión de Syncfusion PDFFramework

Syncfusion PDF Framework es una completa biblioteca que ofrece una amplia gama de funciones para crear, editar y proteger documentos PDF utilizando C#. Forma parte de Essential Studio de Syncfusion, que incluye más de mil componentes para múltiples plataformas.

Sin embargo, uno de sus inconvenientes más significativos es que no puede adquirirse como producto independiente; los desarrolladores deben comprar el paquete completo de componentes Syncfusion. Este requisito puede resultar engorroso para los equipos interesados únicamente en las funcionalidades de PDF, sobre todo porque este paquete podría incluir herramientas innecesarias para sus proyectos.

El problema de las licencias de paquetes

El modelo de licencias de Syncfusion plantea importantes retos a los equipos que solo necesitan la funcionalidad PDF:

1. Compra solo de Suite: No se puede comprar la biblioteca PDF por separado; se debe comprar Essential Studio completo.
2. Restricciones de la licencia comunitaria: el nivel gratuito requiere <$1 millón en ingresos y <5 desarrolladores
3. Licencias de implementación complejas: diferentes licencias para implementaciones web, de escritorio y de servidor
4. Renovación anual requerida: Modelo de suscripción con costos anuales
5. Precios por desarrollador: los costos se escalan linealmente con el tamaño del equipo.
6. Suite Bloat: incluye más de 1000 componentes que quizás no necesites

Comparación entre Syncfusion PDFe IronPDF

IronPDF ofrece un enfoque más centrado al ofrecer sus funciones PDF como producto independiente. Esta diferencia afecta significativamente tanto a los costes como a la facilidad de integración.

Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026, la licencia independiente y el enfoque HTML/CSS primerodeIronPDFproporcionan flexibilidad sin dependencias de la suite.

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 Syncfusion packages
dotnet remove package Syncfusion.Pdf.Net.Core
dotnet remove package Syncfusion.HtmlToPdfConverter.Net.Windows
dotnet remove package Syncfusion.Licensing

# Install IronPDF
dotnet add package IronPdf

# Remove Syncfusion packages
dotnet remove package Syncfusion.Pdf.Net.Core
dotnet remove package Syncfusion.HtmlToPdfConverter.Net.Windows
dotnet remove package Syncfusion.Licensing

# Install IronPDF
dotnet add package IronPdf

Configuración de licencias

Fusión de sincronización:

// Must register before any Syncfusion calls
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-SYNCFUSION-KEY");

// Must register before any Syncfusion calls
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-SYNCFUSION-KEY");

IronPDF:

// One-time at startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-KEY";

// One-time at startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-KEY";

Cambios en el espacio de nombres

// Before: Syncfusion PDF
using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;
using Syncfusion.Pdf.Parsing;
using Syncfusion.HtmlConverter;
using Syncfusion.Drawing;

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

// Before: Syncfusion PDF
using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;
using Syncfusion.Pdf.Parsing;
using Syncfusion.HtmlConverter;
using Syncfusion.Drawing;

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

Mapeos de API principales

Syncfusion	IronPDF	Notas
Documento PDF	<código>ChromePdfRenderer</código	Creación de PDF
<código>PdfLoadedDocument</código	<código>PdfDocument.FromFile()</código	Cargar PDF
<código>HtmlToPdfConverter</código	<código>ChromePdfRenderer</código	Conversión de HTML
<código>graphics.DrawString()</código>	Elementos de texto HTML	<código> </código>, <código> </código>
<código>graphics.DrawImage()</código>	<código></código> etiqueta	Imágenes HTML
<código>PdfGrid</código	HTML <código></código>	Tablas
<código>PdfStandardFont</código	CSS family	Fuentes
<código>PdfBrushes.Black</código	CSS color: negro	Colores
documento.Seguridad	<código>pdf.SecuritySettings</código	Seguridad
Extractor de texto pdf	<código>pdf.ExtractAllText()</código	Extracción de texto
<código>ImportPageRange()</código	PdfDocument.Merge()	Fusión
<código>document.Save(stream)</código	<código>pdf.SaveAs(ruta)</código	Guardar
document.Close(true)	No es necesario	Limpieza automática

Ejemplo 1: Conversión de HTML/URL a PDF

Antes (Syncfusion PDF):

// NuGet: Install-Package Syncfusion.Pdf.Net.Core
using Syncfusion.HtmlConverter;
using Syncfusion.Pdf;
using System.IO;

class Program
{
    static void Main()
    {
        // Initialize HTML to PDF converter
        HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();

        // Convert URL to PDF
        PdfDocument document = htmlConverter.Convert("https://www.example.com");

        // Save the document
        FileStream fileStream = new FileStream("Output.pdf", FileMode.Create);
        document.Save(fileStream);
        document.Close(true);
        fileStream.Close();
    }
}

// NuGet: Install-Package Syncfusion.Pdf.Net.Core
using Syncfusion.HtmlConverter;
using Syncfusion.Pdf;
using System.IO;

class Program
{
    static void Main()
    {
        // Initialize HTML to PDF converter
        HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();

        // Convert URL to PDF
        PdfDocument document = htmlConverter.Convert("https://www.example.com");

        // Save the document
        FileStream fileStream = new FileStream("Output.pdf", FileMode.Create);
        document.Save(fileStream);
        document.Close(true);
        fileStream.Close();
    }
}

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        // Create a PDF from a URL
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");

        // Save the PDF
        pdf.SaveAs("Output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        // Create a PDF from a URL
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");

        // Save the PDF
        pdf.SaveAs("Output.pdf");
    }
}

Este ejemplo muestra las diferencias fundamentales entre las API. Syncfusion PDFrequiere una instancia de HtmlToPdfConverter, llamar a Convert() que devuelve un PdfDocument, luego crear manualmente un FileStream, guardar y cerrar tanto el documento como el stream.

IronPDF utiliza un <código>ChromePdfRenderer</códigocon RenderUrlAsPdf() en sólo tres líneas de código. Sin gestión de FileStream, sin llamadas a Close():IronPDFse encarga de la limpieza automáticamente. Consulte la documentación HTML a PDF para ver ejemplos completos.

Ejemplo 2: Creación de PDF a partir de texto

Antes (Syncfusion PDF):

// NuGet: Install-Package Syncfusion.Pdf.Net.Core
using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;
using Syncfusion.Drawing;
using System.IO;

class Program
{
    static void Main()
    {
        // Create a new PDF document
        PdfDocument document = new PdfDocument();

        // Add a page
        PdfPage page = document.Pages.Add();

        // Create a font
        PdfFont font = new PdfStandardFont(PdfFontFamily.Helvetica, 12);

        // Draw text
        page.Graphics.DrawString("Hello, World!", font, PdfBrushes.Black, new PointF(10, 10));

        // Save the document
        FileStream fileStream = new FileStream("Output.pdf", FileMode.Create);
        document.Save(fileStream);
        document.Close(true);
        fileStream.Close();
    }
}

// NuGet: Install-Package Syncfusion.Pdf.Net.Core
using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;
using Syncfusion.Drawing;
using System.IO;

class Program
{
    static void Main()
    {
        // Create a new PDF document
        PdfDocument document = new PdfDocument();

        // Add a page
        PdfPage page = document.Pages.Add();

        // Create a font
        PdfFont font = new PdfStandardFont(PdfFontFamily.Helvetica, 12);

        // Draw text
        page.Graphics.DrawString("Hello, World!", font, PdfBrushes.Black, new PointF(10, 10));

        // Save the document
        FileStream fileStream = new FileStream("Output.pdf", FileMode.Create);
        document.Save(fileStream);
        document.Close(true);
        fileStream.Close();
    }
}

Después (IronPDF):

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

class Program
{
    static void Main()
    {
        // Create a PDF from HTML string
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");

        // Save the document
        pdf.SaveAs("Output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        // Create a PDF from HTML string
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");

        // Save the document
        pdf.SaveAs("Output.pdf");
    }
}

Syncfusion PDF utiliza un modelo gráfico basado en coordenadas. Se crea un PdfDocument, se añade una PdfPage, se crea una PdfFont con PdfFontFamily.Helvetica y, a continuación, se llama a page.Graphics.DrawString() con coordenadas explícitas (new PointF(10, 10)), fuente y pincel (PdfBrushes.Black). Por último, gestiona la creación y eliminación de FileStream.

IronPDF utiliza un enfoque basado en HTML/CSS. Instead of coordinates, you write <h1>Hello, World!</h1> and let CSS handle positioning, fonts, and colors. Este enfoque es más sencillo, más fácil de mantener y aprovecha los conocimientos que ya tienen los desarrolladores. Más información en nuestros tutoriales.

Ejemplo 3: Fusión de documentos PDF

Antes (Syncfusion PDF):

// NuGet: Install-Package Syncfusion.Pdf.Net.Core
using Syncfusion.Pdf;
using Syncfusion.Pdf.Parsing;
using System.IO;

class Program
{
    static void Main()
    {
        // Load the first PDF document
        FileStream stream1 = new FileStream("Document1.pdf", FileMode.Open, FileAccess.Read);
        PdfLoadedDocument loadedDocument1 = new PdfLoadedDocument(stream1);

        // Load the second PDF document
        FileStream stream2 = new FileStream("Document2.pdf", FileMode.Open, FileAccess.Read);
        PdfLoadedDocument loadedDocument2 = new PdfLoadedDocument(stream2);

        // Merge the documents
        PdfDocument finalDocument = new PdfDocument();
        finalDocument.ImportPageRange(loadedDocument1, 0, loadedDocument1.Pages.Count - 1);
        finalDocument.ImportPageRange(loadedDocument2, 0, loadedDocument2.Pages.Count - 1);

        // Save the merged document
        FileStream outputStream = new FileStream("Merged.pdf", FileMode.Create);
        finalDocument.Save(outputStream);

        // Close all documents
        finalDocument.Close(true);
        loadedDocument1.Close(true);
        loadedDocument2.Close(true);
        stream1.Close();
        stream2.Close();
        outputStream.Close();
    }
}

// NuGet: Install-Package Syncfusion.Pdf.Net.Core
using Syncfusion.Pdf;
using Syncfusion.Pdf.Parsing;
using System.IO;

class Program
{
    static void Main()
    {
        // Load the first PDF document
        FileStream stream1 = new FileStream("Document1.pdf", FileMode.Open, FileAccess.Read);
        PdfLoadedDocument loadedDocument1 = new PdfLoadedDocument(stream1);

        // Load the second PDF document
        FileStream stream2 = new FileStream("Document2.pdf", FileMode.Open, FileAccess.Read);
        PdfLoadedDocument loadedDocument2 = new PdfLoadedDocument(stream2);

        // Merge the documents
        PdfDocument finalDocument = new PdfDocument();
        finalDocument.ImportPageRange(loadedDocument1, 0, loadedDocument1.Pages.Count - 1);
        finalDocument.ImportPageRange(loadedDocument2, 0, loadedDocument2.Pages.Count - 1);

        // Save the merged document
        FileStream outputStream = new FileStream("Merged.pdf", FileMode.Create);
        finalDocument.Save(outputStream);

        // Close all documents
        finalDocument.Close(true);
        loadedDocument1.Close(true);
        loadedDocument2.Close(true);
        stream1.Close();
        stream2.Close();
        outputStream.Close();
    }
}

Después (IronPDF):

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

class Program
{
    static void Main()
    {
        // Load PDF documents
        var pdf1 = PdfDocument.FromFile("Document1.pdf");
        var pdf2 = PdfDocument.FromFile("Document2.pdf");

        // Merge PDFs
        var merged = PdfDocument.Merge(new List<PdfDocument> { pdf1, pdf2 });

        // Save the merged document
        merged.SaveAs("Merged.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        // Load PDF documents
        var pdf1 = PdfDocument.FromFile("Document1.pdf");
        var pdf2 = PdfDocument.FromFile("Document2.pdf");

        // Merge PDFs
        var merged = PdfDocument.Merge(new List<PdfDocument> { pdf1, pdf2 });

        // Save the merged document
        merged.SaveAs("Merged.pdf");
    }
}

El contraste en la fusión de PDF es espectacular. Syncfusion PDFrequiere crear objetos FileStream para cada documento de entrada, cargarlos como PdfLoadedDocument, crear un nuevo PdfDocument, llamar a <código>ImportPageRange()</códigocon índices de inicio y fin para cada fuente, creando un FileStream de salida, y luego cerrando seis objetos separados (finalDocument, loadedDocument1, loadedDocument2, stream1, stream2, outputStream).

IronPDF utiliza <código>PdfDocument.FromFile()</códigopara cargar cada PDF y un método estático PdfDocument.Merge()que acepta una lista de documentos. Sin gestión de flujos, sin cálculos manuales de rango de páginas, sin aproximaciones.

Basado en coordenadas frente a HTML/CSS primero

Syncfusion PDF utiliza un modelo gráfico basado en coordenadas heredado de las bibliotecas PDF tradicionales:

// Syncfusion: Manualpositioning
page.Graphics.DrawString("Text", font, PdfBrushes.Black, new PointF(100, 200));
page.Graphics.DrawRectangle(brush, new RectangleF(50, 50, 200, 100));

// Syncfusion: Manualpositioning
page.Graphics.DrawString("Text", font, PdfBrushes.Black, new PointF(100, 200));
page.Graphics.DrawRectangle(brush, new RectangleF(50, 50, 200, 100));

IronPDF utiliza HTML/CSS para la maquetación:

// IronPDF: CSS-based positioning
var html = @"
<div style='margin: 50px; padding: 20px; border: 1px solid black;'>
    <p style='color: black;'>Text</p>
</div>";
var pdf = renderer.RenderHtmlAsPdf(html);

// IronPDF: CSS-based positioning
var html = @"
<div style='margin: 50px; padding: 20px; border: 1px solid black;'>
    <p style='color: black;'>Text</p>
</div>";
var pdf = renderer.RenderHtmlAsPdf(html);

El enfoque HTML/CSS es más intuitivo para los desarrolladores web, más fácil de mantener y produce resultados coherentes en diferentes tamaños de página.

Gestión de flujos frente a limpieza automática

Syncfusion PDF requiere un flujo explícito y la eliminación de documentos:

// Syncfusion: Manualcleanup
FileStream fileStream = new FileStream("Output.pdf", FileMode.Create);
document.Save(fileStream);
document.Close(true);
fileStream.Close();

// Syncfusion: Manualcleanup
FileStream fileStream = new FileStream("Output.pdf", FileMode.Create);
document.Save(fileStream);
document.Close(true);
fileStream.Close();

IronPDF se encarga de la limpieza automáticamente:

// IronPDF: Automáticocleanup
pdf.SaveAs("Output.pdf");

// IronPDF: Automáticocleanup
pdf.SaveAs("Output.pdf");

Pre-Migración

• Inventariar todos los usos de PDF de Syncfusion en el código base
• Documentar los costos de licencia y los requisitos de implementación
• Identificar los usos de <código>PdfGrid</código, PdfGraphics y HtmlToPdfConverter
• Obtenga la clave de licencia deIronPDFen ironpdf.com

Actualizaciones de código

• Eliminar paquetes de Syncfusion ( Syncfusion.Pdf.Net.Core , Syncfusion.HtmlToPdfConverter.Net.Windows , Syncfusion.Licensing )
• Instalar el paquete NuGet IronPdf
• Actualizar las importaciones de espacios de nombres ( using Syncfusion.Pdf; → using IronPdf; )
• Reemplace Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense() con IronPdf.License.LicenseKey = "..."
• Reemplace HtmlToPdfConverter.Convert() con ChromePdfRenderer.RenderUrlAsPdf() o RenderHtmlAsPdf()
• Reemplace Documento PDF+ Pages.Add() + Graphics.DrawString() con ChromePdfRenderer.RenderHtmlAsPdf()
• Reemplace <código>PdfLoadedDocument</códigocon PdfDocument.FromFile()
• Reemplace <código>ImportPageRange()</códigocon PdfDocument.Merge()
• Reemplace <código>document.Save(stream)</códigocon pdf.SaveAs(path)
• Eliminar todas las llamadas document.Close(true)y stream.Close()
• Reemplazar <código>PdfGrid</códigocon HTML<table> elementos
• Reemplace <código>PdfStandardFont</códigocon font-family CSS
• Reemplazar PdfBrushes con propiedades color CSS

Pruebas

• Comparación visual de la salida PDF
• Verificar las mejoras de representación CSS (flexbox y grid ahora funcionan)
• Prueba de extracción de texto
• Prueba de fusión y división
• Comparación de rendimiento