影片

如何使用 C# 消除 PDF 中的文字和區域

已更新:2026年7月19日

遷移從PeachPDF到IronPDF提供了企業級PDF生成的存取，具有全面的功能、持續的開發和專業支援。本指南提供了一個逐步遷移的路徑，從PeachPDF的1.0前異步HTML到PDF工作流程，到更完整的PDF解決方案，具有Chromium渲染、安全設定和文件操作API。

為什麼從PeachPDF遷移到IronPDF

了解PeachPDF

PeachPDF是.NET生態系中的一個相對較新的參與者，專為需要將HTML轉換為PDF的開發人員設計。作為一個程式庫，PeachPDF保證一個純.NET實現，通過不依賴於外部流程來與眾不同，確保它可以無縫整合在.NET支持的平台上。這一特點使PeachPDF成為尋求輕量級且受控程式庫解決方案的專案的吸引選擇。

儘管PeachPDF具有潛力，但仍在開發中，展示了令人興奮的可能性和顯著的限制。由於它的純淨.NET核心，PeachPDF仍然很吸引人，承諾可以在多樣的環境中輕鬆部署。然而，它也導致了有限的採用，較小的使用者基礎和社區驅動的支持。

PeachPDF的局限性

PeachPDF是一個由單一維護者維護的1.0前.NET程式庫（最新jhaygood86以BSD-3-Clause許可發布。它缺乏成熟度、功能和已建立解決方案的支持。遷移的主要原因：

1.0前功能集： PeachPDF沒有內建的數位簽名、PDF/A合規、OCR、表單填寫或頁級頁眉/頁腳API。
沒有JavaScript引擎： PeachPDF是一個基於PeachPDF.PdfSharpCore的佈局渲染器，不是瀏覽器；腳本和複雜的網格/彈性佈局不會執行。
net8.0 只支持： 該包針對net8.0；舊的.NET Framework / .NET 6專案需要升級或選擇不同的程式庫。
小社群： 單一GitHub維護者，有限的文件，有限的範例。
未提供企業支持： 沒有商業支持或SLA選項。

PeachPDF與IronPDF的比較

功能/特點	PeachPDF	IronPDF
實現	純受控.NET (在`PeachPDF.PdfSharpCore` + SixLabors上)	受控並內嵌Chromium運行時
授權	BSD-3-Clause	商業
目標框架	`net8.0` 只支持	.NET Framework 4.6.2+, .NET 6/7/8
使用者基礎	小 (1.0前，`0.7.26` 於2025年10月發布)	大
支援	使用者驅動（單一維護者，`jhaygood86`）	專業並擁有專門的支持
HTML渲染	PDFSharpCore上的HTML+CSS佈局引擎	完整的Chromium
CSS 支援	HTML+CSS子集，網字體，`@font-face`	完整支持 CSS3
JavaScript	不執行	完整的ES2024
數位簽名	否	是
PDF/A合規性	否	是
文件	有限的（單一README）	廣泛的
開發狀態	1.0前（`0.7.26`，2025年10月）	成熟的，穩定的版本

IronPDF以更廣泛的功能脫穎而出，不僅支持HTML到PDF轉換，還提供OCR、浮水印及其他高級功能。其專業支持結構提供了開發人員遇到問題的快速解決途徑。

對於採用現代.NET的團隊，IronPDF提供了全面的功能和持續的維護，以支持不同版本.NET的長期穩定性。

開始之前

前提條件

.NET環境：.NET Framework 4.6.2+ 或.NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet存取： 有能力安裝NuGet套件
IronPDF授權： 從ironpdf.com獲取您的授權金鑰

NuGet包變更

# Remove PeachPDF
dotnet remove package PeachPDF

# Install IronPDF
dotnet add package IronPdf

# Remove PeachPDF
dotnet remove package PeachPDF

# Install IronPDF
dotnet add package IronPdf

SHELL

授權配置

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

$vbLabelText $csharpLabel

識別PeachPDF使用情況

# Audit PeachPDF usage in codebase
grep -r "using PeachPDF" --include="*.cs" .
grep -r "PdfGenerator\|PdfGenerateConfig\|GeneratePdf" --include="*.cs" .

# Audit PeachPDF usage in codebase
grep -r "using PeachPDF" --include="*.cs" .
grep -r "PdfGenerator\|PdfGenerateConfig\|GeneratePdf" --include="*.cs" .

