Wie man einen PDF-Bericht in C# für .NET mit IronPDF erstellt

PDF-Berichte in ASP.NET mit C# oder VB erstellen

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF ermöglicht es .NET-Entwicklern, PDF-Berichte aus HTML-, Crystal Reports-, XML- und SQL Server-Daten zu erstellen, indem HTML-Inhalte als PDF-Dokumente gerendert werden. Diese C#-Bibliothek vereinfacht die Erstellung von Berichten in ASP.NET-Anwendungen mit nur wenigen Codezeilen, wobei alle Formatierungen und Gestaltungen erhalten bleiben.

Schnellstart: PDF-Berichte mit IronPDF erstellen

Beginnen Sie mit der Erstellung von PDF-Berichten mit IronPDF in nur wenigen Codezeilen. Dieser schnelle Leitfaden ermöglicht es Entwicklern, HTML-Inhalte sofort in professionelle PDF-Dokumente umzuwandeln, wobei alle Formatierungen mühelos erhalten bleiben. Folgen Sie dem untenstehenden Beispiel, um zu sehen, wie einfach es ist, Ihre Daten in einen gut gestalteten PDF-Bericht zu verwandeln.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    // Instantiate ChromePdfRenderer for HTML to PDF conversion
    new IronPdf.ChromePdfRenderer().RenderHtmlFileAsPdf("report.html").SaveAs("report.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Schritt 1

Wie installiere ich IronPDF?

IronPdf auf NuGet

Install-Package IronPdf

Sie können auch die IronPDF DLL manuell herunterladen. Für fortgeschrittene Installationsszenarien steht Ihnen unser umfassender Leitfaden für NuGet-Pakete zur Verfügung, der die Konfiguration für die Plattformen Azure, AWS, Linux, Mac und Windows abdeckt. Wenn Sie mit containerisierten Anwendungen arbeiten, finden Sie in unserem Docker-Integrationsleitfaden ausführliche Anweisungen zur Einrichtung.


Anleitung zum Tutorial

Was ist die Methodik für die Erstellung eines PDF-Berichts?

Generieren Sie den Bericht zunächst als HTML-Dokument und rendern Sie das HTML dann mit IronPDF als PDF. Dieses Tutorial zeigt Ihnen die Schritte zur Erstellung eines PDF-Berichts in ASP.NET C#. Die Chrome Rendering Engine von IronPDF sorgt für eine pixelgenaue Konvertierung und unterstützt gleichzeitig modernes HTML5, CSS3 und JavaScript.

:path=/static-assets/pdf/content-code-examples/how-to/csharp-pdf-reports-render-html-file.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderHtmlFileAsPdf("report.html").SaveAs("report.pdf");
$vbLabelText   $csharpLabel

Wenn Sie komplexere Berichte erstellen möchten, lesen Sie unser umfassendes Tutorial zur PDF-Erstellung, das Wasserzeichen, Komprimierung, Hintergründe, Kopf- und Fußzeilen, Formulare und Passwortschutz behandelt.

Wie kann ich Crystal Reports mit .NET in PDF konvertieren?

Exportieren Sie Crystal Reports nach HTML mit:

Datei → Exportieren → HTML 4.0

Der resultierende Bericht kann dann mit dem obigen C#-Beispielcode im Methodikabschnitt als PDF exportiert werden. IronPDF bietet hervorragende Unterstützung für die Konvertierung von HTML-Dateien in PDF, wobei alle Formatierungen und Stile der Crystal Reports-Ausgabe erhalten bleiben.

Hier ist ein Beispiel:

:path=/static-assets/pdf/content-code-examples/how-to/csharp-pdf-reports-render-header-footer.cs
using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Add a header to very page easily
renderer.RenderingOptions.FirstPageNumber = 1;
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "{url}";
renderer.RenderingOptions.TextHeader.Font = FontTypes.Arial;
renderer.RenderingOptions.TextHeader.FontSize = 12;

// Add a footer too
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}";

renderer.RenderHtmlFileAsPdf(@"c:\my\exported\report.html").SaveAs("report.pdf");
$vbLabelText   $csharpLabel

Für fortgeschrittene Anpassungen von Kopf- und Fußzeilen, einschließlich HTML-basierter Kopfzeilen, besuchen Sie unseren Headers and Footers Guide.

Wie kann ich Crystal Reports programmatisch in PDF konvertieren?

