如何在 C# 中從 FastReport 轉移到 IronPDF
FastReport.NET 是專為 .NET 生態系統打造的功能強大的報表解決方案,具有可視化報表設計器和基於頻帶的架構,可用於建立複雜的資料驅動報表。 然而,FastReport 為現代 PDF 生成工作流程帶來了重大挑戰:對報表設計師的依賴限制了代碼至上的開發、圍繞基於帶的概念(DataBand、PageHeaderBand)的陡峭學習曲線、使用專有格式的有限 CSS 支援、使用 RegisterData() 模板的複雜資料綁定,以及需要多次安裝的零散 NuGet 套件。 這份全面的指南提供了從快速報告到IronPDF的逐步遷移路徑 -IronPDF是一個通用的 PDF 函式庫,利用 HTML/CSS 網路技術進行彈性、程式化的文件產生。
為什麼要從快速報告轉移到 IronPDF?
FastReport.NET 在報表方面的專精,為需要多功能 PDF 生成的開發團隊製造了摩擦。 瞭解這些架構上的差異對於規劃您的遷移是非常重要的。
快速報告的挑戰
1.報表設計器依賴性:建立複雜的佈局需要視覺化設計器或對 .frx 檔案結構有深入的了解-不適合程式碼優先的開發方法。
2.學習曲線陡峭:快速報告基於帶狀結構的架構(DataBand、PageHeaderBand、PageFooterBand)需要理解報表特有的概念,這些概念無法轉移到其他技術。
- CSS 支援有限:不支援 Web 標準樣式; 造型是透過快速報告的專屬格式而非熟悉的 CSS 來完成。
4.複雜的資料綁定: RegisterData() 和 DataSource 連接為簡單的 PDF 生成場景增加了樣板程式碼。
5.分散的套件:需要多個 NuGet 套件才能實現完整功能(FastReport.OpenSource、FastReport.OpenSource.Export.PdfSimple 等)。
6.授權複雜性:開源版本功能有限; PDF 加密、數位簽署和字型嵌入需要商業版本。
架構比較
| 範疇 | 快速報告 | IronPDF |
|---|---|---|
| 設計方法 | 視覺設計師 + .frx 檔案 | HTML/CSS (網頁技術) |
| 學習曲線 | 陡峭(基於波段的概念) | 溫和 (HTML/CSS 知識) |
| 資料綁定 | RegisterData(), DataBand | 字串插值、Razor、樣板化 |
| CSS 支援 | 限額 | 完整的 CSS3 與 Flexbox/Grid |
| 套件模式 | 多種套件 | 單一套件(所有功能) |
| 渲染引擎 | 自訂 | 最新的 Chromium |
| PDF 操作 | 以出口為重點 | 完整(合併、分割、安全性、表單) |
| 現代 .NET | .NET Standard 2.0 | .NET 6/7/8/9+ 原生 |
主要遷移優勢
- Web技術:使用熟悉的HTML/CSS,而不是專有的基於頻段的佈局 2.程式碼優先開發:無需依賴視覺化設計器即可透過程式設計產生 PDF。 3.單一套件:一個 NuGet 套件包含所有 PDF 功能 4.現代渲染:採用最新的 Chromium 引擎,實現像素級精確的 CSS3 輸出 5.完整的 PDF 操作:合併、分割、安全設定、表單-不只是匯出
遷移前的準備工作
先決條件
確保您的環境符合這些要求:
- .NET Framework 4.6.2+ 或 .NET Core 3.1 / .NET 5-9
- Visual Studio 2019+ 或具有 C# 擴充功能的 VS Code
- NuGet 套件管理員存取權限 -IronPDF授權金鑰 (可於 ironpdf.com 網站免費試用)
審核快速報告使用情況
在您的解決方案目錄中執行這些指令,以辨識所有的快速報告參考資料:
# Find all快速報告references
grep -r "FastReport\|\.frx\|PDFExport\|PDFSimpleExport\|DataBand\|RegisterData" --include="*.cs" --include="*.csproj" .
# Check NuGet packages
dotnet list package | grep FastReport
# Find all快速報告references
grep -r "FastReport\|\.frx\|PDFExport\|PDFSimpleExport\|DataBand\|RegisterData" --include="*.cs" --include="*.csproj" .
# Check NuGet packages
dotnet list package | grep FastReport
記錄您的報告範本
遷移前,請將所有 .frx 檔案及其用途進行分類:
- 報告名稱與目的
- 使用的資料來源
- 頁頭/頁腳設定
- 頁數要求
- 特殊格式或造型
瞭解範式轉移
從快速報告轉換到IronPDF時,最顯著的改變是基本的設計方法。快速報告使用基於帶狀的視覺設計,帶有 .frx 模板檔案和專有概念,如 DataBand、PageHeaderBand 和 RegisterData()。IronPDF使用的是大多數開發人員都已熟知的 HTML/CSS 網頁技術。
這意味著將快速報告頻段組態轉換為 HTML 模板,透過字串插值或 Razor 模板以直接資料綁定取代 RegisterData(),並將 PageHeaderBand/PageFooterBand 轉換為基於 HTML 的頁首和頁尾。
逐步遷移的過程
步驟 1:更新 NuGet 套件
移除所有快速報告套件並安裝 IronPDF:
# Remove all快速報告packages
dotnet remove package FastReport.OpenSource
dotnet remove package FastReport.OpenSource.Export.PdfSimple
dotnet remove package FastReport.OpenSource.Web
dotnet remove package FastReport.OpenSource.Data.MsSql
# InstallIronPDF(includes all features)
dotnet add package IronPdf
# Remove all快速報告packages
dotnet remove package FastReport.OpenSource
dotnet remove package FastReport.OpenSource.Export.PdfSimple
dotnet remove package FastReport.OpenSource.Web
dotnet remove package FastReport.OpenSource.Data.MsSql
# InstallIronPDF(includes all features)
dotnet add package IronPdf
步驟 2:更新命名空間參考資料
用IronPDF取代快速報告命名空間:
// Remove these
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
// Add this
using IronPdf;
// Remove these
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
// Add this
using IronPdf;
Imports IronPdf
步驟 3:配置授權
// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// 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"
完整的 API 遷移參考。
核心類映射
| FastReport 類別 | IronPDF 同等級產品 |
|---|---|
Report |
ChromePdfRenderer |
PDFExport |
ChromePdfRenderer + SecuritySettings |
PDFSimpleExport |
ChromePdfRenderer |
ReportPage |
HTML <body> 或 <div> |
TextObject |
HTML <p>, <span>, <div> |
HTMLObject |
直接 HTML 渲染 |
PageHeaderBand |
HtmlHeaderFooter |
PageFooterBand |
HtmlHeaderFooter |
方法映射
| FastReport 方法 | IronPDF 同等級產品 |
|---|---|
report.Load("template.frx") |
HTML 模板檔案或字串 |
report.RegisterData(data, "name") |
字串插值或 Razor |
report.Prepare() |
不適用 |
report.Export(export, stream) |
pdf.SaveAs(path) |
頁面編號占位符轉換
FastReport 和IronPDF使用不同的頁碼占位符語法:
| 快速報告 | IronPDF |
|---|---|
[Page] |
{page} |
[TotalPages] |
{total-pages} |
程式碼遷移範例
HTML 至 PDF 轉換
本範例展示了快速報告的 HTMLObject 方法與IronPDF的直接渲染之間的基本差異。
FastReport 實作:
// NuGet: Install-Package FastReport.OpenSource
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
class Program
{
static void Main()
{
using (Report report = new Report())
{
// Create HTML object
FastReport.HTMLObject htmlObject = new FastReport.HTMLObject();
htmlObject.Width = 500;
htmlObject.Height = 300;
htmlObject.Text = "<html><body><h1>Hello World</h1><p>This is a test PDF</p></body></html>";
// Prepare report
report.Prepare();
// Export to PDF
PDFSimpleExport pdfExport = new PDFSimpleExport();
using (FileStream fs = new FileStream("output.pdf", FileMode.Create))
{
report.Export(pdfExport, fs);
}
}
}
}
// NuGet: Install-Package FastReport.OpenSource
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
class Program
{
static void Main()
{
using (Report report = new Report())
{
// Create HTML object
FastReport.HTMLObject htmlObject = new FastReport.HTMLObject();
htmlObject.Width = 500;
htmlObject.Height = 300;
htmlObject.Text = "<html><body><h1>Hello World</h1><p>This is a test PDF</p></body></html>";
// Prepare report
report.Prepare();
// Export to PDF
PDFSimpleExport pdfExport = new PDFSimpleExport();
using (FileStream fs = new FileStream("output.pdf", FileMode.Create))
{
report.Export(pdfExport, fs);
}
}
}
}
Imports FastReport
Imports FastReport.Export.PdfSimple
Imports System.IO
Class Program
Shared Sub Main()
Using report As New Report()
' Create HTML object
Dim htmlObject As New FastReport.HTMLObject()
htmlObject.Width = 500
htmlObject.Height = 300
htmlObject.Text = "<html><body><h1>Hello World</h1><p>This is a test PDF</p></body></html>"
' Prepare report
report.Prepare()
' Export to PDF
Dim pdfExport As New PDFSimpleExport()
Using fs As New FileStream("output.pdf", FileMode.Create)
report.Export(pdfExport, fs)
End Using
End Using
End Sub
End Class
IronPDF 實作:
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1><p>This is a test PDF</p></body></html>");
pdf.SaveAs("output.pdf");
}
}
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1><p>This is a test PDF</p></body></html>");
pdf.SaveAs("output.pdf");
}
}
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1><p>This is a test PDF</p></body></html>")
pdf.SaveAs("output.pdf")
End Sub
End Class
FastReport 需要建立一個 Report 物件、一個具有固定尺寸的 HTMLObject、準備報表,以及透過 stream 匯出--七行包含 using 語句的程式碼。IronPDF可在三行內透過直接 HTML 渲染達成相同的結果。 如需更多選項,請參閱 HTML to PDF 文件。
URL 轉 PDF
本範例強調快速報告需要手動下載 HTML,而IronPDF則可原生處理 URL 渲染。
FastReport 實作:
// NuGet: Install-Package FastReport.OpenSource
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
using System.Net;
class Program
{
static void Main()
{
// Download HTML content from URL
string htmlContent;
using (WebClient client = new WebClient())
{
htmlContent = client.DownloadString("https://example.com");
}
using (Report report = new Report())
{
FastReport.HTMLObject htmlObject = new FastReport.HTMLObject();
htmlObject.Width = 800;
htmlObject.Height = 600;
htmlObject.Text = htmlContent;
report.Prepare();
PDFSimpleExport pdfExport = new PDFSimpleExport();
using (FileStream fs = new FileStream("webpage.pdf", FileMode.Create))
{
report.Export(pdfExport, fs);
}
}
}
}
// NuGet: Install-Package FastReport.OpenSource
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
using System.Net;
class Program
{
static void Main()
{
// Download HTML content from URL
string htmlContent;
using (WebClient client = new WebClient())
{
htmlContent = client.DownloadString("https://example.com");
}
using (Report report = new Report())
{
FastReport.HTMLObject htmlObject = new FastReport.HTMLObject();
htmlObject.Width = 800;
htmlObject.Height = 600;
htmlObject.Text = htmlContent;
report.Prepare();
PDFSimpleExport pdfExport = new PDFSimpleExport();
using (FileStream fs = new FileStream("webpage.pdf", FileMode.Create))
{
report.Export(pdfExport, fs);
}
}
}
}
Imports FastReport
Imports FastReport.Export.PdfSimple
Imports System.IO
Imports System.Net
Class Program
Shared Sub Main()
' Download HTML content from URL
Dim htmlContent As String
Using client As New WebClient()
htmlContent = client.DownloadString("https://example.com")
End Using
Using report As New Report()
Dim htmlObject As New FastReport.HTMLObject()
htmlObject.Width = 800
htmlObject.Height = 600
htmlObject.Text = htmlContent
report.Prepare()
Dim pdfExport As New PDFSimpleExport()
Using fs As New FileStream("webpage.pdf", FileMode.Create)
report.Export(pdfExport, fs)
End Using
End Using
End Sub
End Class
IronPDF 實作:
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
}
}
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
}
}
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("webpage.pdf")
End Sub
End Class
FastReport 需要使用 WebClient 手動下載 HTML 內容,然後將其嵌入具有固定尺寸的 HTMLObject 中 - 這是一種無法正確處理 JavaScript 執行或相對資源 URL 的解決方案。IronPDF的 RenderUrlAsPdf 直接使用 Chromium 核心渲染即時網頁並執行完整的 JavaScript 程式碼。更多選項,請參閱PDF 文件的 URL 。
帶有頁碼的頁首和頁尾
本範例展示了快速報告基於波段的系統與IronPDF基於 HTML 的方法之間的複雜性差異。
FastReport 實作:
// NuGet: Install-Package FastReport.OpenSource
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
class Program
{
static void Main()
{
using (Report report = new Report())
{
report.Load("template.frx");
// Set report page properties
FastReport.ReportPage page = report.Pages[0] as FastReport.ReportPage;
// Add page header
FastReport.PageHeaderBand header = new FastReport.PageHeaderBand();
header.Height = 50;
FastReport.TextObject headerText = new FastReport.TextObject();
headerText.Text = "Document Header";
header.Objects.Add(headerText);
page.Bands.Add(header);
// Add page footer
FastReport.PageFooterBand footer = new FastReport.PageFooterBand();
footer.Height = 50;
FastReport.TextObject footerText = new FastReport.TextObject();
footerText.Text = "Page [Page]";
footer.Objects.Add(footerText);
page.Bands.Add(footer);
report.Prepare();
PDFSimpleExport pdfExport = new PDFSimpleExport();
using (FileStream fs = new FileStream("report.pdf", FileMode.Create))
{
report.Export(pdfExport, fs);
}
}
}
}
// NuGet: Install-Package FastReport.OpenSource
using FastReport;
using FastReport.Export.PdfSimple;
using System.IO;
class Program
{
static void Main()
{
using (Report report = new Report())
{
report.Load("template.frx");
// Set report page properties
FastReport.ReportPage page = report.Pages[0] as FastReport.ReportPage;
// Add page header
FastReport.PageHeaderBand header = new FastReport.PageHeaderBand();
header.Height = 50;
FastReport.TextObject headerText = new FastReport.TextObject();
headerText.Text = "Document Header";
header.Objects.Add(headerText);
page.Bands.Add(header);
// Add page footer
FastReport.PageFooterBand footer = new FastReport.PageFooterBand();
footer.Height = 50;
FastReport.TextObject footerText = new FastReport.TextObject();
footerText.Text = "Page [Page]";
footer.Objects.Add(footerText);
page.Bands.Add(footer);
report.Prepare();
PDFSimpleExport pdfExport = new PDFSimpleExport();
using (FileStream fs = new FileStream("report.pdf", FileMode.Create))
{
report.Export(pdfExport, fs);
}
}
}
}
Imports FastReport
Imports FastReport.Export.PdfSimple
Imports System.IO
Class Program
Shared Sub Main()
Using report As New Report()
report.Load("template.frx")
' Set report page properties
Dim page As FastReport.ReportPage = TryCast(report.Pages(0), FastReport.ReportPage)
' Add page header
Dim header As New FastReport.PageHeaderBand()
header.Height = 50
Dim headerText As New FastReport.TextObject()
headerText.Text = "Document Header"
header.Objects.Add(headerText)
page.Bands.Add(header)
' Add page footer
Dim footer As New FastReport.PageFooterBand()
footer.Height = 50
Dim footerText As New FastReport.TextObject()
footerText.Text = "Page [Page]"
footer.Objects.Add(footerText)
page.Bands.Add(footer)
report.Prepare()
Dim pdfExport As New PDFSimpleExport()
Using fs As New FileStream("report.pdf", FileMode.Create)
report.Export(pdfExport, fs)
End Using
End Using
End Sub
End Class
IronPDF 實作:
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
// Configure header and footer
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Document Header</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Report Content</h1><p>This is the main content.</p></body></html>");
pdf.SaveAs("report.pdf");
}
}
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
// Configure header and footer
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Document Header</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Report Content</h1><p>This is the main content.</p></body></html>");
pdf.SaveAs("report.pdf");
}
}
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
' Configure header and footer
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='text-align:center'>Document Header</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
}
Dim pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Report Content</h1><p>This is the main content.</p></body></html>")
pdf.SaveAs("report.pdf")
End Sub
End Class
FastReport 需要載入範本檔案、鑄造頁面物件、建立波段物件、設定高度、建立文字物件、加入波段集合,以及將波段加入頁面。IronPDF使用 HtmlHeaderFooter 和簡單的 HTML 片段-您可以使用完整的 CSS 設定頁首和頁尾樣式。 請注意頁碼語法的變化:[Page] 變為 {page},[TotalPages] 變為 {total-pages}。 如需更多選項,請參閱 headers and footers 文件。
關鍵遷移注意事項
無 .frx 模板檔案
FastReport 模板 (.frx) 無法與IronPDF搭配使用。 將您的版面設計轉換成 HTML/CSS 模板:
//快速報告- loads .frx template
report.Load("report.frx");
//IronPDF- use HTML template
var html = File.ReadAllText("template.html");
var pdf = renderer.RenderHtmlAsPdf(html);
//快速報告- loads .frx template
report.Load("report.frx");
//IronPDF- use HTML template
var html = File.ReadAllText("template.html");
var pdf = renderer.RenderHtmlAsPdf(html);
' 快速報告- loads .frx template
report.Load("report.frx")
' IronPDF- use HTML template
Dim html As String = File.ReadAllText("template.html")
Dim pdf = renderer.RenderHtmlAsPdf(html)
資料綁定轉換
以直接產生 HTML 取代 RegisterData():
// FastReport
report.RegisterData(dataSet, "Data");
report.GetDataSource("Data").Enabled = true;
//IronPDF- use string interpolation or StringBuilder
var html = new StringBuilder();
foreach (var item in data)
{
html.Append($"<tr><td>{item.Name}</td><td>{item.Value}</td></tr>");
}
var pdf = renderer.RenderHtmlAsPdf(html.ToString());
// FastReport
report.RegisterData(dataSet, "Data");
report.GetDataSource("Data").Enabled = true;
//IronPDF- use string interpolation or StringBuilder
var html = new StringBuilder();
foreach (var item in data)
{
html.Append($"<tr><td>{item.Name}</td><td>{item.Value}</td></tr>");
}
var pdf = renderer.RenderHtmlAsPdf(html.ToString());
Imports System.Text
' FastReport
report.RegisterData(dataSet, "Data")
report.GetDataSource("Data").Enabled = True
' IronPDF - use string interpolation or StringBuilder
Dim html As New StringBuilder()
For Each item In data
html.Append($"<tr><td>{item.Name}</td><td>{item.Value}</td></tr>")
Next
Dim pdf = renderer.RenderHtmlAsPdf(html.ToString())
安全設定
//IronPDFsecurity
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.UserPassword = "password";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
//IronPDFsecurity
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.UserPassword = "password";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
'IronPDFsecurity
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SecuritySettings.UserPassword = "password"
pdf.SecuritySettings.OwnerPassword = "ownerPassword"
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
有關全面的安全性選項,請參閱加密文件。
遷移後檢查清單
完成程式碼遷移後,請驗證下列事項:
- 產生PDF檔案的可視化比較
- 核對頁首/頁尾和頁碼
- 使用生產資料量進行測試
- 驗證安全性/加密功能
- 性能基準測試
- 刪除未使用的 .frx 範本文件
- 刪除與快速報告相關的程式碼
- 更新文件
讓您的 PDF 基礎架構面向未來
由於 .NET 10 即將面世,而 C# 14 也將引進新的語言功能,因此選擇一個能接受現代網路技術的 PDF 函式庫,可確保長期的可維護性。IronPDF的 HTML/CSS 方法意味著您的模板可以利用整個 Web 開發中使用的相同技能 - 沒有無法轉換到其他技術的專有帶式概念。 隨著專案延伸至 2025 年和 2026 年,使用具有 CSS3 功能(如 Flexbox 和 Grid)的標準 HTML 模板的能力提供了設計靈活性,這是快速報告的專屬格式所無法比擬的。
其他資源
從快速報告轉換到 IronPDF,可以消除視覺設計師的依賴性、帶狀學習曲線和分散的套件模型。 過渡到以 HTML/CSS 為基礎的 PDF 產生,利用熟悉的網頁技術,同時在單一套件中提供完整的 PDF 操作功能 - 合併、分割、安全性和表單。

