遷移指南

如何在 C# 中從 PDFBolt 轉移到 IronPDF

更新:2026年2月1日

從PDFBolt遷移到 IronPDF，可將您的 .NET PDF 工作流程從具有外部文件處理功能的僅雲端 SaaS 服務轉換為具有完整資料隱私和無限制本地生成功能的自託管庫。本指南提供全面、逐步的遷移路徑，可消除網路依賴、使用限制和外部資料傳輸，同時獲得PDFBolt無法提供的 PDF 操作功能。

為什麼要從PDFBolt轉移到 IronPDF？

僅限雲端問題

PDFBolt 是雲端 SaaS 平台，可在外部伺服器上處理您的文件。雖然對快速原型來說很方便，但這種架構對生產應用程式造成很大的挑戰：

1.僅雲端處理：每個文件都透過外部伺服器處理－沒有自架選項，這可能會阻礙那些需要更多控制其資料和流程的企業。

2.資料隱私風險：敏感文件（合約、醫療記錄、財務資料）必須向外傳輸。處理敏感資訊的公司會有合理的顧慮。

3.使用限制：免費套餐每月最多只能上傳 100 個文檔，這對於規模較大的企業來說可能不夠用。按文件付費的價格對於生產工作量來說增加得很快。

4.網路依賴：網路中斷或PDFBolt服務中斷意味著 PDF 產生將完全停止。

5.延遲：與本地處理相比，網路往返會使每次轉換增加幾秒鐘。

6.合規性問題： GDPR、HIPAA 和 SOC2 審計因外部文件處理而變得複雜。

API 金鑰安全：洩漏的 API 金鑰可能導致未經授權的使用，並被計入您的帳戶。

8.供應商鎖定：如果PDFBolt更改條款或關閉，您的應用程式將無法運作。

PDFBolt與IronPDF比較

關注事項	PDFBolt	IronPDF
資料位置	外部伺服器	僅限您的伺服器
使用限制	100 免費，然後按文件收費	無限制
需要互聯網	是的，總是	無
交稿時間	網路往返	毫秒
合規性	複雜（外部處理）	簡單（本地處理）
成本模式	每個文件	一次性或年度
離線操作	不可能	完全支援
API 關鍵風險	洩漏 = 帳單	授權金鑰，無帳務風險

對於計劃在 2025 年和 2026 年之前採用 .NET 10 和 C# 14 的團隊而言，IronPDF 提供了一個自託管的基礎，可確保完整的資料隱私，並消除對外部雲端服務的依賴。

開始之前

先決條件

.NET環境： .NET Framework 4.6.2+ 或.NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet存取權限：能夠安裝NuGet套件
IronPDF許可證：請從IronPDF取得您的許可證密鑰。

NuGet 套件變更

# Remove PDFBolt
dotnet remove package PDFBolt

# Install IronPDF
dotnet add package IronPdf

# Remove PDFBolt
dotnet remove package PDFBolt

# Install IronPDF
dotnet add package IronPdf

SHELL

授權組態

// 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"

$vbLabelText $csharpLabel

辨識PDFBolt使用方式

# Find allPDFBoltreferences
grep -r "PDFBolt\|HtmlToPdfConverter\|ConvertHtmlString\|ConvertUrl" --include="*.cs" .

# Find API key references
grep -r "PDFBOLT\|ApiKey" --include="*.cs" --include="*.json" --include="*.config" .

# Find allPDFBoltreferences
grep -r "PDFBolt\|HtmlToPdfConverter\|ConvertHtmlString\|ConvertUrl" --include="*.cs" .

# Find API key references
grep -r "PDFBOLT\|ApiKey" --include="*.cs" --include="*.json" --include="*.config" .

SHELL

完整的 API 參考資料

核心類對應

PDFBolt	IronPDF
`new HtmlToPdfConverter()`	`new ChromePdfRenderer()`
`PageSize`	`PdfPaperSize`
(返回 byte[])	`PdfDocument`

轉換方法對應

PDFBolt	IronPDF
`converter.ConvertHtmlString(html)`	`renderer.RenderHtmlAsPdf(html)`
`converter.ConvertUrl(url)`	`renderer.RenderUrlAsPdf(url)`

輸出方法對應

PDFBolt	IronPDF
`File.WriteAllBytes(path, pdf)`	`pdf.SaveAs(path)`
(pdf is byte[])	`pdf.BinaryData`
(手動串流)	`pdf.Stream`