SHELL

完整API參考

名稱空間變更

// Before: PeachPDF
using PeachPDF;
using PeachPDF.PdfSharpCore;
using System.IO;
using System.Threading.Tasks;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

// Before: PeachPDF
using PeachPDF;
using PeachPDF.PdfSharpCore;
using System.IO;
using System.Threading.Tasks;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

Imports IronPdf
Imports IronPdf.Rendering
Imports System.IO
Imports System.Threading.Tasks

$vbLabelText $csharpLabel

核心API對應

PeachPDF	IronPDF
`new PdfGenerator()`	`new ChromePdfRenderer()`
`await generator.GeneratePdf(html, config)`	`renderer.RenderHtmlAsPdf(html)`
`document.Save(stream)`	`pdf.SaveAs(path)`
`document.Save(memStream)` 然後 `memStream.ToArray()`	`pdf.BinaryData`
`new PdfGenerateConfig { NetworkAdapter = new HttpClientNetworkAdapter(...) }`	`renderer.RenderUrlAsPdf(url)`
`config.PageSize`, `config.PageOrientation`	`renderer.RenderingOptions.PaperSize`, `.PaperOrientation`
嵌入在源HTML中（CSS `position: fixed`）	`RenderingOptions.HtmlHeader` / `HtmlFooter`
不支持	`PdfDocument.FromFile(path)`
不支持	`PdfDocument.Merge(pdfs)` / `pdf.AppendPdf(...)`

程式碼遷移範例

範例1：HTML字串轉PDF

之前（PeachPDF）：

using PeachPDF;
using PeachPDF.PdfSharpCore;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var html = "<html><body><h1>Hello World</h1></body></html>";

        var config = new PdfGenerateConfig
        {
            PageSize = PageSize.Letter,
            PageOrientation = PageOrientation.Portrait
        };

        var generator = new PdfGenerator();
        var document = await generator.GeneratePdf(html, config);

        using var stream = File.Create("output.pdf");
        document.Save(stream);
    }
}

using PeachPDF;
using PeachPDF.PdfSharpCore;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var html = "<html><body><h1>Hello World</h1></body></html>";

        var config = new PdfGenerateConfig
        {
            PageSize = PageSize.Letter,
            PageOrientation = PageOrientation.Portrait
        };

        var generator = new PdfGenerator();
        var document = await generator.GeneratePdf(html, config);

        using var stream = File.Create("output.pdf");
        document.Save(stream);
    }
}

Imports PeachPDF
Imports PeachPDF.PdfSharpCore
Imports System.IO
Imports System.Threading.Tasks

Module Program
    Async Function Main() As Task
        Dim html As String = "<html><body><h1>Hello World</h1></body></html>"

        Dim config As New PdfGenerateConfig With {
            .PageSize = PageSize.Letter,
            .PageOrientation = PageOrientation.Portrait
        }

        Dim generator As New PdfGenerator()
        Dim document = Await generator.GeneratePdf(html, config)

        Using stream As FileStream = File.Create("output.pdf")
            document.Save(stream)
        End Using
    End Function
End Module

$vbLabelText $csharpLabel

之後（IronPDF）：

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

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;

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

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

此範例展示了兩個程式庫之間的基本區別。 PeachPDF分開Stream。 IronPDF使用SaveAs()方法。

IronPDF方法的實際優勢在於，FileStream。參見HTML到PDF文件獲取更多範例。

範例2：URL轉PDF轉換

之前（PeachPDF）：

// PeachPDF has no ConvertUrl-style helper; URL fetching is wired via
// HttpClientNetworkAdapter and passing null HTML so the engine fetches the page.
using PeachPDF;
using PeachPDF.Network;
using PeachPDF.PdfSharpCore;
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var http = new HttpClient();

        var config = new PdfGenerateConfig
        {
            PageSize = PageSize.Letter,
            NetworkAdapter = new HttpClientNetworkAdapter(http, new Uri("https://www.example.com"))
        };

        var generator = new PdfGenerator();
        var document = await generator.GeneratePdf(null, config);

        using var stream = File.Create("webpage.pdf");
        document.Save(stream);
    }
}

