影片

如何應用自定義 PDF 水印

Curtis Chau
Curtis Chau
Updated: 2026年7月19日

ActivePDF 一直是 .NET 開發人員依賴的 PDF 工具包。 自 PDFTron 於 2020 年 6 月收購並於 2023 年 2 月更名為 Apryse 後，ActivePDF 現在作為更廣泛的 Apryse 組合中的幾個品牌之一。 本指南提供了從ActivePDF遷移到IronPDF的全面、逐步的路徑——一個現代的，積極維護的 .NET PDF 程式庫，支援 .NET Framework 4.6.2 到 .NET 9。

為什麼考慮離開 ActivePDF？

ActivePDF 仍然發貨，Apryse 下的 ActivePDF.Toolkit NuGet 包繼續接收更新，但其設計和包裝的幾個方面可能會促使團隊評估替代方案。

品牌和路線圖考量

ActivePDF 現在是 Apryse 中的一個品牌，與旗艦產品 Apryse SDK 並列。 專門挑選ActivePDF進行伺服器端自動化的團隊可能需要衡量是留在ActivePDFSKUs 還是隨著時間推移轉向更廣泛的 Apryse SDK。

許可模式

ActivePDF 的傳統每伺服器/每核心許可證可能會在跨基礎設施動態擴展應用程式的雲和容器環境中引入摩擦。

傳統的架構模式

ActivePDF 的 API 表面反映了其 COM/原生來源。 CloseOutputFile 工作流程和整數返回程式碼（0 表示成功）需要顯式生命週期管理，這不總是與現代 C# 慣用語如 using、異常和 async 一致。

多SKU產品布局

HTML/URL-to-PDF 渲染存在於單獨的 ActivePDF.WebGrabber 產品中，而 PDF 操作存在於 ActivePDF.Toolkit 中。 從 Toolkit 10 開始，本地程式庫不再自動複製到系統資料夾，因此構造函式通常需要顯式的 CoreLibPath 參數——這種模式會使 Docker、CI 和無安裝程式的部署變得複雜。

##ActivePDFvs. IronPDF：主要區別

在開始遷移過程之前，了解ActivePDF和IronPDF之間的基本區別有助於設定所需程式碼更改的預期。

方面ActivePDFIronPDF
供應商Apryse（前身為 PDFTron，於 2020 年 6 月收購 ActivePDF）Iron Software，自主
產品布局多個 SKU（Toolkit，WebGrabber，DocConverter，Server，Meridian）Single IronPdf NuGet package
安裝NuGet 包 + 本地運行時路徑（CoreLibPath 自 v10 起）單一 NuGet 包; natives bundled
API 模式有狀態的 (CloseOutputFile)，COM 衍生流暢的，功能性 API
許可模式每伺服器/每核心基於程式碼的密鑰
.NET支持.NET Framework 4.5+ / .NET Standard 1.0+ / .NET CoreFramework 4.6.2 到 .NET 9
錯誤處理整數返回程式碼（0 = 成功）標準的.NET異常
異步支援不原生完全的 async/await 支援

遷移前準備

審核您的程式碼庫

在開始遷移之前，識別您解決方案中的所有ActivePDF使用。 真正的命名空間是 APToolkitNET（Toolkit）和 APWebGrabber（WebGrabber）； 一些舊版專案也通過 COM 互操作程式集引用 ActivePDF.Toolkit。 在您的解決方案目錄中運行這些命令：

grep -r "using APToolkitNET" --include="*.cs" .
grep -r "using APWebGrabber" --include="*.cs" .
grep -r "ActivePDF" --include="*.csproj" .
SHELL

文件斷裂變更

了解基本 API 差異有助於規劃遷移策略：

類別ActivePDF 行為IronPDF行為遷移動作
產品分裂Toolkit（操作）+ WebGrabber（HTML 渲染）分別出售單個 IronPdf 包將兩者合併為一個程式庫
物件模型APToolkitNET.Toolkit 用於 PDF，APWebGrabber.WebGrabber 用於 HTMLChromePdfRenderer + PdfDocument分離關注
檔案操作CloseOutputFile()直接 SaveAs()刪除開/關呼叫
本地運行時CoreLibPath 參數自 v10 起NuGet 隨原生介質一同發貨刪除路徑配置
頁面建立NewPage() 方法從 HTML 自動刪除頁面建立呼叫
返回值整數錯誤程式碼異常實施 try/catch
頁面大小單位點（612x792 = 信件）枚舉或毫米更新測量值

前提條件

確保您的環境符合以下要求：

  • .NET Framework 4.6.2+ or .NET Core 3.1 / .NET 5-9
  • Visual Studio 2019+ or JetBrains Rider
  • NuGet包管理器存取 -IronPDF許可證金鑰（免費試用可在 ironpdf.com 獲得）

逐步遷移過程

步驟1：更新NuGet包

nuget.org 上的包是 ActivePDF.Toolkit（目前版本 11.4.4，發布於 2025 年 12 月）。 HTML 渲染單獨作為 ActivePDF.WebGrabber 發送。 移除ActivePDFSKUs 並安裝 IronPDF：

# RemoveActivePDFpackages
dotnet remove package ActivePDF.Toolkit
dotnet remove package ActivePDF.WebGrabber

# Install IronPDF
dotnet add package IronPdf
SHELL

或者，通過 Visual Studio Package Manager Console：

Uninstall-Package ActivePDF.Toolkit
Uninstall-Package ActivePDF.WebGrabber
Install-Package IronPdf
PowerShell

對於具有手動 DLL 參考的專案，從您的 .csproj 檔案中刪除該參考：

<!-- Remove this block -->
<Reference Include="APToolkitNET">
    <HintPath>path\to\APToolkitNET.dll</HintPath>
</Reference>
XML

步驟 2：配置許可證金鑰

在應用程式啟動時，在任何 PDF 操作之前，新增IronPDF許可證金鑰：

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Verify license status
bool isLicensed = IronPdf.License.IsLicensed;

步驟 3：更新命名空間參考

在您的解決方案中執行全域查找和替換：

查找替換為
using APToolkitNET;using IronPdf;
using APWebGrabber;using IronPdf;
APToolkitNET.ToolkitPdfDocument（操作）
APWebGrabber.WebGrabberChromePdfRenderer

完整 API 遷移參考

文件建立方法

ActivePDF 方法IronPDF等價注釋
new APToolkitNET.Toolkit()new ChromePdfRenderer() / new PdfDocument(...)IronPDF 將渲染與操作分開
new Toolkit(CoreLibPath: path)new ChromePdfRenderer()NuGet 隨原生介質一起發送 - 無需 CoreLibPath
toolkit.OpenOutputFile(path)不需要等效只需在末尾呼叫 SaveAs
toolkit.CloseOutputFile()不需要等效using 進行清理
webGrabber.URL = html; webGrabber.ConvertToPDF()renderer.RenderHtmlAsPdf(html)WebGrabber，不是 Toolkit
webGrabber.URL = url; webGrabber.ConvertToPDF()renderer.RenderUrlAsPdf(url)WebGrabber，不是 Toolkit

檔案操作

ActivePDF 方法IronPDF等價注釋
toolkit.OpenInputFile(path)PdfDocument.FromFile(path)載入現有 PDF
toolkit.MergeFile(path, startPage, endPage)PdfDocument.Merge(pdfs)ActivePDF 合併到原地開放的輸出檔案中；IronPDF返回新的合併文件
toolkit.NumPages（屬性）pdf.PageCount頁面計數
toolkit.GetPageText(page, 0)pdf.Pages[i].Text / pdf.ExtractAllText()文字提取

頁面配置

ActivePDF 方法IronPDF等價
toolkit.SetPageSize(612, 792)RenderingOptions.PaperSize = PdfPaperSize.Letter
toolkit.SetOrientation("Landscape")RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
toolkit.SetMargins(t, b, l, r)RenderingOptions.MarginTop/Bottom/Left/Right

安全方法

ActivePDF 方法IronPDF等價
toolkit.SetEncryption(user, owner, 128, 0)pdf.SecuritySettings.OwnerPassword / UserPassword
toolkit.SetPermissions(flags)pdf.SecuritySettings.AllowUserXxx
toolkit.PrintText(x, y, text)（每頁水印）pdf.ApplyWatermark(html)

程式碼遷移範例

HTML到PDF轉換

將 HTML 字串轉換為 PDF 文件是最常見的 PDF 生成方案之一。 請注意，在ActivePDF中，HTML 渲染存在於單獨許可的 WebGrabber 產品中，而不是 Toolkit 中，並且 WebGrabber 不是從記憶體中的字串進行渲染，而是從 URL 或檔案路徑渲染。

ActivePDF 實現（WebGrabber）：

// NuGet: Install-Package ActivePDF.WebGrabber
using APWebGrabber;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        WebGrabber wg = new WebGrabber();

        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        string tempHtml = Path.Combine(Path.GetTempPath(), "input.html");
        File.WriteAllText(tempHtml, htmlContent);

        wg.URL = tempHtml;
        wg.OutputDirectory = Directory.GetCurrentDirectory();
        wg.OutputFilename = "output.pdf";

        if (wg.ConvertToPDF() == 0)
        {
            Console.WriteLine("PDF created successfully");
        }
    }
}

IronPDF實現：

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

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

IronPDF 的方法消除了顯式檔案句柄管理，同時提供了更乾淨、更易於閱讀的程式碼。 對於進階的HTML 到 PDF 場景，IronPDF 的 ChromePdfRenderer 使用基於 Chromium 的渲染引擎提供像素完美的 CSS 和 JavaScript 支援。

URL 到 PDF 轉換

捕捉網頁作為 PDF 文件也在 WebGrabber 中，而不是 Toolkit 中。

ActivePDF 實現（WebGrabber）：

// NuGet: Install-Package ActivePDF.WebGrabber
using APWebGrabber;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        WebGrabber wg = new WebGrabber();

        wg.URL = "https://www.example.com";
        wg.OutputDirectory = Directory.GetCurrentDirectory();
        wg.OutputFilename = "webpage.pdf";

        if (wg.ConvertToPDF() == 0)
        {
            Console.WriteLine("PDF from URL created successfully");
        }
    }
}

IronPDF實現：

using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        string url = "https://www.example.com";
        
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        
        Console.WriteLine("PDF from URL created successfully");
    }
}

合併多個 PDF

將多個 PDF 文件合併為一個檔案展示了IronPDF的功能性文件操作方法。

ActivePDF 實現（Toolkit）：

// NuGet: Install-Package ActivePDF.Toolkit
using APToolkitNET;
using System;

class Program
{
    static void Main()
    {
        using (Toolkit toolkit = new Toolkit())
        {
            if (toolkit.OpenOutputFile("merged.pdf") == 0)
            {
                // MergeFile(FileName, StartPage, EndPage); -1 = end of file
                toolkit.MergeFile("document1.pdf", 1, -1);
                toolkit.MergeFile("document2.pdf", 1, -1);
                toolkit.CloseOutputFile();
                Console.WriteLine("PDFs merged successfully");
            }
        }
    }
}

IronPDF實現：

using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");
        
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
        
        Console.WriteLine("PDFs merged successfully");
    }
}

對於更進階的合併場景，包括選擇性頁面提取，請參見PDF 合併文件。

新增標題和頁腳

ActivePDF 實現（WebGrabber）：

using APWebGrabber;
using System.IO;

public void CreatePdfWithHeaderFooter(string html, string outputPath)
{
    var wg = new WebGrabber();
    string tempHtml = Path.Combine(Path.GetTempPath(), "input.html");
    File.WriteAllText(tempHtml, html);

    wg.URL = tempHtml;
    wg.HeaderText = "My Document";
    wg.FooterText = "Page [page] of [pages]";
    wg.OutputDirectory = Path.GetDirectoryName(outputPath);
    wg.OutputFilename = Path.GetFileName(outputPath);
    wg.ConvertToPDF();
}

IronPDF實現：

using IronPdf;

public void CreatePdfWithHeaderFooter(string html, string outputPath)
{
    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.TextHeader = new TextHeaderFooter
    {
        CenterText = "My Document",
        FontSize = 12,
        FontFamily = "Arial"
    };

    renderer.RenderingOptions.TextFooter = new TextHeaderFooter
    {
        CenterText = "Page {page} of {total-pages}",
        FontSize = 10,
        FontFamily = "Arial"
    };

    using var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(outputPath);
}

IronPDF 支援基於文字和HTML 標題和頁腳，提供完整的設計靈活性。

密碼保護和安全性

ActivePDF 實現（Toolkit）：

using APToolkitNET;

public void ProtectPdf(string inputPath, string outputPath, string password)
{
    using (Toolkit toolkit = new Toolkit())
    {
        if (toolkit.OpenOutputFile(outputPath) == 0
            && toolkit.OpenInputFile(inputPath) == 0)
        {
            toolkit.SetEncryption(password, password, 128, 0);
            toolkit.CopyForm(0, 0);
            toolkit.CloseInputFile();
            toolkit.CloseOutputFile();
        }
    }
}

IronPDF實現：

using IronPdf;

public void ProtectPdf(string inputPath, string outputPath, string password)
{
    using var pdf = PdfDocument.FromFile(inputPath);

    pdf.SecuritySettings.OwnerPassword = password;
    pdf.SecuritySettings.UserPassword = password;
    pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
    pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;

    pdf.SaveAs(outputPath);
}

IronPDF 的安全設置 API 提供對文件許可權的細緻控制，使用強型別枚舉，而不是整數標志。

文字提取

ActivePDF 實現（Toolkit）：

using APToolkitNET;
using System.Text;

public string ExtractText(string pdfPath)
{
    var sb = new StringBuilder();

    using (Toolkit toolkit = new Toolkit())
    {
        if (toolkit.OpenInputFile(pdfPath) == 0)
        {
            int pageCount = toolkit.NumPages;
            for (int i = 1; i <= pageCount; i++)
            {
                sb.AppendLine(toolkit.GetPageText(i, 0));
            }
            toolkit.CloseInputFile();
        }
    }

    return sb.ToString();
}

IronPDF實現：

using IronPdf;

public string ExtractText(string pdfPath)
{
    using var pdf = PdfDocument.FromFile(pdfPath);
    return pdf.ExtractAllText();
}

IronPDF 的實現將文字提取從多行減少到一次方法調用。

新增水印

ActivePDF 實現（Toolkit - 每頁以頁面文字繪製）：

using APToolkitNET;

public void AddWatermark(string inputPath, string outputPath, string watermarkText)
{
    using (Toolkit toolkit = new Toolkit())
    {
        if (toolkit.OpenOutputFile(outputPath) == 0
            && toolkit.OpenInputFile(inputPath) == 0)
        {
            int pageCount = toolkit.NumPages;
            for (int i = 1; i <= pageCount; i++)
            {
                toolkit.CopyForm(i, 0);
                toolkit.SetFont("Helvetica", 72);
                toolkit.SetTextColor(200, 200, 200);
                toolkit.PrintText(150, 400, watermarkText);
            }
            toolkit.CloseInputFile();
            toolkit.CloseOutputFile();
        }
    }
}

IronPDF實現：

using IronPdf;

public void AddWatermark(string inputPath, string outputPath, string watermarkText)
{
    using var pdf = PdfDocument.FromFile(inputPath);

    pdf.ApplyWatermark(
        $"<h1 style='color:lightgray;font-size:72px;'>{watermarkText}</h1>",
        rotation: 45,
        opacity: 50);

    pdf.SaveAs(outputPath);
}

IronPDF 的基於 HTML 的水印允許 CSS 樣式控制，實現完整設計，無需頁面逐一迭代。

ASP.NET Core 整合

現代網頁應用程式顯著受益於IronPDF的更清晰的整合模式。

ActivePDF 模式（WebGrabber）：

[HttpPost]
public IActionResult GeneratePdf([FromBody] ReportRequest request)
{
    var wg = new APWebGrabber.WebGrabber();
    string tempHtml = Path.Combine(Path.GetTempPath(), Guid.NewGuid() + ".html");
    System.IO.File.WriteAllText(tempHtml, request.Html);

    wg.URL = tempHtml;
    wg.OutputDirectory = Path.GetTempPath();
    wg.OutputFilename = "temp.pdf";

    if (wg.ConvertToPDF() == 0)
    {
        byte[] bytes = System.IO.File.ReadAllBytes(Path.Combine(Path.GetTempPath(), "temp.pdf"));
        return File(bytes, "application/pdf", "report.pdf");
    }

    return BadRequest("PDF generation failed");
}

IronPDF模式：

[HttpPost]
public IActionResult GeneratePdf([FromBody] ReportRequest request)
{
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(request.Html);

    return File(pdf.BinaryData, "application/pdf", "report.pdf");
}

IronPDF 消除了臨時檔案的需求，直接從記憶體返回 PDF 二進制資料。

Web 應用程式的異步支援

ActivePDF 缺乏原生的異步支援。IronPDF提供了完全的 async/await 功能，對於可擴展的網頁應用程式至關重要：

using IronPdf;

public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    using var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

依賴注入配置

對於 .NET 6+ 應用程式，註冊IronPDF服務到您的 DI 容器：

// Program.cs (.NET 6+)
builder.Services.AddSingleton<ChromePdfRenderer>();

// Service wrapper
public interface IPdfService
{
    Task<byte[]> GeneratePdfAsync(string html);
    Task<byte[]> GeneratePdfFromUrlAsync(string url);
}

public class IronPdfService : IPdfService
{
    private readonly ChromePdfRenderer _renderer;

    public IronPdfService()
    {
        _renderer = new ChromePdfRenderer();
        _renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        using var pdf = await _renderer.RenderHtmlAsPdfAsync(html);
        return pdf.BinaryData;
    }

    public async Task<byte[]> GeneratePdfFromUrlAsync(string url)
    {
        using var pdf = await _renderer.RenderUrlAsPdfAsync(url);
        return pdf.BinaryData;
    }
}

錯誤處理遷移

ActivePDF 使用的整數返回程式碼需要查閱表。IronPDF使用現代異常處理：

ActivePDF 錯誤處理：

using APToolkitNET;

using (var toolkit = new Toolkit())
{
    int result = toolkit.OpenOutputFile(path);

    if (result != 0)
    {
        // Error - look up the code in "Toolkit Return Results and Error Codes"
        Console.WriteLine($"Error code: {result}");
    }
}

IronPDF 錯誤處理：

try
{
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(path);
}
catch (IronPdf.Exceptions.IronPdfProductException ex)
{
    Console.WriteLine($"IronPDF Error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"General Error: {ex.Message}");
}

性能優化技巧

重用渲染器實例

建立一個新的 ChromePdfRenderer 具有初始化開銷。 對於批量操作，重用單個實例：

var renderer = new ChromePdfRenderer();
foreach (var html in htmlList)
{
    using var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs($"output_{i}.pdf");
}

在 Web 應用程式中使用異步

對於 ASP.NET Core 應用程式，異步 PDF 生成提高了吞吐量：

public async Task<IActionResult> GenerateReport()
{
    var renderer = new ChromePdfRenderer();
    using var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return File(pdf.BinaryData, "application/pdf");
}

正確的資源處置

始終使用 using 陳述以確保適當的清理：

using var pdf = renderer.RenderHtmlAsPdf(html);
return pdf.BinaryData;

圖片壓縮

通過圖片壓縮減少輸出檔案的大小：

using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.CompressImages(85); // 85% quality
pdf.SaveAs("compressed.pdf");

故障排除常見的遷移問題

問題：頁面大小差異

ActivePDF WebGrabber 使用點（612x792 = 信件），而IronPDF使用枚舉或毫米：

//ActivePDFWebGrabber: Points
wg.PageWidth = 612;
wg.PageHeight = 792;

// IronPDF: Use enum
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
// Or custom in mm:
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(215.9, 279.4);

問題：缺少 CloseOutputFile 等效

IronPDF 使用現代範式，無需顯式的檔案句柄管理：

//ActivePDFToolkit
toolkit.OpenOutputFile(path);
// ... operations ...
toolkit.CloseOutputFile(); // Required!

//IronPDF- no open/close needed
using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path); // 'using' handles cleanup

問題：PDF 顯示空白

如果基於 JavaScript 的內容顯示空白，請配置渲染延遲：

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.RenderDelay(2000);
// Or wait for element:
renderer.RenderingOptions.WaitFor.HtmlElementById("content-loaded");

問題：CSS/圖片未載入

配置基本 URL 以解決相對路徑：

renderer.RenderingOptions.BaseUrl = new Uri("https://yourdomain.com/assets/");

後遷移檢查清單

完成程式碼遷移後，請驗證以下內容：

  • 運行所有現有的單元和整合測試
  • 將 PDF 輸出與以前的版本進行視覺比較
  • 在隔離環境中測試所有 PDF 工作流
  • 驗證許可證是否正常工作（IronPdf.License.IsLicensed）
  • 將性能與先前的實現進行基準測試
  • 移除舊的ActivePDF安裝檔案和 DLL 參考
  • 更新CI/CD管道依賴性
  • 為您的開發團隊記錄IronPDF模式

其他資源

從ActivePDF遷移到IronPDF現代化了您的 PDF 生成基礎架構，提供更清晰的 API、更好的 .NET 整合和積極的長期支援。 遷移的投資將通過改進程式碼可維護性、異步功能以及對您的 PDF 程式庫持續開發的信心，帶來收益。

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

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

閱讀更多

相關文章