La migration de jsreport vers IronPDF transforme votre flux de travail PDF .NET d'un système dépendant de Node.js avec une gestion binaire externe et des processus serveur distincts à une bibliothèque .NET pure qui s'exécute entièrement dans le processus. Ce guide fournit un chemin de migration complet, étape par étape, qui élimine la complexité de l'infrastructure et les exigences de templating JavaScript pour les développeurs .NET professionnels.
jsreport introduit une complexité qui n'a pas sa place dans un environnement .NET pur :
Dépendance Node.js : nécessite l'environnement d'exécution et les binaires Node.js , ce qui ajoute de la complexité à l'infrastructure de ce qui devrait être une application .NET simple.
Gestion des binaires externes : Doit télécharger et gérer les binaires spécifiques à la plateforme pour Windows, Linux et OSX via des packages NuGet séparés (jsreport.Binary, jsreport.Binary.Linux, jsreport.Binary.OSX).
Processus serveur séparé : Fonctionne soit comme une utilité, soit comme un serveur web—une gestion de processus supplémentaire est requise avec StartAsync() et KillAsync() méthodes de cycle de vie.
Modèles JavaScript : Oblige à apprendre Handlebars, JsRender ou d'autres systèmes de modèles JavaScript au lieu d'utiliser les capacités natives de C#.
Structure de demande complexe : Nécessite des objets RenderRequest verbeux avec des configurations imbriquées Template même pour une simple génération de PDF.
Limitations de licence : Le niveau gratuit est limité à 5 modèles par instance ; l'utilisation commerciale au-delà nécessite une licence Enterprise (395 $/an par instance) ou Enterprise Scale (1 295 $/an, libre de droits sur les instances). See jsreport.net/buy.
Sortie basée sur les flux : Renvoie des flux nécessitant des opérations manuelles sur les fichiers et une gestion des flux de mémoire.
| Fonction | jsreport | IronPDF |
|---|---|---|
| Temps d'exécution | Node.js + .NET | Pure .NET |
| Gestion binaire | Manuel (paquets binaires jsreport) | Automatique |
| Processus de serveur | Nécessaire (utilitaire ou serveur web) | En cours |
| Création de modèles | JavaScript (guidon, etc.) | C# (Razor, interpolation de chaînes) |
| Style API | Objets de requête verbeux | Méthodes fluides et propres |
| Production | Flux | Objet PdfDocument |
| Manipulation de PDF | Limité | Extensif (fusionner, diviser, éditer) |
| Prise en charge de l'asynchronisme | Async uniquement | Sync et async |
Pour les équipes planifiant l'adoption de .NET 10 et C# 14,IronPDF fournit une base native .NET sans dépendances d'exécution externes.
| Fonction | Complexité de la migration |
|---|---|
| HTML vers PDF | Très faible |
| URL vers PDF | Très faible |
| En-têtes/Pieds de page | Faible |
| Paramètres de la page | Faible |
| Cycle de vie du serveur | Faible |
| Gestion binaire | Faible |
Le Shift fondamental de cette migration jsreport consiste à passer d'objets de requête verbeux avec gestion côté serveur à de simples appels de méthodes internes :
jsreport : LocalReporting().UseBinary().AsUtility().Create() → RenderAsync(RenderRequest) → Flux→ 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 | Équivalent d'IronPDF |
|---|---|
LocalReporting | ChromePdfRenderer |
ReportingService | ChromePdfRenderer |
RenderRequest | Paramètres de la méthode |
Template | Paramètres de la méthode |
Chrome | RenderingOptions |
Report | PdfDocument |
Engine | (pas nécessaire)* |
| méthode jsreport | Équivalent d'IronPDF |
|---|---|
LocalReporting().UseBinary().AsUtility().Create() | new ChromePdfRenderer() |
rs.RenderAsync(request) | renderer.RenderHtmlAsPdf(html) |
rs.StartAsync() | (pas nécessaire)* |
rs.KillAsync() | (pas nécessaire)* |
report.Content.CopyTo(stream) | pdf.SaveAs(path) ou pdf.BinaryData |
| propriété du modèle jsreport | Équivalent d'IronPDF |
|---|---|
Template.Content | Premier paramètre à RenderHtmlAsPdf() |
Template.Recipe = Recipe.ChromePdf | (pas nécessaire)* |
Template.Engine = Engine.None | (pas nécessaire)* |
Chrome.HeaderTemplate | RenderingOptions.TextHeader ou HtmlHeader |
Chrome.FooterTemplate | RenderingOptions.TextFooter ou HtmlFooter |
Chrome.DisplayHeaderFooter | (automatique) |
Chrome.MarginTop | RenderingOptions.MarginTop |
| jsreport Placeholder | IronPDF Placeholder |
|---|---|
<span class='pageNumber'></span> | {page} |
<span class='totalPages'></span> | {total-pages} |
{#pageNum} | {page} |
{#numPages} | {total-pages} |
{#timestamp} | {date} |
Avant (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 ModuleAprè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 ClassL'approche jsreport nécessite trois packages NuGet (jsreport.Binary, jsreport.Local, jsreport.Types), trois importations de namespace, une exécution asynchrone uniquement, une chaîne de constructeur fluide (LocalReporting().UseBinary().AsUtility().Create()), un RenderRequest verbeux avec objet imbriqué Template spécifiant Recipe et Engine, et une copie de flux vers fichier manuelle avec un bloc using.
IronPDF réduit cette tâche à un package NuGet, un espace de noms, trois lignes de code et une exécution synchrone. La méthode ChromePdfRenderer.RenderHtmlAsPdf() accepte le HTML directement et renvoie un PdfDocument avec une méthode SaveAs() simple. Voir la documentation HTML vers PDF pour des options de rendu supplémentaires.
Avant (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 ModuleAprè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 peut rendre une URL en configurant Chrome.Url sur la demande, mais il n'y a pas de méthode de commodité au niveau supérieur — et un modèle commun dans le code existant est le contournement de redirection JavaScript (window.location='https://example.com') montré ci-dessus, qui peut échouer sur les sites qui bloquent la navigation scriptée.
IronPDF offre une méthode RenderUrlAsPdf() dédiée qui prend l'URL comme argument direct, avec exécution complète de JavaScript et prise en charge moderne des CSS. En savoir plus sur la conversion d'URL en PDF.
Avant (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 ModuleAprè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 ModuleL'approche jsreport nécessite l'ajout d'un objet Chrome au Template, la configuration de DisplayHeaderFooter = true, et l'utilisation de modèles HTML avec des classes CSS spéciales (<span class='pageNumber'></span>, <span class='totalPages'></span>). Les modèles d'en-tête et de pied de page doivent inclure une mise en forme en ligne complète.
IronPDF offre une configuration TextHeaderFooter plus propre avec des propriétés dédiées pour CenterText, LeftText, RightText, et FontSize. Les espaces réservés de numéro de page utilisent la syntaxe plus simple {page} et {total-pages}. Voir la documentation sur les en-têtes et les pieds de page pour les options d'en-tête HTML.
jsreport nécessite une gestion explicite du cycle de vie du serveur :
// 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 s'exécute entièrement dans le processus - pas de démarrage du serveur, pas de gestion des processus, pas de nettoyage :
// IronPDF:
var renderer = new ChromePdfRenderer();
// Just use it—no lifecycle management needednetjsreport nécessite des packages NuGet distincts pour chaque plateforme cible :
# DELETE these platform-specific packages:
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSXIronPDF gère automatiquement toutes les exigences relatives à la plateforme par le biais d'un seul package NuGet.
jsreport utilise des caractères de remplacement CSS basés sur des classes ou des accolades.IronPDF utilise une syntaxe différente :
// 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 utilise souvent le modèle de gabarit Handlebars avec 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);jsreport renvoie un flux qui nécessite une copie manuelle :
// 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.BinaryDataProblème : Références de code la classe LocalReporting qui n'existe pas dans IronPDF.
Solution: Replace with 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()Problème : Code utilise les objets enveloppe RenderRequest et Template.
Solution : Transmettre directement le code HTML aux méthodes de rendu :
// 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)Problème : Utilisation de la syntaxe d'espace réservé jsreport <span class='pageNumber'></span>.
Solution : Mise à jour de la syntaxe des espaces réservés 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}"Problème : Références de code JsReportBinary.GetBinary().
Solution : Supprimez-le complètement —IronPDF ne nécessite pas de fichiers binaires externes :
// 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 par ChromePdfRendererRenderRequestTemplate<span class='pageNumber'> → {page})StartAsync() / KillAsync()BinaryData ou SaveAs()
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