// PeachPDF has no ConvertUrl-style helper; URL fetching is wired via
// HttpClientNetworkAdapter and passing null HTML so the engine fetches the page.
using PeachPDF;
using PeachPDF.Network;
using PeachPDF.PdfSharpCore;
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var http = new HttpClient();

        var config = new PdfGenerateConfig
        {
            PageSize = PageSize.Letter,
            NetworkAdapter = new HttpClientNetworkAdapter(http, new Uri("https://www.example.com"))
        };

        var generator = new PdfGenerator();
        var document = await generator.GeneratePdf(null, config);

        using var stream = File.Create("webpage.pdf");
        document.Save(stream);
    }
}

Imports PeachPDF
Imports PeachPDF.Network
Imports PeachPDF.PdfSharpCore
Imports System
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

Module Program
    Async Function Main() As Task
        Dim http As New HttpClient()

        Dim config As New PdfGenerateConfig With {
            .PageSize = PageSize.Letter,
            .NetworkAdapter = New HttpClientNetworkAdapter(http, New Uri("https://www.example.com"))
        }

        Dim generator As New PdfGenerator()
        Dim document = Await generator.GeneratePdf(Nothing, config)

        Using stream = File.Create("webpage.pdf")
            document.Save(stream)
        End Using
    End Function
End Module

$vbLabelText $csharpLabel

之後（IronPDF）：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf
Imports System

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

$vbLabelText $csharpLabel

PeachPDF沒有一個一級的URL到PDF的助手；您將配置上的null HTML，以便引擎提取頁面。 IronPDF直接提供RenderUrlAsPdf(url)。由於PeachPDF不執行JavaScript，單頁應用程式和動態內容通過網路適配器路線通常無法正確渲染； IronPDF的Chromium引擎可以處理現代CSS和JavaScript。在我們的教程中了解更多。

範例3：新增頁眉和頁腳

之前（PeachPDF）：

// PeachPDF v0.7.x has no header/footer API. The closest approach is
// to embed the header/footer markup directly inside the source HTML
// using CSS positioning.
using PeachPDF;
using PeachPDF.PdfSharpCore;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var html = @"
            <html><head><style>
              .header { position: fixed; top: 0; left: 0; right: 0; text-align:center; }
              .footer { position: fixed; bottom: 0; left: 0; right: 0; text-align:center; }
            </style></head>
            <body>
              <div class='header'>My Header</div>
              <h1>Document Content</h1>
              <div class='footer'>Footer text</div>
            </body></html>";

        var config = new PdfGenerateConfig { PageSize = PageSize.Letter };
        var generator = new PdfGenerator();
        var document = await generator.GeneratePdf(html, config);

        using var stream = File.Create("document.pdf");
        document.Save(stream);
    }
}

// PeachPDF v0.7.x has no header/footer API. The closest approach is
// to embed the header/footer markup directly inside the source HTML
// using CSS positioning.
using PeachPDF;
using PeachPDF.PdfSharpCore;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var html = @"
            <html><head><style>
              .header { position: fixed; top: 0; left: 0; right: 0; text-align:center; }
              .footer { position: fixed; bottom: 0; left: 0; right: 0; text-align:center; }
            </style></head>
            <body>
              <div class='header'>My Header</div>
              <h1>Document Content</h1>
              <div class='footer'>Footer text</div>
            </body></html>";

        var config = new PdfGenerateConfig { PageSize = PageSize.Letter };
        var generator = new PdfGenerator();
        var document = await generator.GeneratePdf(html, config);

        using var stream = File.Create("document.pdf");
        document.Save(stream);
    }
}

Imports PeachPDF
Imports PeachPDF.PdfSharpCore
Imports System.IO
Imports System.Threading.Tasks

Module Program
    Async Function Main() As Task
        Dim html As String = "
            <html><head><style>
              .header { position: fixed; top: 0; left: 0; right: 0; text-align:center; }
              .footer { position: fixed; bottom: 0; left: 0; right: 0; text-align:center; }
            </style></head>
            <body>
              <div class='header'>My Header</div>
              <h1>Document Content</h1>
              <div class='footer'>Footer text</div>
            </body></html>"

        Dim config As New PdfGenerateConfig With {.PageSize = PageSize.Letter}
        Dim generator As New PdfGenerator()
        Dim document = Await generator.GeneratePdf(html, config)

        Using stream = File.Create("document.pdf")
            document.Save(stream)
        End Using
    End Function
End Module

$vbLabelText $csharpLabel

