La migración de jsreporta IronPDF transforma su flujo de trabajo PDF .NET de un sistema dependiente de Node.js con gestión binaria externa y procesos de servidor independientes a una biblioteca .NET pura que se ejecuta completamente en el proceso. Esta guía proporciona una ruta de migración completa y paso a paso que elimina la complejidad de la infraestructura y los requisitos de plantillas de JavaScript para desarrolladores .NET profesionales.
jsreport introduce una complejidad que no tiene cabida en un entorno .NET puro:
Dependencia de Node.js : requiere el entorno de ejecución y los binarios de Node.js , lo que agrega complejidad de infraestructura a lo que debería ser una aplicación .NET sencilla.
Administración binaria externa: debe descargar y administrar binarios específicos de la plataforma para Windows, Linux y OSX a través de paquetes NuGet separados (jsreport.Binary, jsreport.Binary.Linux, jsreport.Binary.OSX).
Proceso de servidor independiente: se ejecuta como una utilidad o un servidor web (se requiere administración de procesos adicional con los métodos de ciclo de vida StartAsync() y KillAsync()).
Plantillas de JavaScript : obliga a aprender Handlebars, JsRender u otros sistemas de plantillas de JavaScript en lugar de utilizar las capacidades nativas de C#.
Estructura de solicitud compleja: requiere objetos RenderRequest detallados con configuraciones Template anidadas incluso para la generación de PDF simple.
Limitaciones de licencia: el nivel gratuito limita la cantidad de plantillas; el escalado requiere licencia comercial.
Salida basada en secuencias: devuelve secuencias que requieren operaciones manuales de archivos y gestión de secuencias de memoria.
| Característica | jsreport | IronPDF |
|---|---|---|
| Tiempo de ejecución | Node.js + .NET | .NET puro |
| Gestión binaria | Manual (paquetes jsreport.Binary) | Automático |
| Proceso de servidor | Requerido (utilidad o servidor web) | En proceso |
| Plantillas | JavaScript (Handlebars, etc.) | C# (Razor, interpolación de cadenas) |
| Estilo API | Objetos de solicitud verbosos | Métodos limpios y fluidos |
| Salida | Enviar a | Objeto PdfDocument |
| Manipulación de PDF | Limitado | Extensivo (combinar, dividir, editar) |
| Soporte de Async | Sólo asíncrono | Tanto sync como async |
Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDF proporciona una base preparada para el futuro como biblioteca nativa de .NET sin dependencias de tiempo de ejecución externas.
| Característica | Complejidad de la migración |
|---|---|
| HTML a PDF | Muy bajo |
| URL a PDF | Muy bajo |
| Encabezados/pies de página | Bajo |
| Configuración de la página | Bajo |
| Ciclo de vida del servidor | Bajo |
| Gestión binaria | Bajo |
El cambio fundamental en esta migración de jsreportes de objetos de solicitud detallados con administración del servidor a simples llamadas a métodos en proceso:
jsreport: LocalReporting().UseBinary().AsUtility().Create() → RenderAsync(RenderRequest) → Transmisión → Archivo
IronPDF: ChromePdfRenderer → RenderHtmlAsPdf(html) → Guardar como()# Remove jsreportpackages
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSX
dotnet remove package jsreport.Local
dotnet remove package jsreport.Types
dotnet remove package jsreport.Client
# Install IronPDF
dotnet add package IronPdf// 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"# Find all jsreportreferences
grep -r "using jsreport\|LocalReporting\|RenderRequest\|RenderAsync" --include="*.cs" .
grep -r "JsReportBinary\|Template\|Recipe\|Engine\." --include="*.cs" .| clase jsreport | Equivalente de IronPDF |
|---|---|
LocalReporting | ChromePdfRenderer |
ReportingService | ChromePdfRenderer |
RenderRequest | Parámetros del método |
Template | Parámetros del método |
Chrome | RenderingOptions |
Report | PdfDocument |
Engine | (no es necesario) |
| método jsreport | Equivalente de IronPDF |
|---|---|
LocalReporting().UseBinary().AsUtility().Create() | new ChromePdfRenderer() |
rs.RenderAsync(request) | renderer.RenderHtmlAsPdf(html) |
rs.StartAsync() | (no es necesario) |
rs.KillAsync() | (no es necesario) |
report.Content.CopyTo(stream) | pdf.SaveAs(path) o pdf.BinaryData |
| propiedad de la plantilla jsreport | Equivalente de IronPDF |
|---|---|
Template.Content | Primer parámetro de RenderHtmlAsPdf() |
Template.Recipe = Recipe.ChromePdf | (no es necesario) |
Template.Engine = Engine.None | (no es necesario) |
Chrome.HeaderTemplate | RenderingOptions.TextHeader o HtmlHeader |
Chrome.FooterTemplate | RenderingOptions.TextFooter o HtmlFooter |
Chrome.DisplayHeaderFooter | (automático)_ |
Chrome.MarginTop | RenderingOptions.MarginTop |
| jsreportMarcador de posición | Marcador de posición IronPDF |
|---|---|
<span class='pageNumber'></span> | {page} |
<span class='totalPages'></span> | {total-pages} |
{#pageNum} | {page} |
{#numPages} | {total-pages} |
{#timestamp} | {date} |
Antes (jsreport):
// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var rs = new LocalReporting()
.UseBinary(JsReportBinary.GetBinary())
.AsUtility()
.Create();
var report = await rs.RenderAsync(new RenderRequest()
{
Template = new Template()
{
Recipe = Recipe.ChromePdf,
Engine = Engine.None,
Content = "<h1>Hello from jsreport</h1><p>This is a PDF document.</p>"
}
});
using (var fileStream = File.Create("output.pdf"))
{
report.Content.CopyTo(fileStream);
}
Console.WriteLine("PDF created successfully!");
}
}Imports jsreport.Binary
Imports jsreport.Local
Imports jsreport.Types
Imports System
Imports System.IO
Imports System.Threading.Tasks
Module Program
Async Function Main(args As String()) As Task
Dim rs = (New LocalReporting()) _
.UseBinary(JsReportBinary.GetBinary()) _
.AsUtility() _
.Create()
Dim report = Await rs.RenderAsync(New RenderRequest() With {
.Template = New Template() With {
.Recipe = Recipe.ChromePdf,
.Engine = Engine.None,
.Content = "<h1>Hello from jsreport</h1><p>This is a PDF document.</p>"
}
})
Using fileStream = File.Create("output.pdf")
report.Content.CopyTo(fileStream)
End Using
Console.WriteLine("PDF created successfully!")
End Function
End ModuleDespués (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF</h1><p>This is a PDF document.</p>");
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF created successfully!");
}
}Imports IronPdf
Imports System
Class Program
Shared Sub Main(args As String())
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF</h1><p>This is a PDF document.</p>")
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF created successfully!")
End Sub
End ClassEl enfoque jsreportrequiere tres paquetes NuGet (jsreport.Binary, jsreport.Local, jsreport.Types), tres importaciones de espacios de nombres, ejecución solo asíncrona, una cadena de generador fluida (LocalReporting().UseBinary().AsUtility().Create()), un RenderRequest detallado con un objeto Template anidado que especifica Recipe y Engine, y copia manual de flujo a archivo con un bloque using.
IronPDF reduce todo esto a un paquete NuGet, un espacio de nombres, tres líneas de código y ejecución sincrónica. El método ChromePdfRenderer.RenderHtmlAsPdf() acepta HTML directamente y devuelve un PdfDocument con un método simple SaveAs(). Consulte la documentación HTML a PDF para obtener más opciones de conversión.
Antes (jsreport):
// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var rs = new LocalReporting()
.UseBinary(JsReportBinary.GetBinary())
.AsUtility()
.Create();
var report = await rs.RenderAsync(new RenderRequest()
{
Template = new Template()
{
Recipe = Recipe.ChromePdf,
Engine = Engine.None,
Content = "<html><body><script>window.location='https://example.com';</script></body></html>"
}
});
using (var fileStream = File.Create("webpage.pdf"))
{
report.Content.CopyTo(fileStream);
}
Console.WriteLine("Webpage PDF created successfully!");
}
}Imports jsreport.Binary
Imports jsreport.Local
Imports jsreport.Types
Imports System
Imports System.IO
Imports System.Threading.Tasks
Module Program
Async Function Main(args As String()) As Task
Dim rs = (New LocalReporting()) _
.UseBinary(JsReportBinary.GetBinary()) _
.AsUtility() _
.Create()
Dim report = Await rs.RenderAsync(New RenderRequest() With {
.Template = New Template() With {
.Recipe = Recipe.ChromePdf,
.Engine = Engine.None,
.Content = "<html><body><script>window.location='https://example.com';</script></body></html>"
}
})
Using fileStream = File.Create("webpage.pdf")
report.Content.CopyTo(fileStream)
End Using
Console.WriteLine("Webpage PDF created successfully!")
End Function
End ModuleDespués (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
Console.WriteLine("Webpage PDF created successfully!");
}
}Imports IronPdf
Imports System
Class Program
Shared Sub Main(ByVal args As String())
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("webpage.pdf")
Console.WriteLine("Webpage PDF created successfully!")
End Sub
End ClassEste ejemplo pone de manifiesto una importante limitación de jsreport: no existe un método directo de URL a PDF. El código jsreportdebe usar una solución alternativa de redirección de JavaScript (window.location='https://example.com') incrustada en el contenido HTML para capturar una página web. Este enfoque indirecto puede fallar con determinados sitios web y añade una complejidad innecesaria.
IronPDF proporciona un método dedicado RenderUrlAsPdf() que procesa directamente cualquier URL con ejecución completa de JavaScript y soporte CSS moderno. No hay soluciones, no hay scripts incrustados, sólo hay que pasar la URL. Más información sobre Conversión de URL a PDF.
Antes (jsreport):
// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var rs = new LocalReporting()
.UseBinary(JsReportBinary.GetBinary())
.AsUtility()
.Create();
var report = await rs.RenderAsync(new RenderRequest()
{
Template = new Template()
{
Recipe = Recipe.ChromePdf,
Engine = Engine.None,
Content = "<h1>Document with Header and Footer</h1><p>Main content goes here.</p>",
Chrome = new Chrome()
{
DisplayHeaderFooter = true,
HeaderTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Custom Header</div>",
FooterTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Page <span class='pageNumber'></span> of <span class='totalPages'></span></div>"
}
}
});
using (var fileStream = File.Create("document_with_headers.pdf"))
{
report.Content.CopyTo(fileStream);
}
Console.WriteLine("PDF with headers and footers created successfully!");
}
}Imports jsreport.Binary
Imports jsreport.Local
Imports jsreport.Types
Imports System
Imports System.IO
Imports System.Threading.Tasks
Module Program
Async Function Main(args As String()) As Task
Dim rs = New LocalReporting() _
.UseBinary(JsReportBinary.GetBinary()) _
.AsUtility() _
.Create()
Dim report = Await rs.RenderAsync(New RenderRequest() With {
.Template = New Template() With {
.Recipe = Recipe.ChromePdf,
.Engine = Engine.None,
.Content = "<h1>Document with Header and Footer</h1><p>Main content goes here.</p>",
.Chrome = New Chrome() With {
.DisplayHeaderFooter = True,
.HeaderTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Custom Header</div>",
.FooterTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Page <span class='pageNumber'></span> of <span class='totalPages'></span></div>"
}
}
})
Using fileStream = File.Create("document_with_headers.pdf")
report.Content.CopyTo(fileStream)
End Using
Console.WriteLine("PDF with headers and footers created successfully!")
End Function
End ModuleDespués (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
CenterText = "Custom Header",
FontSize = 10
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
{
CenterText = "Page {page} of {total-pages}",
FontSize = 10
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Header and Footer</h1><p>Main content goes here.</p>");
pdf.SaveAs("document_with_headers.pdf");
Console.WriteLine("PDF with headers and footers created successfully!");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering
Imports System
Module Program
Sub Main(args As String())
Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter() With {
.CenterText = "Custom Header",
.FontSize = 10
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter() With {
.CenterText = "Page {page} of {total-pages}",
.FontSize = 10
}
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Document with Header and Footer</h1><p>Main content goes here.</p>")
pdf.SaveAs("document_with_headers.pdf")
Console.WriteLine("PDF with headers and footers created successfully!")
End Sub
End ModuleEl enfoque jsreportrequiere agregar un objeto Chrome al Template, configurar DisplayHeaderFooter = true y usar plantillas HTML con marcadores de posición de clase CSS especiales (<span class='pageNumber'></span>, <span class='totalPages'></span>). Las plantillas de encabezado y pie de página deben incluir un estilo en línea completo.
IronPDF proporciona una configuración más limpia TextHeaderFooter con propiedades dedicadas para CenterText, LeftText, RightText y FontSize. Los marcadores de posición de número de página utilizan la sintaxis más simple {page} y {total-pages}. Consulte la documentación sobre encabezados y pies de página para conocer las opciones de encabezado HTML.
jsreport requiere una gestión explícita del ciclo de vida del servidor:
// jsreport(DELETE THIS):
var rs = new LocalReporting()
.UseBinary(JsReportBinary.GetBinary())
.AsUtility()
.Create();
// Or for web server mode:
var rs = new LocalReporting()
.UseBinary(JsReportBinary.GetBinary())
.AsWebServer()
.Create();
await rs.StartAsync();
// ... use rs ...
await rs.KillAsync();' jsreport(DELETE THIS):
Dim rs = New LocalReporting() _
.UseBinary(JsReportBinary.GetBinary()) _
.AsUtility() _
.Create()
' Or for web server mode:
rs = New LocalReporting() _
.UseBinary(JsReportBinary.GetBinary()) _
.AsWebServer() _
.Create()
Await rs.StartAsync()
' ... use rs ...
Await rs.KillAsync()IronPDF se ejecuta completamente en proceso: sin inicio de servidor, sin gestión de procesos, sin limpieza:
// IronPDF:
var renderer = new ChromePdfRenderer();
// Just use it—no lifecycle management needednetjsreport requiere paquetes NuGet independientes para cada plataforma de destino:
# DELETE these platform-specific packages:
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSXIronPDF gestiona automáticamente todos los requisitos de la plataforma a través de un único paquete NuGet.
jsreport utiliza marcadores de posición CSS basados en clases o llaves.IronPDF utiliza una sintaxis diferente:
// jsreportplaceholders:
"<span class='pageNumber'></span>" // or {#pageNum}
"<span class='totalPages'></span>" // or {#numPages}
//IronPDFplaceholders:
"{page}"
"{total-pages}"
"{date}"
"{html-title}"' jsreportplaceholders:
"<span class='pageNumber'></span>" ' or {#pageNum}
"<span class='totalPages'></span>" ' or {#numPages}
' IronPDFplaceholders:
"{page}"
"{total-pages}"
"{date}"
"{html-title}"jsreport a menudo utiliza plantillas Handlebars con Engine.Handlebars:
// jsreportHandlebars (DELETE THIS):
Template = new Template
{
Content = "<h1>Hello, {{name}}</h1>",
Engine = Engine.Handlebars
},
Data = new { name = "World" }
//IronPDFwith C# string interpolation:
string name = "World";
string html = $"<h1>Hello, {name}</h1>";
var pdf = renderer.RenderHtmlAsPdf(html);Imports IronPdf
' jsreportHandlebars (DELETE THIS):
Dim Template As New Template With {
.Content = "<h1>Hello, {{name}}</h1>",
.Engine = Engine.Handlebars
}
Dim Data = New With {.name = "World"}
' IronPDF with VB.NET string interpolation:
Dim name As String = "World"
Dim html As String = $"<h1>Hello, {name}</h1>"
Dim pdf = renderer.RenderHtmlAsPdf(html)jsreport devuelve un flujo que requiere copia manual:
// jsreportstream handling (DELETE THIS):
using (var fileStream = File.Create("output.pdf"))
{
report.Content.CopyTo(fileStream);
}
// Or for byte array:
using (var memoryStream = new MemoryStream())
{
await report.Content.CopyToAsync(memoryStream);
return memoryStream.ToArray();
}
//IronPDFdirect access:
pdf.SaveAs("output.pdf");
// Or:
byte[] bytes = pdf.BinaryData;Imports System.IO
' jsreportstream handling (DELETE THIS):
Using fileStream As FileStream = File.Create("output.pdf")
report.Content.CopyTo(fileStream)
End Using
' Or for byte array:
Using memoryStream As New MemoryStream()
Await report.Content.CopyToAsync(memoryStream)
Return memoryStream.ToArray()
End Using
' IronPDFdirect access:
pdf.SaveAs("output.pdf")
' Or:
Dim bytes As Byte() = pdf.BinaryDataProblema: el código hace referencia a la clase LocalReporting que no existe en IronPDF.
Solución: Reemplazar con ChromePdfRenderer:
// jsreport
var rs = new LocalReporting().UseBinary().AsUtility().Create();
// IronPDF
var renderer = new ChromePdfRenderer();' jsreport
Dim rs = New LocalReporting().UseBinary().AsUtility().Create()
' IronPDF
Dim renderer = New ChromePdfRenderer()Problema: el código utiliza objetos contenedor RenderRequest y Template.
Solución: Pasar HTML directamente a los métodos de renderizado:
// jsreport
await rs.RenderAsync(new RenderRequest { Template = new Template { Content = html } });
// IronPDF
var pdf = renderer.RenderHtmlAsPdf(html);Imports System.Threading.Tasks
' jsreport
Await rs.RenderAsync(New RenderRequest With {.Template = New Template With {.Content = html}})
' IronPDF
Dim pdf = renderer.RenderHtmlAsPdf(html)Problema: uso de la sintaxis de marcador de posición jsreport<span class='pageNumber'></span>.
Solución: Actualizar la sintaxis del marcador de posición IronPDF:
// jsreportsyntax (won't work)
"Page <span class='pageNumber'></span> of <span class='totalPages'></span>"
//IronPDFsyntax
"Page {page} of {total-pages}"' jsreportsyntax (won't work)
"Page <span class='pageNumber'></span> of <span class='totalPages'></span>"
' IronPDFsyntax
"Page {page} of {total-pages}"Problema: El código hace referencia a JsReportBinary.GetBinary().
Solución: eliminar por completo:IronPDFno requiere binarios externos:
// DELETE this jsreportpattern:
.UseBinary(JsReportBinary.GetBinary())
//IronPDFneeds nothing—just create the renderer:
var renderer = new ChromePdfRenderer();netusingjsreport.Binaryjsreport.Binary.Linuxjsreport.Binary.OSXjsreport.Localjsreport.Typesjsreport.ClientIronPdfLocalReporting con ChromePdfRendererRenderRequestTemplate<span class='pageNumber'> → {page})StartAsync() / KillAsync()BinaryData o 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.