頁面組態對應

PDFBolt	IronPDF
`converter.PageSize = PageSize.A4`	`renderer.RenderingOptions.PaperSize = PdfPaperSize.A4`
`converter.MarginTop = 20`	`renderer.RenderingOptions.MarginTop = 20`
`converter.MarginBottom = 20`	`renderer.RenderingOptions.MarginBottom = 20`
`converter.MarginLeft = 15`	`renderer.RenderingOptions.MarginLeft = 15`
`converter.MarginRight = 15`	`renderer.RenderingOptions.MarginRight = 15`

頁首/頁尾占位符對應

PDFBolt	IronPDF
`{pageNumber}`	`{page}`
`{totalPages}`	`{total-pages}`
`{date}`	`{date}`
`{title}`	`{html-title}`

程式碼遷移範例

範例 1：基本 HTML 到 PDF

之前 (PDFBolt)：

// NuGet: Install-Package PDFBolt
using PDFBolt;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = converter.ConvertHtmlString(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

// NuGet: Install-Package PDFBolt
using PDFBolt;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = converter.ConvertHtmlString(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

Imports PDFBolt
Imports System.IO

Class Program
    Shared Sub Main()
        Dim converter = New HtmlToPdfConverter()
        Dim html = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = converter.ConvertHtmlString(html)
        File.WriteAllBytes("output.pdf", pdf)
    End Sub
End Class

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports System.IO

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim html = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

這裡的基本差異是回傳類型和儲存模式。PDFBolt的 HtmlToPdfConverter.ConvertHtmlString() 傳回一個 byte[]，您必須使用 File.WriteAllBytes() 手動將其寫入磁碟。這需要導入 System.IO 並自行處理文件操作。

IronPDF 的 ChromePdfRenderer.RenderHtmlAsPdf() 傳回一個 PdfDocument 對象，該物件具有內建的 SaveAs() 方法。這種物件導向的方法提供了額外的好處：您可以在儲存之前對 PDF 進行操作（新增水印、合併文件、新增安全性）。如果您需要原始位元組以與現有程式碼相容，請使用 pdf.BinaryData。請參閱 HTML to PDF 文件，以瞭解其他渲染選項。

範例 2：URL 到 PDF 的轉換

之前 (PDFBolt)：

// NuGet: Install-Package PDFBolt
using PDFBolt;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var pdf = converter.ConvertUrl("https://www.example.com");
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

// NuGet: Install-Package PDFBolt
using PDFBolt;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var pdf = converter.ConvertUrl("https://www.example.com");
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

Imports PDFBolt
Imports System.IO

Class Program
    Shared Sub Main()
        Dim converter = New HtmlToPdfConverter()
        Dim pdf = converter.ConvertUrl("https://www.example.com")
        File.WriteAllBytes("webpage.pdf", pdf)
    End Sub
End Class

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.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://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

PDFBolt 的 URL 轉換模式與 HTML 轉換遵循相同的方法：ConvertUrl() 返回 byte[]，需要 File.WriteAllBytes() 才能儲存。請注意，儘管您已經從 URL 抓取，PDFBolt 仍然需要透過網路往返其伺服器。

IronPDF 的 RenderUrlAsPdf() 方法傳回一個 PdfDocument，其中包含內建的 SaveAs() 方法。這方面的主要優勢在於IronPDF在本機執行 URL 抓取和 PDF 渲染 - 資料不會離開您的基礎架構。請注意，對於這種簡單的情況，IronPDF 版本甚至不需要 using System.IO;。進一步了解 URL 至 PDF 轉換。

範例 3：自訂頁面設定的 HTML 檔案

之前 (PDFBolt)：

// NuGet: Install-Package PDFBolt
using PDFBolt;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.PageSize = PageSize.A4;
        converter.MarginTop = 20;
        converter.MarginBottom = 20;
        var html = File.ReadAllText("input.html");
        var pdf = converter.ConvertHtmlString(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

// NuGet: Install-Package PDFBolt
using PDFBolt;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.PageSize = PageSize.A4;
        converter.MarginTop = 20;
        converter.MarginBottom = 20;
        var html = File.ReadAllText("input.html");
        var pdf = converter.ConvertHtmlString(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

Imports PDFBolt
Imports System.IO

Class Program
    Shared Sub Main()
        Dim converter As New HtmlToPdfConverter()
        converter.PageSize = PageSize.A4
        converter.MarginTop = 20
        converter.MarginBottom = 20
        Dim html As String = File.ReadAllText("input.html")
        Dim pdf As Byte() = converter.ConvertHtmlString(html)
        File.WriteAllBytes("output.pdf", pdf)
    End Sub
End Class

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        var html = File.ReadAllText("input.html");
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        var html = File.ReadAllText("input.html");
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Rendering
Imports System.IO

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20
        Dim html = File.ReadAllText("input.html")
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

本範例展示頁面配置差異。PDFBolt直接在轉換器物件上設定屬性（converter.PageSize，converter.MarginTop）。IronPDF在渲染器上使用 RenderingOptions 物件（renderer.RenderingOptions.PaperSize，renderer.RenderingOptions.MarginTop）。

關鍵對應：

PageSize.A4 → PdfPaperSize.A4（不同的枚舉名稱）
MarginTop = 20 → RenderingOptions.MarginTop = 20（透過 RenderingOptions）

兩者都使用毫米作為邊界值，因此您現有的邊界值應可直接轉換。需要 IronPdf.Rendering 命名空間才能存取 PdfPaperSize 枚舉。如需其他頁面設定選項，請參閱渲染選項說明文件。

關鍵遷移注意事項

返回類型變更

PDFBolt 直接返回 byte[]；IronPDF返回 PdfDocument:

//PDFBoltpattern:
byte[] pdf = converter.ConvertHtmlString(html);
File.WriteAllBytes("output.pdf", pdf);

//IronPDFpattern:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// Or if you need bytes:
byte[] pdfBytes = renderer.RenderHtmlAsPdf(html).BinaryData;

//PDFBoltpattern:
byte[] pdf = converter.ConvertHtmlString(html);
File.WriteAllBytes("output.pdf", pdf);

//IronPDFpattern:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// Or if you need bytes:
byte[] pdfBytes = renderer.RenderHtmlAsPdf(html).BinaryData;

'PDFBoltpattern:
Dim pdf As Byte() = converter.ConvertHtmlString(html)
File.WriteAllBytes("output.pdf", pdf)

'IronPDFpattern:
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")

' Or if you need bytes:
Dim pdfBytes As Byte() = renderer.RenderHtmlAsPdf(html).BinaryData

$vbLabelText $csharpLabel

類別命名變更

主類別名稱從以轉換器為主變為以呈現器為主：

// PDFBolt
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

// PDFBolt
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

' PDFBolt
Dim converter As New HtmlToPdfConverter()

' IronPDF
Dim renderer As New ChromePdfRenderer()

$vbLabelText $csharpLabel

設定模式變更

PDFBolt 使用直接屬性；IronPDF使用 RenderingOptions:

// PDFBolt: Direct properties
converter.PageSize = PageSize.A4;
converter.MarginTop = 20;

// IronPDF: Via RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;

// PDFBolt: Direct properties
converter.PageSize = PageSize.A4;
converter.MarginTop = 20;

// IronPDF: Via RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;

' PDFBolt: Direct properties
converter.PageSize = PageSize.A4
converter.MarginTop = 20

' IronPDF: Via RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20

$vbLabelText $csharpLabel

API 關鍵詞消除

PDFBolt 需要按要求進行 API 金鑰管理；IronPDF使用一次性授權金鑰：

// PDFBolt: API key per client (security risk if leaked)
var apiKey = config["PDFBolt:ApiKey"];
var client = new Client(apiKey);

// IronPDF: License key once at startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
var renderer = new ChromePdfRenderer();

// PDFBolt: API key per client (security risk if leaked)
var apiKey = config["PDFBolt:ApiKey"];
var client = new Client(apiKey);

// IronPDF: License key once at startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
var renderer = new ChromePdfRenderer();

' PDFBolt: API key per client (security risk if leaked)
Dim apiKey = config("PDFBolt:ApiKey")
Dim client = New Client(apiKey)

' IronPDF: License key once at startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim renderer = New ChromePdfRenderer()

$vbLabelText $csharpLabel

移除網路錯誤處理

本地處理意味著不需要處理網路錯誤：

// PDFBolt: Network error handling required
catch (HttpRequestException ex)
catch (TaskCanceledException)
catch (TimeoutException)

// IronPDF: Remove network-specific catches entirely

// PDFBolt: Network error handling required
catch (HttpRequestException ex)
catch (TaskCanceledException)
catch (TimeoutException)

// IronPDF: Remove network-specific catches entirely

$vbLabelText $csharpLabel

可用的新功能

轉移到IronPDF之後，您將獲得PDFBolt無法提供的功能：

// PDF Merging (not available in PDFBolt)
var merged = PdfDocument.Merge(pdf1, pdf2);

// Watermarks (not available in PDFBolt)
pdf.ApplyWatermark("<h1 style='opacity:0.3;'>DRAFT</h1>");

// Password Protection (not available in PDFBolt)
pdf.SecuritySettings.UserPassword = "secret";

// Text Extraction (not available in PDFBolt)
string text = pdf.ExtractAllText();

// PDF to Images (not available in PDFBolt)
pdf.RasterizeToImageFiles("page_*.png");

// PDF Merging (not available in PDFBolt)
var merged = PdfDocument.Merge(pdf1, pdf2);

// Watermarks (not available in PDFBolt)
pdf.ApplyWatermark("<h1 style='opacity:0.3;'>DRAFT</h1>");

// Password Protection (not available in PDFBolt)
pdf.SecuritySettings.UserPassword = "secret";

// Text Extraction (not available in PDFBolt)
string text = pdf.ExtractAllText();

// PDF to Images (not available in PDFBolt)
pdf.RasterizeToImageFiles("page_*.png");

' PDF Merging (not available in PDFBolt)
Dim merged = PdfDocument.Merge(pdf1, pdf2)

' Watermarks (not available in PDFBolt)
pdf.ApplyWatermark("<h1 style='opacity:0.3;'>DRAFT</h1>")

' Password Protection (not available in PDFBolt)
pdf.SecuritySettings.UserPassword = "secret"

' Text Extraction (not available in PDFBolt)
Dim text As String = pdf.ExtractAllText()

' PDF to Images (not available in PDFBolt)
pdf.RasterizeToImageFiles("page_*.png")

$vbLabelText $csharpLabel

疑難排解

問題 1：HtmlToPdfConverter 未找到

問題：IronPDF中不存在 HtmlToPdfConverter 類別。

解：使用 ChromePdfRenderer:

// PDFBolt
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

// PDFBolt
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

' PDFBolt
Dim converter As New HtmlToPdfConverter()

' IronPDF
Dim renderer As New ChromePdfRenderer()

$vbLabelText $csharpLabel

問題 2：未找到 ConvertHtmlString。

問題： ConvertHtmlString() 方法不存在。

解：使用 RenderHtmlAsPdf():

// PDFBolt
var pdf = converter.ConvertHtmlString(html);

// IronPDF
var pdf = renderer.RenderHtmlAsPdf(html);

// PDFBolt
var pdf = converter.ConvertHtmlString(html);

// IronPDF
var pdf = renderer.RenderHtmlAsPdf(html);

' PDFBolt
Dim pdf = converter.ConvertHtmlString(html)

' IronPDF
Dim pdf = renderer.RenderHtmlAsPdf(html)

$vbLabelText $csharpLabel

問題 3：未找到 ConvertUrl。

問題： ConvertUrl() 方法不存在。

解決方案：使用 RenderUrlAsPdf():

// PDFBolt
var pdf = converter.ConvertUrl(url);

// IronPDF
var pdf = renderer.RenderUrlAsPdf(url);

// PDFBolt
var pdf = converter.ConvertUrl(url);

// IronPDF
var pdf = renderer.RenderUrlAsPdf(url);

' PDFBolt
Dim pdf = converter.ConvertUrl(url)

' IronPDF
Dim pdf = renderer.RenderUrlAsPdf(url)

$vbLabelText $csharpLabel

問題 4：未找到 PageSize 枚數

問題： PageSize 枚舉不存在。

解決方案：使用來自 IronPdf.Rendering 的 PdfPaperSize：

// PDFBolt
converter.PageSize = PageSize.A4;

// IronPDF
using IronPdf.Rendering;
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

// PDFBolt
converter.PageSize = PageSize.A4;

// IronPDF
using IronPdf.Rendering;
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

' PDFBolt
converter.PageSize = PageSize.A4

' IronPDF
Imports IronPdf.Rendering
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

$vbLabelText $csharpLabel

問題 5：第一次產生 PDF 的速度很慢

問題：初始渲染時間比預期長。

解決方案： Chromium 引擎在首次使用時初始化。如有需要，請事先預熱：

// Warm up during application startup
var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf("<html><body></body></html>");

// Warm up during application startup
var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf("<html><body></body></html>");

' Warm up during application startup
Dim renderer As New ChromePdfRenderer()
renderer.RenderHtmlAsPdf("<html><body></body></html>")

$vbLabelText $csharpLabel

遷移清單

預遷移

清點程式碼庫中所有PDFBolt的使用情況
記錄目前頁面配置設定（頁面大小、邊距）
識別要移除的 API 金鑰管理程式碼
列出任何要刪除的速率限製或網路錯誤處理程序
取得IronPDF許可證密鑰

套件變更

刪除 PDFBolt NuGet 套件安裝 IronPdf NuGet 套件：dotnet add package IronPdf
新增 using IronPdf; 命名空間
新增 using IronPdf.Rendering; 表示紙張尺寸枚舉

程式碼變更

在啟動時新增許可證金鑰配置
將 HtmlToPdfConverter 替換為 ChromePdfRenderer
將 ConvertHtmlString() 替換為 RenderHtmlAsPdf()
將 ConvertUrl() 替換為 RenderUrlAsPdf()
將 File.WriteAllBytes() 替換為 pdf.SaveAs()
將 PageSize 更新為 RenderingOptions.PaperSize
將邊距屬性更新為 RenderingOptions.MarginTop 等。
移除 API 金鑰管理程式碼
移除速率限制處理程式碼
移除網路錯誤處理

後遷移

從設定檔中刪除 API 金鑰
從金鑰管理員移除 API 金鑰
執行所有測試，比較 PDF 輸出
驗證頁面尺寸和邊距是否正確顯示。
考慮新增功能（浮水印、安全、合併）

Curtis Chau

立即與工程團隊聊天

技術作家

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

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

更新2026年2月1日

如何用 C# 從 ZetPDF 轉移到 IronPDF

透過這份完整的 C# 指南，掌握從 ZetPDF 到 IronPDF 的轉換。從一個基於坐標的函式庫轉換到一個現代化的 HTML-to-PDF 解決方案。包括 HTML 轉換、合併 PDF 和移除 PDFSharp 依賴關係的程式碼範例。

更新2026年2月1日

如何在 C# 中從 Scryber.Core 遷移到 IronPDF

透過這份完整的 C# 指南，掌握從 Scryber.Core 到 IronPDF 的轉換。從自訂的 XML/HTML 解析轉換到現代的 Chromium 渲染器。包含 HTML 轉換、URL 呈現以及取代專屬綁定的程式碼範例。

更新2026年2月1日

如何在 C# 中從 XFINIUM.PDF 轉移到 IronPDF

透過這份完整的 C# 指南，掌握從 XFINIUM.PDF 到 IronPDF 的轉換。從基於坐標的手動定位轉換到宣告式 HTML/CSS 渲染。包括取代圖形基元和自動佈局的程式碼範例。

如何在 C# 中從 PDF Duo 遷移到 IronPDF

如何用 C# 從 Nutrient.io 轉移...

開始 30 天免費試用

如何在 C# 中從 PDFBolt 轉移到 IronPDF

為什麼要從PDFBolt轉移到 IronPDF？

僅限雲端問題

PDFBolt與IronPDF比較

開始之前

先決條件

NuGet 套件變更

授權組態

辨識PDFBolt使用方式

完整的 API 參考資料

核心類對應

轉換方法對應

輸出方法對應

頁面組態對應

頁首/頁尾占位符對應

程式碼遷移範例

範例 1：基本 HTML 到 PDF

範例 2：URL 到 PDF 的轉換

範例 3：自訂頁面設定的 HTML 檔案

關鍵遷移注意事項

返回類型變更

類別命名變更

設定模式變更

API 關鍵詞消除

移除網路錯誤處理

可用的新功能

疑難排解

問題 1：HtmlToPdfConverter 未找到

問題 2：未找到 ConvertHtmlString。

問題 3：未找到 ConvertUrl。

問題 4：未找到 PageSize 枚數

問題 5：第一次產生 PDF 的速度很慢

遷移清單

預遷移

套件變更

程式碼變更

後遷移

相關文章

如何用 C# 從 ZetPDF 轉移到 IronPDF

如何在 C# 中從 Scryber.Core 遷移到 IronPDF

如何在 C# 中從 XFINIUM.PDF 轉移到 IronPDF

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

深受全球數百萬工程師信賴

鋼鐵支援團隊