之後（IronPDF）：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter() { HtmlFragment = "<div style='text-align:center'>My Header</div>" };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = "<div style='text-align:center'>Page {page}</div>" };
        var html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter() { HtmlFragment = "<div style='text-align:center'>My Header</div>" };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = "<div style='text-align:center'>Page {page}</div>" };
        var html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Rendering
Imports System

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<div style='text-align:center'>My Header</div>"}
        renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {.HtmlFragment = "<div style='text-align:center'>Page {page}</div>"}
        Dim html As String = "<html><body><h1>Document Content</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("document.pdf")
    End Sub
End Module

$vbLabelText $csharpLabel

此範例顯示了關鍵的架構差異。 PeachPDF不在PdfGenerateConfig上暴露頁眉/頁腳API，因此頁面chrome不得不使用CSS定位在源HTML中。 IronPDF使用分配給HtmlHeaderFooter物件，將頁面chrome與文件內容分離。

IronPDF的方法還揭示了一些特性，如{total-pages}佔位符。

注意IronPDF需要的額外命名空間：HtmlHeaderFooter類所需。

關鍵遷移注意事項

產生器/渲染器類變更

PeachPDF使用一對PdfGenerator + PdfGenerateConfig； IronPDF使用單個ChromePdfRenderer：

// PeachPDF
var config = new PdfGenerateConfig { PageSize = PageSize.Letter };
var generator = new PdfGenerator();

// IronPDF
var renderer = new ChromePdfRenderer();

// PeachPDF
var config = new PdfGenerateConfig { PageSize = PageSize.Letter };
var generator = new PdfGenerator();

// IronPDF
var renderer = new ChromePdfRenderer();

' PeachPDF
Dim config As New PdfGenerateConfig With {.PageSize = PageSize.Letter}
Dim generator As New PdfGenerator()

' IronPDF
Dim renderer As New ChromePdfRenderer()

$vbLabelText $csharpLabel

異步與同步，以及返回型別

PeachPDF的Stream的文件。 IronPDF的PdfDocument：

// PeachPDF: async, save to a Stream
var document = await generator.GeneratePdf(html, config);
using var fs = File.Create("output.pdf");
document.Save(fs);

// IronPDF: synchronous PdfDocument object
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Or get bytes: byte[] bytes = pdf.BinaryData;

// PeachPDF: async, save to a Stream
var document = await generator.GeneratePdf(html, config);
using var fs = File.Create("output.pdf");
document.Save(fs);

// IronPDF: synchronous PdfDocument object
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Or get bytes: byte[] bytes = pdf.BinaryData;

Imports System.IO

' PeachPDF: async, save to a Stream
Dim document = Await generator.GeneratePdf(html, config)
Using fs As FileStream = File.Create("output.pdf")
    document.Save(fs)
End Using

' IronPDF: synchronous PdfDocument object
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
' Or get bytes: Dim bytes As Byte() = pdf.BinaryData

$vbLabelText $csharpLabel

頁眉/頁腳屬性變更

// PeachPDF: no header/footer API -- embed in source HTML
// (e.g. via CSS position:fixed)

// IronPDF: HtmlHeaderFooter objects
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div>Header</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div>Footer</div>"
};

// PeachPDF: no header/footer API -- embed in source HTML
// (e.g. via CSS position:fixed)

// IronPDF: HtmlHeaderFooter objects
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div>Header</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div>Footer</div>"
};

' PeachPDF: no header/footer API -- embed in source HTML
' (e.g. via CSS position:fixed)

' IronPDF: HtmlHeaderFooter objects
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div>Header</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div>Footer</div>"
}

$vbLabelText $csharpLabel

方法名稱變更

PeachPDF	IronPDF
`await generator.GeneratePdf(html, config)`	`renderer.RenderHtmlAsPdf(html)`
`NetworkAdapter = new HttpClientNetworkAdapter(...)` + `GeneratePdf(null, config)`	`renderer.RenderUrlAsPdf(url)`
`document.Save(stream)`	`pdf.SaveAs(path)`

遷移後的新能力

遷移到IronPDF後，您將獲得PeachPDF無法提供的功能：

PDF合併

