A migração do jsreport para o IronPDF transforma seu fluxo de trabalho de PDF em .NET , de um sistema dependente de Node.js com gerenciamento de binários externos e processos de servidor separados, para uma biblioteca .NET pura que é executada inteiramente no mesmo processo. Este guia fornece um caminho de migração abrangente, passo a passo, que elimina a complexidade da infraestrutura e os requisitos de modelos JavaScript para desenvolvedores .NET profissionais.
O jsreport introduz uma complexidade que não pertence a um ambiente .NET puro:
Dependência do Node.js : Requer o ambiente de execução e os binários do Node.js , adicionando complexidade à infraestrutura do que deveria ser uma aplicação .NET simples.
Gestão Externa de Binários: É necessário baixar e gerenciar binários específicos da plataforma para Windows, Linux e OSX através de pacotes NuGet separados (jsreport.Binary, jsreport.Binary.Linux, jsreport.Binary.OSX).
Processo de Servidor Separado: Funciona como uma utilidade ou servidor web — é necessário um gerenciamento adicional de processos com os métodos de ciclo de vida StartAsync() e KillAsync().
Modelagem em JavaScript : Força o aprendizado de Handlebars, JsRender ou outros sistemas de modelagem em JavaScript em vez de usar os recursos nativos do C#.
Estrutura de Solicitação Complexa: Requer objetos RenderRequest verbosos com configurações Template aninhadas até mesmo para geração simples de PDF.
Limitações de Licenciamento: O nível gratuito está limitado a 5 templates por instância; o uso comercial além disso requer uma licença Enterprise ($395/ano por instância) ou Enterprise Scale ($1,295/ano, isento de royalties em todas as instâncias). See jsreport.net/buy.
Saída baseada em fluxo: Retorna fluxos que exigem operações manuais em arquivos e gerenciamento de fluxos de memória.
| Recurso | jsreport | IronPDF |
|---|---|---|
| Tempo de execução | Node.js + .NET | .NET puro |
| Gerenciamento Binário | Manual (pacotes jsreport.Binary) | Automático |
| Processo do servidor | Requerido (servidor utilitário ou web) | Em andamento |
| Modelagem | JavaScript (Handlebars, etc.) | C# (Razor, interpolação de strings) |
| Estilo API | Objetos de solicitação detalhados | Métodos limpos e fluentes |
| Saída | Fluxo | Objeto PdfDocument |
| Manipulação de PDF | Limitado | Extenso (mesclar, dividir, editar) |
| Suporte assíncrono | Somente assíncrono | Tanto síncrono quanto assíncrono |
Para equipes planejando adoção do .NET 10 e C# 14, o IronPDF fornece uma base nativa do .NET sem dependências de runtime externas.
| Recurso | Complexidade da Migração |
|---|---|
| HTML para PDF | Muito baixo |
| URL para PDF | Muito baixo |
| Cabeçalhos/Rodapés | Baixo |
| Configurações da página | Baixo |
| Ciclo de vida do servidor | Baixo |
| Gerenciamento Binário | Baixo |
A mudança fundamental nesta migração do jsreport é a substituição de objetos de requisição verbosos com gerenciamento de servidor por chamadas de método simples em processo:
jsreport: LocalReporting().UseBinary().AsUtility().Create() → RenderAsync(RenderRequest) → Fluxo → File
IronPDF: ChromePdfRenderer → RenderHtmlAsPdf(html) → SaveAs()# Remove jsreport packages
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 jsreport references
grep -r "using jsreport\|LocalReporting\|RenderRequest\|RenderAsync" --include="*.cs" .
grep -r "JsReportBinary\|Template\|Recipe\|Engine\." --include="*.cs" .| Classe jsreport | Equivalente ao IronPDF |
|---|---|
LocalReporting | ChromePdfRenderer |
ReportingService | ChromePdfRenderer |
RenderRequest | Parâmetros do método |
Template | Parâmetros do método |
Chrome | RenderingOptions |
Report | PdfDocument |
Engine | (não é necessário) |
| Método jsreport | Equivalente ao IronPDF |
|---|---|
LocalReporting().UseBinary().AsUtility().Create() | new ChromePdfRenderer() |
rs.RenderAsync(request) | renderer.RenderHtmlAsPdf(html) |
rs.StartAsync() | (não é necessário) |
rs.KillAsync() | (não é necessário) |
report.Content.CopyTo(stream) | pdf.SaveAs(path) ou pdf.BinaryData |
| Propriedade do modelo jsreport | Equivalente ao IronPDF |
|---|---|
Template.Content | Primeiro parâmetro para RenderHtmlAsPdf() |
Template.Recipe = Recipe.ChromePdf | (não é necessário) |
Template.Engine = Engine.None | (não é necessário) |
Chrome.HeaderTemplate | RenderingOptions.TextHeader ou HtmlHeader |
Chrome.FooterTemplate | RenderingOptions.TextFooter ou HtmlFooter |
Chrome.DisplayHeaderFooter | (automático) |
Chrome.MarginTop | RenderingOptions.MarginTop |
| jsreport - Espaço reservado | Espaço reservado para 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 ModuleApó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 ClassA abordagem jsreport requer três pacotes NuGet (jsreport.Binary, jsreport.Local, jsreport.Types), três importações de namespace, execução apenas assíncrona, uma cadeia de builder fluente (LocalReporting().UseBinary().AsUtility().Create()), um RenderRequest verboso com objeto Template aninhado especificando Recipe e Engine, e cópia manual de fluxo para arquivo com um bloco using.
O IronPDF reduz isso a um pacote NuGet , um namespace, três linhas de código e execução síncrona. O método ChromePdfRenderer.RenderHtmlAsPdf() aceita HTML diretamente e retorna um PdfDocument com um método SaveAs() simples. Consulte a documentação de conversão de HTML para PDF para obter opções de renderização adicionais.
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 ModuleApó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 Classjsreport pode renderizar uma URL configurando Chrome.Url na solicitação, mas não há um método de conveniência de nível superior — e um padrão comum em código existente é a solução de redirecionamento JavaScript (window.location='https://example.com') mostrada acima, que pode falhar em sites que bloqueiam navegação por script.
IronPDF fornece um método RenderUrlAsPdf() dedicado que leva a URL como argumento direto, com execução completa de JavaScript e suporte moderno a CSS. Saiba mais sobre a conversão de URL para 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 ModuleApó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 ModuleA abordagem jsreport requer adicionar um objeto Chrome ao Template, configurando DisplayHeaderFooter = true e usando templates HTML com substitutos de classes CSS especiais (<span class='pageNumber'></span>, <span class='totalPages'></span>). Os modelos de cabeçalho e rodapé devem incluir estilos embutidos completos.
IronPDF fornece uma configuração TextHeaderFooter mais limpa com propriedades dedicadas para CenterText, LeftText, RightText e FontSize. Substitutos de número de página usam a sintaxe mais simples {page} e {total-pages}. Consulte a documentação sobre cabeçalhos e rodapés para obter opções de cabeçalho HTML.
O jsreport requer gerenciamento explícito do ciclo de vida do 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()O IronPDF é executado inteiramente no mesmo processo — sem inicialização de servidor, sem gerenciamento de processos, sem limpeza:
// IronPDF:
var renderer = new ChromePdfRenderer();
// Just use it—no lifecycle management needednetO jsreport requer pacotes NuGet separados 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.OSXO IronPDF lida automaticamente com todos os requisitos da plataforma por meio de um único pacote NuGet .
O jsreport usa marcadores de posição baseados em classes CSS ou chaves. O IronPDF usa uma sintaxe diferente:
// jsreport placeholders:
"<span class='pageNumber'></span>" // or {#pageNum}
"<span class='totalPages'></span>" // or {#numPages}
//IronPDF placeholders:
"{page}"
"{total-pages}"
"{date}"
"{html-title}"' jsreport placeholders:
"<span class='pageNumber'></span>" ' or {#pageNum}
"<span class='totalPages'></span>" ' or {#numPages}
' IronPDF placeholders:
"{page}"
"{total-pages}"
"{date}"
"{html-title}"jsreport frequentemente usa templatização Handlebars com Engine.Handlebars:
// jsreport Handlebars (DELETE THIS):
Template = new Template
{
Content = "<h1>Hello, {{name}}</h1>",
Engine = Engine.Handlebars
},
Data = new { name = "World" }
//IronPDF with C# string interpolation:
string name = "World";
string html = $"<h1>Hello, {name}</h1>";
var pdf = renderer.RenderHtmlAsPdf(html);O jsreport retorna um fluxo que requer cópia manual:
// jsreport stream 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();
}
//IronPDF direct access:
pdf.SaveAs("output.pdf");
// Or:
byte[] bytes = pdf.BinaryData;Imports System.IO
' jsreport stream 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
'IronPDF direct access:
pdf.SaveAs("output.pdf")
' Or:
Dim bytes As Byte() = pdf.BinaryDataProblema: Referências de código para a classe LocalReporting que não existe no IronPDF.
Solução: Substitua por 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: O código usa objetos wrapper RenderRequest e Template.
Solução: Passe o HTML diretamente para os métodos de renderização:
// 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: Usando a sintaxe de substituto jsreport <span class='pageNumber'></span>.
Solução: Atualize para a sintaxe de marcador de posição do IronPDF:
// jsreport syntax (won't work)
"Page <span class='pageNumber'></span> of <span class='totalPages'></span>"
//IronPDF syntax
"Page {page} of {total-pages}"' jsreport syntax (won't work)
"Page <span class='pageNumber'></span> of <span class='totalPages'></span>"
' IronPDF syntax
"Page {page} of {total-pages}"Problema: Referências de código para JsReportBinary.GetBinary().
Solução: Exclua completamente — o IronPDF não requer binários externos:
// DELETE this jsreport pattern:
.UseBinary(JsReportBinary.GetBinary())
//IronPDF needs nothing—just create the renderer:
var renderer = new ChromePdfRenderer();netusingjsreport.Binaryjsreport.Binary.Linuxjsreport.Binary.OSXjsreport.Localjsreport.Typesjsreport.ClientIronPdfLocalReporting por ChromePdfRendererRenderRequestTemplate<span class='pageNumber'> → {page})StartAsync() / KillAsync()BinaryData ou SaveAs()
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