Wenn Sie programmatisch mit einer Crystal-Berichtsdatei (RPT) arbeiten möchten, ist dies auch möglich und bietet Ihnen viel mehr Kontrolle. Dieser Ansatz lässt sich nahtlos in die Rendering-Optionen von IronPDF integrieren, so dass eine vollständige Anpassung möglich ist.

using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System.IO;
using IronPdf;

public static void ExportRptToPdf(string rptPath, string pdfOutputPath)
{
    // Load the Crystal Report
    ReportDocument rpt = new ReportDocument();
    rpt.Load(rptPath);

    // Configure export options for HTML output
    DiskFileDestinationOptions diskOpts = new DiskFileDestinationOptions()
    {
        DiskFileName = @"c:\tmp\html\b.html" // Temporary HTML file
    };

    ExportOptions exportOpts = ExportOptions.CreateExportOptions();
    exportOpts.ExportDestinationType = ExportDestinationType.DiskFile;
    exportOpts.ExportFormatType = ExportFormatType.HTML40; // Export as HTML 4.0
    exportOpts.ExportDestinationOptions = diskOpts;

    // Export report to HTML
    rpt.Export();

    // Convert HTML to PDF using IronPDF
    var Renderer = new ChromePdfRenderer();
    // Add dynamic header with URL
    Renderer.RenderingOptions.TextHeader.CenterText = "{url}";
    // Add footer with timestamp and page numbers
    Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
    Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}";

    // Render the HTML file to PDF and save
    Renderer.RenderFileAsPdf(diskOpts.DiskFileName).SaveAs(pdfOutputPath);

    Console.WriteLine("Report Written To {0}", Path.GetFullPath(pdfOutputPath));
}
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System.IO;
using IronPdf;

public static void ExportRptToPdf(string rptPath, string pdfOutputPath)
{
    // Load the Crystal Report
    ReportDocument rpt = new ReportDocument();
    rpt.Load(rptPath);

    // Configure export options for HTML output
    DiskFileDestinationOptions diskOpts = new DiskFileDestinationOptions()
    {
        DiskFileName = @"c:\tmp\html\b.html" // Temporary HTML file
    };

    ExportOptions exportOpts = ExportOptions.CreateExportOptions();
    exportOpts.ExportDestinationType = ExportDestinationType.DiskFile;
    exportOpts.ExportFormatType = ExportFormatType.HTML40; // Export as HTML 4.0
    exportOpts.ExportDestinationOptions = diskOpts;

    // Export report to HTML
    rpt.Export();

    // Convert HTML to PDF using IronPDF
    var Renderer = new ChromePdfRenderer();
    // Add dynamic header with URL
    Renderer.RenderingOptions.TextHeader.CenterText = "{url}";
    // Add footer with timestamp and page numbers
    Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
    Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}";

    // Render the HTML file to PDF and save
    Renderer.RenderFileAsPdf(diskOpts.DiskFileName).SaveAs(pdfOutputPath);

    Console.WriteLine("Report Written To {0}", Path.GetFullPath(pdfOutputPath));
}
$vbLabelText   $csharpLabel

Wie kann ich PDF-Berichte aus XML generieren?

Der Export von Berichtsdaten als XML ist immer noch üblich, obwohl es inzwischen leichter zu kodierende Formate wie JSON gibt. IronPDF bietet hervorragende Unterstützung für die XML-zu-PDF-Konvertierung und bietet mehrere Ansätze für die Verarbeitung von XML-Daten.

Um XML-Berichte zu gestalten, parsen Sie das XML und generieren HTML mit den Daten.

Eine elegantere Lösung ist die Verwendung von XSLT, um XML direkt in HTML zu konvertieren, unter Verwendung der Klasse XslCompiledTransform, wie im Artikel Verwendung der Klasse XslCompiledTransform dokumentiert.

Der resultierende HTML-String oder die Datei kann dann mit IronPDF als PDF gerendert werden:

using System.IO;
using System.Xml;
using System.Xml.Xsl;
using IronPdf;

public static void ConvertXmlToPdf(string xml, string xslt, string pdfOutputPath)
{
    // Initialize XSLT transformation
    XslCompiledTransform transform = new XslCompiledTransform();
    using (XmlReader reader = XmlReader.Create(new StringReader(xslt)))
    {
        transform.Load(reader); // Load XSLT stylesheet
    }

    // Transform XML to HTML
    StringWriter results = new StringWriter();
    using (XmlReader reader = XmlReader.Create(new StringReader(xml)))
    {
        transform.Transform(reader, null, results); // Apply transformation
    }

    // Convert the generated HTML to PDF
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    renderer.RenderHtmlAsPdf(results.ToString()).SaveAs(pdfOutputPath);
}
using System.IO;
using System.Xml;
using System.Xml.Xsl;
using IronPdf;

