La migración de QuestPDF a IronPDF transforma su flujo de trabajo de generación de PDF de una API propietaria fluida de C# a un enfoque estándar basado en HTML/CSS con amplias capacidades de manipulación de PDF. Esta guía proporciona una ruta de migración completa, paso a paso, que le permite aprovechar las habilidades web existentes, reutilizar plantillas HTML y obtener características que QuestPDF simplemente no puede proporcionar.
QuestPDF es una API moderna y fluida creada específicamente para generar PDF mediante programación en C#. A diferencia de algunos de sus homólogos que ofrecen una amplia capacidad de conversión de HTML a PDF, QuestPDF se limita a las funcionalidades programáticas de la API de diseño. QuestPDF destaca en situaciones en las que los desarrolladores necesitan generar documentos desde cero utilizando código C#, sin depender de HTML.
La biblioteca es gratuita para las empresas con ingresos inferiores a 1 millón de dólares, pero se exige demostrar este nivel de ingresos, lo que podría suponer una carga de cumplimiento para algunas. Los usuarios que superen este umbral deberán adquirir una licencia, lo que debe tenerse en cuenta en la planificación a largo plazo al evaluar QuestPDF como posible solución.
A menudo se recomienda QuestPDF para la conversión de HTML a PDF, pero no admite HTML en absoluto. A pesar de estar muy promocionado en los foros de desarrolladores, QuestPDF utiliza su propio lenguaje de maquetación que requiere aprender un DSL completamente nuevo en lugar de aprovechar los conocimientos web existentes.
| Característica | QuestPDF | IronPDF |
|---|---|---|
| HTML a PDF | NO SE APOYA | Se admite |
| Estilización CSS | NO SE APOYA | CSS3 completo |
| Plantillas existentes | Debe reconstruirse desde cero | Reutilización de activos HTML/CSS |
| Compatibilidad con herramientas de diseño | Ninguno | Cualquier herramienta de diseño web |
| Curva de aprendizaje | Nuevo DSL propietario | Transferencia de conocimientos web |
| Vista previa del diseño | Requiere plugin IDE | Vista previa en cualquier navegador |
| Manipulación de PDF | Ninguno | Fusión, división, edición |
IronPDF proporciona un renderizado nativo de HTML a PDF del que QuestPDF carece por completo, eliminando la necesidad de reconstruir manualmente los documentos en código C#. Incluye funciones completas de manipulación de PDF (combinar, dividir, editar, proteger) que QuestPDF no puede realizar.
La "Licencia Comunitaria" de QuestPDF sólo es gratuita si su empresa tiene menos de 1 millón de dólares de ingresos brutos anuales. Es posible que sus clientes (no solo usted como desarrollador) tengan que adquirir licencias si superan los umbrales de ingresos. A diferencia de una simple licencia comercial por desarrollador, el modelo de QuestPDF requiere la divulgación de los ingresos y el seguimiento del cumplimiento.
IronPDF ofrece licencias sencillas: una licencia por desarrollador, sin auditorías de ingresos, sin requisitos de licencia del cliente y con costes claros y predecibles.
Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDF ofrece licencias transparentes sin auditorías basadas en ingresos y un enfoque HTML/CSS estándar que aprovecha las habilidades de desarrollo web existentes.
# Remove QuestPDF
dotnet remove package QuestPDF
# Add IronPDF
dotnet add package IronPdf// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";' Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"# Find all QuestPDF usages in your codebase
grep -r "QuestPDF\|Document.Create\|\.GeneratePdf" --include="*.cs" .// Before: QuestPDF
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;
// After: IronPDF
using IronPdf;Imports IronPdf| Concepto de QuestPDF | Equivalente de IronPDF |
|---|---|
Document.Create() | new ChromePdfRenderer() |
.Page() | RenderHtmlAsPdf() |
.Text() | HTML <p>, <h1>, <span> |
.Bold() | CSS font-weight: bold |
.FontSize(24) | CSS font-size: 24px |
.Image() | HTML <img src="..."> |
.Table() | HTML <table> |
.Column() | CSS display:flex; flex-direction: column |
.Row() | CSS display:flex; flex-direction: row |
PageSizes.A4 | RenderingOptions.PaperSize |
.Margin() | RenderingOptions.Margin* |
.GeneratePdf() | pdf.SaveAs() |
| N/A | PdfDocument.Merge() |
| N/A | PdfDocument.FromFile() |
| N/A | pdf.SecuritySettings |
Antes (QuestPDF):
// NuGet: Install-Package QuestPDF
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;
class Program
{
static void Main()
{
QuestPDF.Settings.License = LicenseType.Community;
Document.Create(container =>
{
container.Page(page =>
{
page.Size(PageSizes.A4);
page.Margin(2, Unit.Centimetre);
page.Content().Column(column =>
{
column.Item().Text("Hello World").FontSize(20).Bold();
column.Item().Text("This is a paragraph of text.");
});
});
}).GeneratePdf("output.pdf");
}
}' NuGet: Install-Package QuestPDF
Imports QuestPDF.Fluent
Imports QuestPDF.Helpers
Imports QuestPDF.Infrastructure
Class Program
Shared Sub Main()
QuestPDF.Settings.License = LicenseType.Community
Document.Create(Sub(container)
container.Page(Sub(page)
page.Size(PageSizes.A4)
page.Margin(2, Unit.Centimetre)
page.Content().Column(Sub(column)
column.Item().Text("Hello World").FontSize(20).Bold()
column.Item().Text("This is a paragraph of text.")
End Sub)
End Sub)
End Sub).GeneratePdf("output.pdf")
End Sub
End ClassDespué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 paragraph of text.</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 paragraph of text.</p>")
pdf.SaveAs("output.pdf")
End Sub
End ClassEste ejemplo demuestra la diferencia fundamental de paradigma. QuestPDF requiere aprender su API fluida: Document.Create(), container.Page(), page.Content().Column(), column.Item().Text(), con estilo a través de encadenamiento de métodos como .FontSize(20).Bold(). También debe configurar el tipo de licencia con QuestPDF.Settings.License = LicenseType.Community.
IronPDF usa HTML estándar que cualquier desarrollador web conoce: <h1> para encabezados, <p> para párrafos. No es necesario aprender DSL propietario. El enfoque de IronPDFofrece 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.
Antes (QuestPDF):
// NuGet: Install-Package QuestPDF
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;
class Program
{
static void Main()
{
QuestPDF.Settings.License = LicenseType.Community;
Document.Create(container =>
{
container.Page(page =>
{
page.Size(PageSizes.A4);
page.Margin(2, Unit.Centimetre);
page.Content().Column(column =>
{
column.Item().Text("INVOICE").FontSize(24).Bold();
column.Item().Text("Invoice #: 12345").FontSize(12);
column.Item().PaddingTop(20);
column.Item().Text("Customer: John Doe");
column.Item().Text("Total: $100.00").Bold();
});
});
}).GeneratePdf("invoice.pdf");
}
}' NuGet: Install-Package QuestPDF
Imports QuestPDF.Fluent
Imports QuestPDF.Helpers
Imports QuestPDF.Infrastructure
Module Program
Sub Main()
QuestPDF.Settings.License = LicenseType.Community
Document.Create(Sub(container)
container.Page(Sub(page)
page.Size(PageSizes.A4)
page.Margin(2, Unit.Centimetre)
page.Content().Column(Sub(column)
column.Item().Text("INVOICE").FontSize(24).Bold()
column.Item().Text("Invoice #: 12345").FontSize(12)
column.Item().PaddingTop(20)
column.Item().Text("Customer: John Doe")
column.Item().Text("Total: $100.00").Bold()
End Sub)
End Sub)
End Sub).GeneratePdf("invoice.pdf")
End Sub
End ModuleDespués (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var htmlContent = @"
<h1>INVOICE</h1>
<p>Invoice #: 12345</p>
<br/>
<p>Customer: John Doe</p>
<p><strong>Total: $100.00</strong></p>
";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice.pdf");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Class Program
Shared Sub Main()
Dim htmlContent As String = "
<h1>INVOICE</h1>
<p>Invoice #: 12345</p>
<br/>
<p>Customer: John Doe</p>
<p><strong>Total: $100.00</strong></p>
"
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("invoice.pdf")
End Sub
End ClassQuestPDF utiliza .Column() y .Item() para el diseño, con .PaddingTop(20) para el espaciado.IronPDF utiliza HTML estándar: <h1> para el título, <p> para los párrafos, <br/> para el espaciado y <strong> para el texto en negrita.
La ventaja real: con IronPDF, los diseñadores pueden crear y modificar plantillas HTML de forma independiente. Con QuestPDF, cada cambio de diseño requiere que un desarrollador de C# modifique el código. Más información en nuestros tutoriales.
Antes (QuestPDF):
// NuGet: Install-Package QuestPDF
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;
class Program
{
static void Main()
{
QuestPDF.Settings.License = LicenseType.Community;
Document.Create(container =>
{
container.Page(page =>
{
page.Size(PageSizes.A4);
page.Margin(2, Unit.Centimetre);
page.Header().Text("Document Header").FontSize(14).Bold();
page.Content().Text("Main content of the document.");
page.Footer().AlignCenter().Text(text =>
{
text.Span("Page ");
text.CurrentPageNumber();
});
});
}).GeneratePdf("document.pdf");
}
}' NuGet: Install-Package QuestPDF
Imports QuestPDF.Fluent
Imports QuestPDF.Helpers
Imports QuestPDF.Infrastructure
Class Program
Shared Sub Main()
QuestPDF.Settings.License = LicenseType.Community
Document.Create(Sub(container)
container.Page(Sub(page)
page.Size(PageSizes.A4)
page.Margin(2, Unit.Centimetre)
page.Header().Text("Document Header").FontSize(14).Bold()
page.Content().Text("Main content of the document.")
page.Footer().AlignCenter().Text(Sub(text)
text.Span("Page ")
text.CurrentPageNumber()
End Sub)
End Sub)
End Sub).GeneratePdf("document.pdf")
End Sub
End ClassDespués (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var htmlContent = "<p>Main content of the document.</p>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.Header = new TextHeaderFooter()
{
CenterText = "Document Header",
FontSize = 14
};
pdf.Footer = new TextHeaderFooter()
{
CenterText = "Page {page}"
};
pdf.SaveAs("document.pdf");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Class Program
Shared Sub Main()
Dim htmlContent As String = "<p>Main content of the document.</p>"
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.Header = New TextHeaderFooter() With {
.CenterText = "Document Header",
.FontSize = 14
}
pdf.Footer = New TextHeaderFooter() With {
.CenterText = "Page {page}"
}
pdf.SaveAs("document.pdf")
End Sub
End ClassQuestPDF utiliza page.Header() y page.Footer() con métodos fluidos como .AlignCenter() y .CurrentPageNumber().IronPDF utiliza objetos TextHeaderFooter con propiedades como CenterText y FontSize. El marcador de posición {page} inserta automáticamente el número de página actual.
El cambio fundamental consiste en pasar de un DSL de C# propietario a HTML/CSS estándar:
// QuestPDF: Proprietary fluent API
container.Page(page =>
{
page.Content().Column(column =>
{
column.Item().Text("Invoice").Bold().FontSize(24);
column.Item().Row(row =>
{
row.RelativeItem().Text("Customer:");
row.RelativeItem().Text("Acme Corp");
});
});
});
// IronPDF: Standard HTML/CSS
var html = @"
<div style='font-family: Arial; padding: 40px;'>
<h1 style='font-weight: bold; font-size: 24px;'>Invoice</h1>
<div style='display: flex; justify-content: space-between;'>
<span>Customer:</span>
<span>Acme Corp</span>
</div>
</div>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);' QuestPDF: Proprietary fluent API
container.Page(Sub(page)
page.Content().Column(Sub(column)
column.Item().Text("Invoice").Bold().FontSize(24)
column.Item().Row(Sub(row)
row.RelativeItem().Text("Customer:")
row.RelativeItem().Text("Acme Corp")
End Sub)
End Sub)
End Sub)
' IronPDF: Standard HTML/CSS
Dim html As String = "
<div style='font-family: Arial; padding: 40px;'>
<h1 style='font-weight: bold; font-size: 24px;'>Invoice</h1>
<div style='display: flex; justify-content: space-between;'>
<span>Customer:</span>
<span>Acme Corp</span>
</div>
</div>"
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)| Patrón QuestPDF | Equivalente HTML/CSS |
|---|---|
.Column() | display: flex; flex-direction: column |
.Row() | display: flex; flex-direction: row |
.RelativeItem() | flex: 1 |
.Table() | <table> elemento |
.PaddingTop(20) | padding-top: 20px o <br/> |
.AlignCenter() | text-align: center |
.FontSize(24) | font-size: 24px |
.Bold() | font-weight: bold o <strong> |
// QuestPDF
page.Size(PageSizes.A4);
page.Margin(2, Unit.Centimetre);
// IronPDF
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20; // mm (2cm = 20mm)
renderer.RenderingOptions.MarginBottom = 20;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;' QuestPDF
page.Size(PageSizes.A4)
page.Margin(2, Unit.Centimetre)
' IronPDF
Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20 ' mm (2cm = 20mm)
renderer.RenderingOptions.MarginBottom = 20
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20Tras migrar a IronPDF, obtendrá funciones que QuestPDF no puede proporcionarle:
var cover = renderer.RenderHtmlAsPdf("<h1>Cover</h1>");
var content = renderer.RenderHtmlAsPdf(reportHtml);
var existing = PdfDocument.FromFile("appendix.pdf");
var merged = PdfDocument.Merge(cover, content, existing);
merged.SaveAs("complete.pdf");Dim cover = renderer.RenderHtmlAsPdf("<h1>Cover</h1>")
Dim content = renderer.RenderHtmlAsPdf(reportHtml)
Dim existing = PdfDocument.FromFile("appendix.pdf")
Dim merged = PdfDocument.Merge(cover, content, existing)
merged.SaveAs("complete.pdf")var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.OwnerPassword = "admin";
pdf.SecuritySettings.UserPassword = "reader";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SaveAs("protected.pdf");Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SecuritySettings.OwnerPassword = "admin"
pdf.SecuritySettings.UserPassword = "reader"
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
pdf.SaveAs("protected.pdf")var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
var pdf = renderer.RenderUrlAsPdf("https://example.com/report");
pdf.SaveAs("webpage.pdf");Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
Dim pdf = renderer.RenderUrlAsPdf("https://example.com/report")
pdf.SaveAs("webpage.pdf")var pdf = PdfDocument.FromFile("existing.pdf");
// Modify, merge, add security, etc.
pdf.SaveAs("modified.pdf");Dim pdf = PdfDocument.FromFile("existing.pdf")
' Modify, merge, add security, etc.
pdf.SaveAs("modified.pdf")| Característica | QuestPDF | IronPDF |
|---|---|---|
| HTML a PDF | No soportado | Característica principal |
| Curva de aprendizaje | DSL propietario | Conocimientos web estándar |
| Vista previa de la plantilla | Plugin necesario | Cualquier navegador |
| Colaboración en el diseño | Sólo desarrolladores | Diseñadores + Desarrolladores |
| Activos existentes | Debe reconstruir | Reutilizar HTML/CSS |
| Manipulación de PDF | No soportado | Se admite |
| Seguridad/Firma | No soportado | Se admite |
| Modelo de licencia | Basado en los ingresos | Por desarrollador |
| Impacto en el cliente | Puede necesitar licencias | Ninguno |
| Bootstrap/Tailwind | No soportado | Se admite |
| URL a PDF | No soportado | Se admite |
Document.Create, .GeneratePdf).Column(), .Row(), .Table(), .Text())QuestPDFIronPdf el paquete NuGet : dotnet add package IronPdfQuestPDF.Settings.License = LicenseType.CommunityDocument.Create() a ChromePdfRenderer + HTML.Column() / .Row() con CSS Flexbox.Table() con elementos HTML <table>.Text().Bold().FontSize(24) a <h1 style='...'>page.Header() / page.Footer() con TextHeaderFooter.CurrentPageNumber() con el marcador de posición {page}.GeneratePdf() a pdf.SaveAs()
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 estructurados y visualmente atractivos.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