var pdf1 = PdfDocument.FromFile("doc1.pdf");
var pdf2 = PdfDocument.FromFile("doc2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("doc1.pdf");
var pdf2 = PdfDocument.FromFile("doc2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

CONVERTER NOT RUNNING

$vbLabelText $csharpLabel

使用HTML的水印

var pdf = PdfDocument.FromFile("document.pdf");
pdf.ApplyWatermark("<div style='color: red; font-size: 48pt;'>DRAFT</div>");
pdf.SaveAs("watermarked.pdf");

var pdf = PdfDocument.FromFile("document.pdf");
pdf.ApplyWatermark("<div style='color: red; font-size: 48pt;'>DRAFT</div>");
pdf.SaveAs("watermarked.pdf");

Dim pdf = PdfDocument.FromFile("document.pdf")
pdf.ApplyWatermark("<div style='color: red; font-size: 48pt;'>DRAFT</div>")
pdf.SaveAs("watermarked.pdf")

$vbLabelText $csharpLabel

密碼保護

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>");

pdf.SecuritySettings.OwnerPassword = "owner123";
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;

pdf.SaveAs("protected.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>");

pdf.SecuritySettings.OwnerPassword = "owner123";
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;

pdf.SaveAs("protected.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>")

pdf.SecuritySettings.OwnerPassword = "owner123"
pdf.SecuritySettings.UserPassword = "user123"
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint

pdf.SaveAs("protected.pdf")

$vbLabelText $csharpLabel

數位簽名

using IronPdf.Signing;

var pdf = PdfDocument.FromFile("document.pdf");
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningReason = "Document Approval",
    SigningLocation = "New York"
};
pdf.Sign(signature);
pdf.SaveAs("signed.pdf");

using IronPdf.Signing;

var pdf = PdfDocument.FromFile("document.pdf");
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningReason = "Document Approval",
    SigningLocation = "New York"
};
pdf.Sign(signature);
pdf.SaveAs("signed.pdf");

Imports IronPdf.Signing

Dim pdf = PdfDocument.FromFile("document.pdf")
Dim signature = New PdfSignature("certificate.pfx", "password") With {
    .SigningReason = "Document Approval",
    .SigningLocation = "New York"
}
pdf.Sign(signature)
pdf.SaveAs("signed.pdf")

$vbLabelText $csharpLabel

異步操作

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Async PDF</h1>");
pdf.SaveAs("async_output.pdf");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Async PDF</h1>");
pdf.SaveAs("async_output.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Async PDF</h1>")
pdf.SaveAs("async_output.pdf")

$vbLabelText $csharpLabel

功能比較總結

功能	PeachPDF	IronPDF
HTML轉PDF	基於PdfSharpCore的佈局	完整的Chromium
URL到PDF	通過`HttpClientNetworkAdapter`（無JS）	是
CSS Grid/Flexbox	部分/不保證	是
JavaScript	不執行	完整的ES2024
合併PDF	無（僅HTML->PDF）	是
拆分PDF	否	是
浮水印	手動通過HTML	完整HTML
頁眉/頁腳	手動通過HTML/CSS	完整HTML
數位簽名	否	是
PDF/A	否	是
表單填寫	否	是
文字提取	否	是
圖像提取	否	是
異步支援	僅支持異步API	是
跨平臺	`net8.0`（Windows / Linux / macOS）	是

常見遷移問題

問題1：不同的API模式

問題： PeachPDF將PdfGenerateConfig（設置）分開，並且是異步的； IronPDF使用一個PdfDocument。

解決方案：

// PeachPDF pattern (async, stream-out)
var config = new PdfGenerateConfig { PageSize = PageSize.Letter };
var generator = new PdfGenerator();
var document = await generator.GeneratePdf(html, config);
using var fs = File.Create(path);
document.Save(fs);

//IronPDFpattern
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);

// PeachPDF pattern (async, stream-out)
var config = new PdfGenerateConfig { PageSize = PageSize.Letter };
var generator = new PdfGenerator();
var document = await generator.GeneratePdf(html, config);
using var fs = File.Create(path);
document.Save(fs);

//IronPDFpattern
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);

Imports System.IO

' PeachPDF pattern (async, stream-out)
Dim config As New PdfGenerateConfig With {.PageSize = PageSize.Letter}
Dim generator As New PdfGenerator()
Dim document = Await generator.GeneratePdf(html, config)
Using fs As FileStream = File.Create(path)
    document.Save(fs)
End Using

' IronPDF pattern
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs(path)

$vbLabelText $csharpLabel

問題2：保存目標為流，不是路徑

問題： PeachPDF的Stream； IronPDF的pdf.SaveAs(path)接受路徑字串。

解決方案： 在IronPDF中直接使用FileStream。

