Migrer de SAP Crystal Reportsà IronPDF transforme votre flux de travail de reporting d'un redistribuable MSI d'exécution avec des dépendances de l'ère COM à un package NuGetmoderne. Ce guide fournit un chemin de migration étape par étape qui élimine la nécessité d'un installateur runtime, lève l'enfermement dans l'écosystème SAP, et débloque les cibles .NET 6/8/9 et Linux/Docker que Crystal Reports pour Visual Studio (CR4VS) ne supporte pas.
SAP Crystal Reports est une plate-forme de reporting d'entreprise largement utilisée pour générer des rapports " pixel-perfect ", avec une connectivité de source de données large et un écosystème de designer de longue date. Le designer Crystal Reports reste un outil productif pour construire des mises en page de rapport complexes au sein de la pile SAP.
Cependant, l'architecture COM-era du runtime et l'empreinte uniquement Windows/.NET Framework créent des frictions pour les équipes ciblant .NET 6/8/9, Linux, ou des déploiements orientés conteneurs.
.rpt| Facteur coût | SAP Crystal Reports | IronPDF |
|---|---|---|
| Distribution Runtime | Installateur redistribuable MSI | Paquet NuGet |
| Installation | Installateur runtime + extension VS | dotnet add package IronPdf |
| Déploiement | Exécuter MSI sur la machine cible | xcopy / publier |
| prise en charge 64 bits | Oui (le runtime 32 bits se termine après SP 39, déc 2025) | Natif |
| .NET Core / .NET 5+ | Non pris en charge (Framework 4.x uniquement) | Support complet (.NET 6/8/9, Framework 4.6.2+) |
| Déploiement dans le nuage | VMs Windows uniquement | Simple |
| Linux / Docker | Non pris en charge (Windows uniquement) | Prise en charge |
| Fonction | SAP Crystal Reports | IronPDF |
|---|---|---|
| Fonctionnalité principale | Plateforme de reporting d'entreprise | Moteur de conversion HTML-PDF et manipulation de PDF |
| Intégration | Meilleur au sein de l'écosystème SAP | Intégration .NET moderne, package NuGetléger |
| Facilité d'utilisation | Installationet déploiement complexes | Intégration simplifiée, prise en charge des développeurs .NET |
| Report Designer | Les exigences sont les suivantes | Facultatif (HTML/CSS) |
| Format du modèle | .rpt (binaire) | HTML/CSS |
| HTML à PDF | Non | Chromium complet |
| URL vers PDF | Non | Oui |
| Support CSS | Non | CSS3 complet |
| JavaScript | Non | ES2024 complet |
| Manipulation de PDF | Non | Complet (fusionner, diviser, éditer) |
| Signatures numériques | Non | Oui |
| Conformité PDF/A | Non | Oui |
| Pertinence moderne | En déclin, remplacé par des alternatives modernes | Moderne, bien intégré aux technologies contemporaines |
Pour les équipes ciblant .NET moderne (6, 8, 9) et le déploiement multiplateforme,IronPDF offre un support natif que le runtime Crystal Reports — fixé au .NET Framework 4.x — ne peut offrir.
# Crystal Reports for Visual Studio is not distributed by SAP on NuGet.
# Projects typically reference the GAC-installed CrystalDecisions.*.dll
# assemblies delivered by the CR4VS / CR runtime MSI. Community-maintained
# NuGetwrappers such as CrystalReports.Engine exist for build automation
# but are not official SAP packages.
# 1. Remove direct assembly references (CrystalDecisions.*.dll) from your .csproj
# 2. If using a community NuGetwrapper, remove it:
dotnet remove package CrystalReports.Engine
# 3. Uninstall the Crystal Reports runtime MSI from build/deploy targets
# 4. Install 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"// Before: SAP Crystal Reports
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using CrystalDecisions.ReportAppServer;
// After: IronPDF
using IronPdf;Imports CrystalDecisions.CrystalReports.Engine
Imports CrystalDecisions.Shared
Imports CrystalDecisions.ReportAppServer
Imports IronPdf| SAP Crystal Reports | IronPDF | Notes |
|---|---|---|
ReportDocument | ChromePdfRenderer | Rendu de base |
ReportDocument.Load() | RenderHtmlAsPdf() | Charger le contenu |
.rpt files | Modèles HTML/CSS | Format du modèle |
SetDataSource() | HTML avec données | Liaison de données |
SetParameterValue() | Interpolation de chaînes de caractères | Paramètres |
ExportToDisk() | pdf.SaveAs() | Enregistrer le fichier |
ExportToStream() | pdf.BinaryData | Obtenir des octets |
PrintToPrinter() | pdf.Print() | Impression |
Database.Tables | Accès aux données en C# | Source des données |
FormulaFieldDefinitions | Logique C# | Calculs |
SummaryInfo | pdf.MetaData | Métadonnées PDF |
ExportFormatType.PortableDocFormat | Résultat par défaut | PDF natif |
Avant (SAP Crystal Reports):
// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;
class Program
{
static void Main()
{
// Crystal Reports requires a .rpt file template
ReportDocument reportDocument = new ReportDocument();
reportDocument.Load("Report.rpt");
// Crystal Reports doesn't directly support HTML
// You need to bind data to the report template
// reportDocument.SetDataSource(dataSet);
ExportOptions exportOptions = reportDocument.ExportOptions;
exportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
exportOptions.ExportFormatType = ExportFormatType.PortableDocFormat;
DiskFileDestinationOptions diskOptions = new DiskFileDestinationOptions();
diskOptions.DiskFileName = "output.pdf";
exportOptions.DestinationOptions = diskOptions;
reportDocument.Export();
reportDocument.Close();
reportDocument.Dispose();
}
}' NuGet: Install-Package CrystalReports.Engine
Imports CrystalDecisions.CrystalReports.Engine
Imports CrystalDecisions.Shared
Module Program
Sub Main()
' Crystal Reports requires a .rpt file template
Dim reportDocument As New ReportDocument()
reportDocument.Load("Report.rpt")
' Crystal Reports doesn't directly support HTML
' You need to bind data to the report template
' reportDocument.SetDataSource(dataSet)
Dim exportOptions As ExportOptions = reportDocument.ExportOptions
exportOptions.ExportDestinationType = ExportDestinationType.DiskFile
exportOptions.ExportFormatType = ExportFormatType.PortableDocFormat
Dim diskOptions As New DiskFileDestinationOptions()
diskOptions.DiskFileName = "output.pdf"
exportOptions.DestinationOptions = diskOptions
reportDocument.Export()
reportDocument.Close()
reportDocument.Dispose()
End Sub
End ModuleAprès (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
// Create a PDF from HTML string
var renderer = new ChromePdfRenderer();
string htmlContent = "<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF created successfully!");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module Program
Sub Main()
' Create a PDF from HTML string
Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = "<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF created successfully!")
End Sub
End ModuleCet exemple illustre la différence fondamentale de paradigme. SAP Crystal Reportsnécessite un modèle de fichier .rpt pré-conçu créé dans le Crystal Reports Designer, puis vous devez configurer ExportOptions, ExportDestinationType, ExportFormatType, et DiskFileDestinationOptions. La bibliothèque ne prend pas directement en charge le contenu HTML : vous devez lier les données au modèle de rapport.
IronPDF accepte directement les chaînes HTML : créez un ChromePdfRenderer, appelez RenderHtmlAsPdf() avec tout contenu HTML, et SaveAs(). Aucun concepteur n'est requis, aucun modèle binaire n'est nécessaire, aucune configuration d'exportation complexe n'est requise. Consultez la documentation HTML vers PDF pour des exemples complets.
Avant (SAP Crystal Reports):
// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;
using System.Net;
class Program
{
static void Main()
{
// Crystal Reports cannot directly convert URLs to PDF
// You need to create a report template first
// Download HTML content
WebClient client = new WebClient();
string htmlContent = client.DownloadString("https://example.com");
// Crystal Reports requires .rpt template and data binding
// This approach is not straightforward for URL conversion
ReportDocument reportDocument = new ReportDocument();
reportDocument.Load("WebReport.rpt");
// Manual data extraction and binding required
// reportDocument.SetDataSource(extractedData);
reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf");
reportDocument.Close();
reportDocument.Dispose();
}
}' NuGet: Install-Package CrystalReports.Engine
Imports CrystalDecisions.CrystalReports.Engine
Imports CrystalDecisions.Shared
Imports System
Imports System.Net
Module Program
Sub Main()
' Crystal Reports cannot directly convert URLs to PDF
' You need to create a report template first
' Download HTML content
Dim client As New WebClient()
Dim htmlContent As String = client.DownloadString("https://example.com")
' Crystal Reports requires .rpt template and data binding
' This approach is not straightforward for URL conversion
Dim reportDocument As New ReportDocument()
reportDocument.Load("WebReport.rpt")
' Manual data extraction and binding required
' reportDocument.SetDataSource(extractedData)
reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf")
reportDocument.Close()
reportDocument.Dispose()
End Sub
End ModuleAprès (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
// Create a PDF from a URL
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF created from URL successfully!");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module Program
Sub Main()
' Create a PDF from a URL
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF created from URL successfully!")
End Sub
End ModuleSAP Crystal Reports ne peut pas convertir directement les URL en PDF. Vous devriez télécharger manuellement le contenu HTML avec WebClient, puis extraire et lier ces données à un modèle .rpt pré-conçu—un processus non trivial et qui nécessite un travail manuel important.
La méthode RenderUrlAsPdf() d'IronPDF capture la page web entièrement rendue avec tout le CSS, JavaScriptet les images en un seul appel. Pour en savoir plus, consultez nos tutoriels.
Avant (SAP Crystal Reports):
// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;
class Program
{
static void Main()
{
// Crystal Reports requires design-time configuration
ReportDocument reportDocument = new ReportDocument();
reportDocument.Load("Report.rpt");
// Headers and footers must be designed in the .rpt file
// using Crystal Reports designer
// You can set parameter values programmatically
reportDocument.SetParameterValue("HeaderText", "Company Name");
reportDocument.SetParameterValue("FooterText", "Page ");
// Crystal Reports handles page numbers through formula fields
// configured in the designer
reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf");
reportDocument.Close();
reportDocument.Dispose();
}
}' NuGet: Install-Package CrystalReports.Engine
Imports CrystalDecisions.CrystalReports.Engine
Imports CrystalDecisions.Shared
Imports System
Module Program
Sub Main()
' Crystal Reports requires design-time configuration
Dim reportDocument As New ReportDocument()
reportDocument.Load("Report.rpt")
' Headers and footers must be designed in the .rpt file
' using Crystal Reports designer
' You can set parameter values programmatically
reportDocument.SetParameterValue("HeaderText", "Company Name")
reportDocument.SetParameterValue("FooterText", "Page ")
' Crystal Reports handles page numbers through formula fields
' configured in the designer
reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf")
reportDocument.Close()
reportDocument.Dispose()
End Sub
End ModuleAprès (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.TextHeader.CenterText = "Company Name";
renderer.RenderingOptions.TextHeader.FontSize = 12;
renderer.RenderingOptions.TextFooter.LeftText = "Confidential";
renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}";
renderer.RenderingOptions.TextFooter.FontSize = 10;
string htmlContent = "<h1>Document Title</h1><p>Document content goes here.</p>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF with headers and footers created!");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module Program
Sub Main()
Dim renderer = New ChromePdfRenderer()
' Configure headers and footers
renderer.RenderingOptions.TextHeader.CenterText = "Company Name"
renderer.RenderingOptions.TextHeader.FontSize = 12
renderer.RenderingOptions.TextFooter.LeftText = "Confidential"
renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}"
renderer.RenderingOptions.TextFooter.FontSize = 10
Dim htmlContent As String = "<h1>Document Title</h1><p>Document content goes here.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF with headers and footers created!")
End Sub
End ModuleSAP Crystal Reports nécessite une configuration des en-têtes et des pieds de page au moment de la conception. Vous devez les concevoir dans le fichier .rpt en utilisant le Crystal Reports Designer, puis passer des valeurs de paramètres comme "HeaderText" et "FooterText" à l'exécution. Les numéros de page doivent être configurés via les champs de formule dans le concepteur.
IronPDF propose une configuration programmatique de l'en-tête/pied de page avec les propriétés TextHeader et TextFooter. Définissez CenterText, LeftText, RightText et FontSize directement dans le code. Les numéros de page utilisent les espaces réservés {page} et {total-pages}—pas besoin de concepteur.
SAP Crystal Reports: Fichiers binaires .rpt avec mise en page, données et formules intégrées.
Solution: Impossible de convertir directement - il faut recréer en HTML :
SAP Crystal Reports: Chaînes de connexion intégrées et ODBC.
Solution: Utilisez la couche de données de votre application :
// Instead of Crystal's database integration
var data = await _dbContext.Orders
.Where(o => o.Date >= startDate && o.Date <= endDate)
.ToListAsync();
// Bind to HTML template
var html = GenerateReportHtml(data);Option Strict On
Option Infer On
' Instead of Crystal's database integration
Dim data = Await _dbContext.Orders _
.Where(Function(o) o.Date >= startDate AndAlso o.Date <= endDate) _
.ToListAsync()
' Bind to HTML template
Dim html = GenerateReportHtml(data)SAP Crystal Reports: Nécessite l'installation de Crystal Reports Runtime (500MB+).
**Solution:**IronPDF est autonome :
# Just add the NuGetpackage
dotnet add package IronPdf
# That's it - no additional installs neededSAP Crystal Reports : L'exécution de Crystal Reports dépend de COM et est livrée dans des MSI 32 bits et 64 bits séparés. SAP a confirmé que l'exécution CR .NET 32 bits est arrêtée après SP 39 (décembre 2025) ; les futurs packs de service seront uniquement 64 bits. L'exécution cible .NET Framework 4.x et ne peut pas être chargée sous .NET Core / .NET 5+.
**Solution :**IronPDF fonctionne sur .NET Framework 4.6.2+, .NET 6, .NET 8, et .NET 9 — y compris Linux et Docker. Aucune configuration spéciale n'est requise pour 64 bits ou AnyCPU.
Après avoir migré vers IronPDF, vous bénéficiez de fonctionnalités que SAP Crystal Reportsne peut pas vous offrir :
var pdf1 = PdfDocument.FromFile("report1.pdf");
var pdf2 = PdfDocument.FromFile("report2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("complete_report.pdf");Dim pdf1 = PdfDocument.FromFile("report1.pdf")
Dim pdf2 = PdfDocument.FromFile("report2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("complete_report.pdf")var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(reportHtml);
pdf.MetaData.Title = "Quarterly Sales Report";
pdf.MetaData.Author = "Finance Department";
pdf.SecuritySettings.OwnerPassword = "admin123";
pdf.SecuritySettings.UserPassword = "view123";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SaveAs("secure_report.pdf");Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(reportHtml)
pdf.MetaData.Title = "Quarterly Sales Report"
pdf.MetaData.Author = "Finance Department"
pdf.SecuritySettings.OwnerPassword = "admin123"
pdf.SecuritySettings.UserPassword = "view123"
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SaveAs("secure_report.pdf")var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);Dim signature = New PdfSignature("certificate.pfx", "password")
pdf.Sign(signature)using IronPdf.Editing;
pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");Imports IronPdf.Editing
pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>")| Fonction | SAP Crystal Reports | IronPDF |
|---|---|---|
| : Installation : | ||
| Méthode d'installation | MSI + extension Visual Studio | NuGet |
| Déploiement | Exécuter MSI sur la machine cible | xcopy / publier |
| : Prise en charge de la plateforme : | ||
| .NET Core / .NET 5+ | Non pris en charge | Oui (.NET 6/8/9) |
| 64-bit Native | Oui (le 32 bits se termine après SP 39, déc 2025) | Oui |
| Linux / Docker | Non pris en charge (Windows uniquement) | Oui |
| Azure / AWS | VMs Windows uniquement | Simple |
| : Développement : | ||
| Format du modèle | .rpt (binaire) | HTML/CSS |
| Courbe d'apprentissage | Syntaxe du cristal | Normes Web |
| IntelliSense | Non | C# complet |
| : Rendu : | ||
| URL vers PDF | Non | Oui |
| Support CSS | Non | CSS3 complet |
| JavaScript | Non | ES2024 complet |
| : Fonctionnalités du PDF : | ||
| Diviser les PDF | Non | Oui |
| Filigranes | Limité | HTML complet |
| Signatures numériques | Non | Oui |
| PDF/A | Non | Oui |
.rptCrystalDecisions.CrystalReports.Engine, etc.)IronPdf.rpt en modèles HTML/CSSSetDataSource() à l'interpolation de chaînes HTMLPrintToPrinter() à pdf.Print()
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.