public static void ConvertXmlToPdf(string xml, string xslt, string pdfOutputPath)
{
    // Initialize XSLT transformation
    XslCompiledTransform transform = new XslCompiledTransform();
    using (XmlReader reader = XmlReader.Create(new StringReader(xslt)))
    {
        transform.Load(reader); // Load XSLT stylesheet
    }

    // Transform XML to HTML
    StringWriter results = new StringWriter();
    using (XmlReader reader = XmlReader.Create(new StringReader(xml)))
    {
        transform.Transform(reader, null, results); // Apply transformation
    }

    // Convert the generated HTML to PDF
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    renderer.RenderHtmlAsPdf(results.ToString()).SaveAs(pdfOutputPath);
}
$vbLabelText   $csharpLabel

Besuchen Sie den Artikel Konvertieren von XML in PDF in C# und VB.NET, um mehr über fortgeschrittene XML-Transformationstechniken und bewährte Verfahren zu erfahren.

Wie exportiere ich SQL Server-Berichte in PDF?

Microsofts SQL Server und der kostenlose SQL Server Express enthalten Berichtstools. Das Exportieren von SSRS-Berichten in ein PDF in ASP.NET kann eine nützliche Verwendung von IronPDF sein. Für komplexe Datenvisualisierungsanforderungen unterstützt IronPDF Darstellung von JavaScript-Diagrammen einschließlich beliebter Bibliotheken wie C3.js, D3.js und Highcharts.

Tutorial: So lokalisieren und starten Sie die Berichtsdienste-Tools (SSRS)

Diese Berichte können als HTML generiert werden, das dann angepasst und mit IronPDF in das PDF-Format konvertiert wird. IronPDFs HTML-String-zu-PDF-Konvertierung bietet vollständige Kontrolle über die Endausgabe.

In HTML rendern (Berichtseditor)

Für Unternehmensumgebungen, die einen sicheren Datenzugriff erfordern, unterstützt IronPDF TLS-Website und Systemanmeldungen, um die authentifizierte Berichterstellung zu ermöglichen.

Wie kann ich PDF-Berichte sichern?

Um sicherzustellen, dass ein PDF-Bericht nicht verändert oder verfälscht wurde, sollten Sie ihn digital signieren. Dies wird am einfachsten auf einer PDF-Berichtsdatei erreicht, nachdem diese gerendert und auf die Festplatte gespeichert wurde. IronPDF bietet umfassende PDF-Signierfunktionen einschließlich Unterstützung für Hardware Security Modules (HSM).

:path=/static-assets/pdf/content-code-examples/how-to/csharp-pdf-reports-sign-pdf.cs
using IronPdf.Signing;

// Sign our PDF Report using a p12 or pix digital certificate file
new PdfSignature("IronSoftware.pfx", "123456").SignPdfFile("signed.pdf");
$vbLabelText   $csharpLabel

Wenn Sie keine digitale Signatur haben, können Sie eine neue digitale Signaturdatei mit dem kostenlosen Adobe Acrobat Reader unter macOS und Windows erstellen. Weitere Sicherheitsmaßnahmen finden Sie in unserem Leitfaden zu PDF-Berechtigungen und Passwörtern, um den Zugriff auf Dokumente und Bearbeitungsrechte zu kontrollieren.

Wie konvertiere ich ASPX in PDF mit ASP.NET Webforms?

Der einfachste Weg, HTML-Inhalte in ASP.NET bereitzustellen, ist die Verwendung der IronPdf.AspxToPdf-Klasse im Form_Load-Ereignis einer ASP.NET WebForms-Anwendung. Mit dieser leistungsstarken Funktion können Sie ganze ASPX-Seiten, einschließlich serverseitiger Steuerelemente und dynamischer Inhalte, direkt in PDF konvertieren.

using IronPdf;