問題3：無現有PDF操作

問題： PeachPDF僅支持HTML到PDF；它無法載入、合併、拆分或編輯現有PDF。

解決方案： 完成遷移後，使用IronPDF的pdf.AppendPdf替換這些操作。

遷移檢查表

遷移前

審核程式碼庫中的PeachPDF使用情況
記錄自訂配置
記下所有頭/腳的實現
獲取IronPDF授權金鑰來自ironpdf.com
先使用IronPDF試用授權進行測試

套件變更

移除PeachPDF NuGet套件
安裝IronPdf NuGet套件：dotnet add package IronPdf

程式碼變更

更新命名空間引入（using PeachPDF; → using IronPdf;）
為頭/腳的功能新增using IronPdf.Rendering;
將PdfGenerator + ChromePdfRenderer
將RenderHtmlAsPdfAsync以保持異步）
將HttpClientNetworkAdapter + renderer.RenderUrlAsPdf(url)
將pdf.SaveAs(path)
將HTML嵌入的頭/腳替換為HtmlFooter物件
在應用程式啟動時新增授權初始化

遷移後

測試HTML渲染質量
驗證 PDF 輸出符合預期
測試頁核/頁腳渲染及頁碼
根據需要新增新功能（安全性、水印、合併）

請注意PeachPDF是其註冊商標所有者的註冊商標。本網站與PeachPDF沒有關聯、未經其認可或贊助。所有產品名稱、標誌和品牌均為其各自所有者的財產。比較僅供參考，反映撰寫時公開可用的資訊。

Curtis Chau

立即與工程團隊聊天

技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

已更新2026年7月19日

如何在 .NET 10 中使用 C# 將 HTML 轉換為 PDF | IronPDF for .NET

本影片教程將引導您完成使用 IronPDF for .NET 直接從 HTML 生成高品質 PDF 文件的過程。您將學習 IronPDF 如何有效地渲染 HTML、CSS 和圖片，從而輕松高效地生成專業的 PDF。

已更新2026年7月19日

如何用 C# 設置 PDF 的自訂紙張大小 | IronPDF

透過使用 C# 和 IronPDF 渲染具有自訂紙張尺寸的 PDF。本影片指導您如何生成適合非標準模板的 PDF，這對建立個性化文件（如邀請函，海報或自訂報告）來說是理想的選擇。輕鬆提升您的文件建立流程。

已更新2026年7月19日

如何在 C# | IronPDF 中使用 IronPDF 轉換 PDF 頁面

本影片教程全面介紹如何使用 IronPDF for .NET 來操作 PDF 頁面。學習在現有 PDF 文件中旋轉、縮放和重新定位頁面等基本技術，增強您的文件管理和編輯能力。

using IronPDF 在 PDFs 中渲染 WebGL 內容

在 ASP.NET Core MVC 中使用 Iron...

開始免費30天試用

如何使用 C# 消除 PDF 中的文字和區域

為什麼從PeachPDF遷移到IronPDF

了解PeachPDF

PeachPDF的局限性

PeachPDF與IronPDF的比較

開始之前

前提條件

NuGet包變更

授權配置

識別PeachPDF使用情況

完整API參考

名稱空間變更

核心API對應

程式碼遷移範例

範例1：HTML字串轉PDF

範例2：URL轉PDF轉換

範例3：新增頁眉和頁腳

關鍵遷移注意事項

產生器/渲染器類變更

異步與同步，以及返回型別

頁眉/頁腳屬性變更

方法名稱變更

遷移後的新能力

PDF合併

使用HTML的水印

密碼保護

數位簽名

異步操作

功能比較總結

常見遷移問題

問題1：不同的API模式

問題2：保存目標為流，不是路徑

問題3：無現有PDF操作

遷移檢查表

遷移前

套件變更

程式碼變更

遷移後

相關文章

如何在 .NET 10 中使用 C# 將 HTML 轉換為 PDF | IronPDF for .NET

如何用 C# 設置 PDF 的自訂紙張大小 | IronPDF

如何在 C# | IronPDF 中使用 IronPDF 轉換 PDF 頁面

下一步：開始免費30天試用

Thank You

下一步：開始免費30天試用

想免費將 IronSuite 部署到實際專案中嗎？

包含什麼？

您的授權金鑰已經發送到您的收件箱

您的演示請求已提交。

受到全球數百萬工程師的信任

Iron 支援團隊