如何使用 IronPDF 在 C# 中創建 PDF 報告

在 ASP.NET 中使用 C## 或 VB 生成 PDF 報表。

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

IronPDF for .NET 可讓 .NET 開發人員將 HTML 內容渲染為 PDF 文件,從 HTML、Crystal Reports、XML 和 SQL Server 資料中產生 PDF 報表。 此 C# 函式庫只需幾行程式碼即可簡化 ASP.NET 應用程式中的報表建立,並保留所有格式與樣式。

<! -- 引言實作示意圖 --> <!--說明:說明程式碼概念的圖表或截圖 -->

快速入門:使用 IronPDF 產生 PDF 報告

只需幾行程式碼,即可開始使用 IronPDF 產生 PDF 報告。 本快速指南可協助開發人員立即將 HTML 內容轉換為專業的 PDF 文檔,輕鬆保留所有格式。 請按照下面的範例,了解如何輕鬆地將資料轉換為精美的 PDF 報告。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    // Instantiate ChromePdfRenderer for HTML to PDF conversion
    new IronPdf.ChromePdfRenderer().RenderHtmlFileAsPdf("report.html").SaveAs("report.pdf");
  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer

步驟 1

如何安裝 IronPDF? [IronPDF on NuGet](https://www.nuget.org/packages/IronPdf) ```shell :ProductInstall ``` 您也可以[手動下載 IronPDF DLL](https://www.nuget.org/packages/IronPdf) 。 如需進階安裝情境,請參閱我們全面的 [NuGet 套件指南](https://ironpdf.com/get-started/advanced-installation-nuget/),其中涵蓋 Azure、AWS、Linux、Mac 和 Windows 平台的組態。 如果您正在使用容器化應用程式,我們的 [Docker 整合指南](https://ironpdf.com/get-started/ironpdf-docker/) 提供了詳細的設定說明。

操作指南

建立 PDF 報告的方法為何? <!--說明:說明程式碼概念的圖表或截圖 --> 首先將報告產生為 HTML 文件,再使用 IronPDF 將 HTML 呈現為 PDF。 本教學說明在 ASP.NET C# 中建立 PDF 報告的步驟。 IronPDF 的 [ Chrome 渲染引擎](https://ironpdf.com/how-to/ironpdf-2021-chrome-rendering-engine-eap/) 可確保像素完美的轉換,同時支援現代 HTML5、CSS3 和 JavaScript。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/csharp-pdf-reports-render-html-file.cs ``` 如需更複雜的報告需求,請參閱我們的 [全面 PDF 創作教學](https://ironpdf.com/tutorials/csharp-create-pdf-complete-tutorial/),其中涵蓋水印、壓縮、背景、頁首、頁尾、表單和密碼保護。

如何使用 .NET 將 Crystal Reports 轉換為 PDF? --> 使用 Crystal Reports 匯出至 HTML: 檔案 → 匯出 → HTML 4.0 然後可以使用方法論部分中的上述 C# 範例程式碼將產生的報告匯出為 PDF。 IronPDF 為 [ 將 HTML 檔案轉換為 PDF](https://ironpdf.com/how-to/html-file-to-pdf/) 提供絕佳支援,可維持 Crystal Reports 輸出的所有格式與樣式。 以下是一個範例: ```csharp :path=/static-assets/pdf/content-code-examples/how-to/csharp-pdf-reports-render-header-footer.cs ``` 如需進階的標頭和頁尾自訂,包括基於 HTML 的標頭,請造訪我們的 [ 標頭和頁尾指南](https://ironpdf.com/how-to/headers-and-footers/)。

如何以程式方式將 Crystal Reports 轉換為 PDF? 如果您希望透過程式設計方式從 Crystal Reports (RPT) 檔案建立 PDF,這也是可行的,並且可以讓您擁有更大的控制權。 此方法可與 IronPDF 的 [ 渲染選項](https://ironpdf.com/how-to/rendering-options/)無縫整合,以進行完整的客製化。 ```csharp 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)); } ```

如何從 XML 產生 PDF 報表? 儘管 JSON 等較易編碼的格式已經非常普遍,但以 XML 格式匯出報告資料的做法仍然很常見。 IronPdf 為 [XML 至 PDF 的轉換](https://ironpdf.com/how-to/xml-to-pdf/)提供了極佳的支援,提供了多種處理 XML 資料的方法。 為 XML 報告設計樣式、解析 XML 並利用資料產生 HTML。 更優雅的解決方案是使用 XSLT 直接將 XML 轉換為 HTML,使用 `XslCompiledTransform` 類別,如文章 [Using the XslCompiledTransform Class](https://docs.microsoft.com/en-us/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) 所記載。 然後可以使用 IronPDF 將產生的 HTML 字串或文件渲染為 PDF: ```csharp 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); } ``` 請造訪 [Convert XML to PDF in C# and VB.NET 文章](/how-to/xml-to-pdf/),以瞭解更多關於進階 XML 轉換技術和最佳實務的資訊。

如何將 SQL Server 報表匯出至 PDF? 微軟的 SQL Server 和免費的 SQL Server Express 都包含報表工具。 在 ASP.NET 中,將 SSRS 報表匯出為 PDF 是 IronPDF 的一個有用用途。 針對複雜的資料可視化需求,IronPDF 支援 [渲染 JavaScript 圖表](https://ironpdf.com/how-to/javascript-to-pdf/),包括 C3.js、D3.js 和 Highcharts 等熱門函式庫。 [教學:如何尋找和啟動報表服務工具 (SSRS)](https://docs.microsoft.com/en-us/sql/reporting-services/tools/tutorial-how-to-locate-and-start-reporting-services-tools-ssrs?view=sql-server-2017) 這些報告可以產生為 HTML 格式,然後可以使用 IronPDF 進行自訂並轉換為 PDF 格式。 IronPdf 的 [HTML 字串轉換為 PDF](https://ironpdf.com/how-to/html-string-to-pdf/) 功能可完全控制最終輸出。 [渲染為 HTML(報表產生器)](https://docs.microsoft.com/en-us/sql/reporting-services/report-builder/rendering-to-html-report-builder-and-ssrs?view=sql-server-2017) 針對需要安全資料存取的企業環境,IronPDF 支援 [TLS 網站和系統登入](https://ironpdf.com/how-to/logins/),以處理經過驗證的報表產生。

如何保護 PDF 報表? 為了確保 PDF 報告未經修改或篡改,請對其進行數位簽名。 在 PDF 報告文件渲染並儲存到磁碟後,最容易實現這一點。 IronPDF 提供全面的 [PDF 簽署功能](https://ironpdf.com/how-to/signing/),包括支援 [Hardware Security Modules (HSM)](https://ironpdf.com/how-to/signing-pdf-with-hsm/)。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/csharp-pdf-reports-sign-pdf.cs ``` 如果您沒有數位簽名,可以使用 macOS 和 Windows 上的免費 Adobe Acrobat Reader 建立新的數位簽名檔。 如需其他安全措施,請參閱我們的 [ IronPDF 權限和密碼指南](https://ironpdf.com/how-to/pdf-permissions-passwords/),以控制文件存取和編輯權限。

如何使用 ASP.NET Webforms 將 ASPX 轉換為 PDF? 在 ASP.NET 中提供 HTML 內容的最簡單方法是在 ASP.NET WebForms 應用程式的 Form_Load 事件上使用 `IronPDF.AspxToPdf` 類。 這項強大的功能可讓您將整個 ASPX 頁面 (包括伺服器端控制項與動態內容) 直接轉換為 PDF。 ```csharp 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 AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Report.pdf", AspxToPdfOptions); } ``` 我們希望本文能幫助您學習如何在 ASP.NET C# 或 VB.NET 中產生 PDF 報告。 您也可以瀏覽我們完整的[ASP.NET ASPX to PDF Tutorial](/how-to/aspx-to-pdf/),瞭解更多進階方案,包括 ASPX 頁面轉 PDF 設定和處理複雜佈局。

常見問題解答

如何用 C# 從 HTML 產生 PDF 報告?

IronPDF 只需一行代碼即可讓您從 HTML 產生 PDF 報告:new IronPdf.ChromePdfRenderer().RenderHtmlFileAsPdf("report.html").SaveAs("report.pdf").這會在最終的 PDF 文件中保留所有 HTML 格式和樣式。

哪些類型的報告可以轉換成 PDF?

IronPDF 支援將多種報表類型轉換為 PDF,包括 HTML 報表、Crystal 報表 (匯出為 HTML 4.0)、XML 報表 (以 HTML 為風格),以及 SQL Server 資料報表。該函式庫使用 Chrome 演算引擎,以確保像素完美的轉換。

如何安裝 PDF 報告產生器函式庫?

您可以使用「Install-Package IronPdf」指令透過 NuGet Package Manager 安裝 IronPDF,或手動下載 DLL。該函式庫支援各種平台,包括 Azure、AWS、Linux、Mac、Windows 和 Docker 容器。

我可以在 .NET 中將 Crystal Reports 轉換為 PDF 嗎?

是的,您可以使用 IronPDF 將 Crystal Reports 轉換為 PDF,方法是先將 Crystal Report 匯出為 HTML 4.0 格式 (File → Export → HTML 4.0),然後再使用 IronPDF 的 RenderHtmlFileAsPdf 方法將 HTML 輸出轉換為 PDF 文件。

如何從 SQL Server 資料建立 PDF 報表?

若要從 SQL Server 資料建立 PDF 報表,請先使用資料產生 HTML 報表,然後再使用 IronPDF 的 ChromePdfRenderer 將 HTML 轉換為 PDF。該函式庫保留了所有格式,因此非常適合資料庫驅動的報表。

我可以數位簽章 PDF 報告嗎?

是的,IronPDF 允許您對 PDF 報告進行數位簽名,以確保其未被篡改。此功能可為您生成的 PDF 文件增加一層額外的安全性和真實性。

函式庫是否支援現代網路標準?

IronPDF 的 Chrome 渲染引擎完全支持现代 HTML5、CSS3 和 JavaScript,确保您的报告准确渲染,并在 PDF 输出中保留所有现代 Web 风格和交互式元素。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 16,685,821 | 版本: 2025.12 剛發表