public static void RenderAspxToPdf()
{
    // Configure PDF rendering options
    var AspxToPdfOptions = new ChromePdfRenderOptions()
    {
        EnableJavaScript = false, // Disable JavaScript for simpler reports
        PrintHtmlBackgrounds = true, // Include background colors and images
        MarginTop = 20, // Set top margin in mm
        MarginBottom = 20, // Set bottom margin in mm
        PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait,
        PaperSize = IronPdf.Rendering.PdfPaperSize.A4
        // ...many more options available
    };

    // Render the HTML page to PDF and prompt download
    <code>AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Report.pdf", AspxToPdfOptions)</code>;
}
using IronPdf;

public static void RenderAspxToPdf()
{
    // Configure PDF rendering options
    var AspxToPdfOptions = new ChromePdfRenderOptions()
    {
        EnableJavaScript = false, // Disable JavaScript for simpler reports
        PrintHtmlBackgrounds = true, // Include background colors and images
        MarginTop = 20, // Set top margin in mm
        MarginBottom = 20, // Set bottom margin in mm
        PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait,
        PaperSize = IronPdf.Rendering.PdfPaperSize.A4
        // ...many more options available
    };

    // Render the HTML page to PDF and prompt download
    <code>AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Report.pdf", AspxToPdfOptions)</code>;
}
$vbLabelText   $csharpLabel

Wir hoffen, dass Ihnen dieser Artikel geholfen hat, zu lernen, wie Sie einen PDF-Bericht in ASP.NET C# oder VB.NET erstellen. Sie können auch einen Blick in unser vollständiges ASP.NET ASPX to PDF Tutorial werfen, um mehr über fortgeschrittene Szenarien zu erfahren, einschließlich der Einstellungen für die Umwandlung von ASPX-Seiten in PDF und die Handhabung komplexer Layouts.

Häufig gestellte Fragen

Wie kann ich in C# PDF-Berichte aus HTML generieren?

IronPDF ermöglicht es Ihnen, mit nur einer Zeile Code PDF-Berichte aus HTML zu erzeugen: new IronPdf.ChromePdfRenderer().RenderHtmlFileAsPdf("report.html").SaveAs("report.pdf"). Dadurch bleiben alle HTML-Formatierungen und -Stile im endgültigen PDF-Dokument erhalten.

Welche Arten von Berichten können in PDF konvertiert werden?

IronPDF unterstützt die Konvertierung mehrerer Berichtstypen in PDF, darunter HTML-Berichte, Crystal Reports (exportiert als HTML 4.0), XML-Berichte (mit HTML gestylt) und SQL Server-Datenberichte. Die Bibliothek verwendet eine Chrome-Rendering-Engine, um eine pixelgenaue Konvertierung zu gewährleisten.

Wie installiere ich die PDF-Berichtsgenerator-Bibliothek?

Sie können IronPDF über den NuGet Package Manager mit dem Befehl "Install-Package IronPdf" installieren oder die DLL manuell herunterladen. Die Bibliothek unterstützt verschiedene Plattformen wie Azure, AWS, Linux, Mac, Windows und Docker-Container.

Kann ich Crystal Reports in .NET in PDF konvertieren?

Ja, Sie können Crystal Reports mit IronPDF in PDF konvertieren, indem Sie den Crystal Report zunächst in das HTML 4.0-Format exportieren (Datei → Exportieren → HTML 4.0) und dann die RenderHtmlFileAsPdf-Methode von IronPDF verwenden, um die HTML-Ausgabe in ein PDF-Dokument zu konvertieren.

Wie kann ich PDF-Berichte aus SQL Server-Daten erstellen?

Um PDF-Berichte aus SQL Server-Daten zu erstellen, erzeugen Sie zunächst einen HTML-Bericht mit Ihren Daten und verwenden dann den ChromePdfRenderer von IronPDF, um den HTML-Bericht in PDF zu konvertieren. Die Bibliothek behält alle Formatierungen bei, was sie ideal für datenbankgestützte Berichte macht.

Kann ich PDF-Berichte digital signieren?

Ja, IronPDF ermöglicht es Ihnen, PDF-Berichte digital zu signieren, um sicherzustellen, dass sie nicht verfälscht wurden. Diese Funktion fügt Ihren generierten PDF-Dokumenten eine zusätzliche Ebene der Sicherheit und Authentizität hinzu.

Unterstützt die Bibliothek moderne Webstandards?

Die Rendering-Engine von IronPDF für Chrome unterstützt modernes HTML5, CSS3 und JavaScript und sorgt dafür, dass Ihre Berichte präzise gerendert werden und alle modernen Web-Styling- und interaktiven Elemente in der PDF-Ausgabe erhalten bleiben.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht