影片

如何使用 IronPDF 用 C# 簽署 PDF 文件

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

從Nutrient（前身為PSPDFKit）遷移到IronPDF通過從一個廣泛的成像和PDF工具包過渡到一個專注的PDF庫來簡化您的.NET PDF工作流程。 Nutrient的伺服器端.NET產品是GdPicture.NET - 從ORPALIS收購並重新定位為"Nutrient .NET SDK"的工具包，作為GdPicture NuGet包發行於GdPicture14命名空間。 本指南介紹了一個逐步遷移路徑，它將程式性、多用途工具包替換為一個僅供PDF使用且表面積較小的庫。

為何從Nutrient遷移到IronPDF

工具包表面積問題

Nutrient（以前的PSPDFKit，2024-10-23重新命名）銷售一個多產品家族——Document Engine（Docker微服務），Web SDK，移動SDK，以及一個伺服器端.NET SDK，實際為GdPicture。 對於只需簡單PDF操作而不需要其餘工具包的團隊來說，表面積在一些具體方面顯現出來：

  1. 廣泛的工具包範圍： .NET SDK覆蓋了PDF, OCR, 條碼, TWAIN掃描，圖像處理和跨100多個文件格式的轉換。 如果您需要這種廣泛的範圍是有用的——如果不需要，則比僅供PDF專案所需的表面積更多。

  2. 銷售驅動的定價： nutrient.io/sdk/pricing頁面轉發到一個聯絡表單，而不是發佈每位開發者的定價，因此小型團隊難以進行並排的成本比較。

  3. 品牌和包裹大改變： PSPDFKit → Nutrient（2024-10-23），再加上GdPicture的收購，意味著在舊程式碼中有三個名稱需要跟踪。 .NET SDK依然作為GdPicture NuGet包發行，命名空間GdPictureDocumentConverter不符合"Nutrient"或"PSPDFKit"品牌。

  4. 外部瀏覽器依賴於HTML轉PDF： .NET SDK的HTML渲染器依賴於系統安裝Chrome或Edge（或可攜帶路徑，您通過SetWebBrowserPath設置）。 IronPDF附帶其自身嵌入的Chromium。

  5. 程式性PDF API： 水印組成了DrawTextBox和OCG層標記； 在迴圈中為每頁繪製標題和頁腳。從原始操作構成常見的PDF操作意味著每項任務有更多程式碼。

Nutrient .NET SDK與IronPDF比較

方面Nutrient .NET SDK（GdPicture）IronPDF
範圍PDF + OCR + 條碼 + 掃描 + 成像PDF庫
價格銷售驅動（聯絡報價）透明，公佈
NuGet套件GdPictureIronPdf
根命名空間GdPicture14IronPdf
API風格大多是同步的，程式性繪製調用同步與異步選項，流暢
HTML渲染需要系統Chrome/Edge嵌入的Chromium
頁面索引基於10起始基數
目標使用者需要在一個工具包中成像+掃描+PDF的團隊只需要PDF的團隊

對於只需要PDF的現代.NET團隊，IronPDF提供了一個更小、專注於PDF的基礎，無需額外的成像/掃描/OCR層即可流暢整合。

開始之前

前提條件

  1. .NET Environment: .NET Framework 4.6.2+ or .NET Core 3.1+ / .NET 5/6/7/8/9+
  2. NuGet存取： 有能力安裝NuGet套件
  3. IronPDF授權： 從ironpdf.com獲取您的授權金鑰

NuGet包變更

# Remove the Nutrient .NET SDK（GdPicture） and any legacy PSPDFKit-branded packages
dotnet remove package GdPicture
dotnet remove package GdPicture.WPF
dotnet remove package GdPicture.WinForms
dotnet remove package PSPDFKit.NET

# Install IronPDF
dotnet add package IronPdf
SHELL

當前的Nutrient .NET SDK在GdPicture NuGet ID下發行（最新14.x，所有者ORPALIS——Nutrient子公司）。 舊的PSPDFKit品牌PSPDFKit.NET包已停止使用； 如果存在，請移除它。

授權配置

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

識別Nutrient .NET SDK用法

# Find GdPicture / Nutrient / PSPDFKit usage
grep -rE "GdPicture14|GdPicturePDF|GdPictureDocumentConverter|PSPDFKit|Nutrient" --include="*.cs" .
SHELL

完整API參考

初始化映射

Nutrient .NET SDK（GdPicture）IronPDF
new GdPicturePDF()new PdfDocument(...) / PdfDocument.FromFile(...)
new GdPictureDocumentConverter()new ChromePdfRenderer()
pdf.Dispose() （IDisposable）pdf.Dispose() （IDisposable）

文件載入映射

Nutrient .NET SDK（GdPicture）IronPDF
pdf.LoadFromFile(path)PdfDocument.FromFile(path)
pdf.LoadFromStream(stream)PdfDocument.FromStream(stream)
pdf.LoadFromByteArray(bytes)new PdfDocument(bytes) / PdfDocument.FromBinaryData(bytes)

PDF生成映射

Nutrient .NET SDK（GdPicture）IronPDF
HTML字串：寫入臨時文件，然後converter.LoadFromFile(path, DocumentFormat.DocumentFormatHTML) + SaveAsPDF(out)renderer.RenderHtmlAsPdf(html)
converter.LoadFromHttp(url) + SaveAsPDF(out)renderer.RenderUrlAsPdf(url)
converter.LoadFromFile(htmlPath, DocumentFormat.DocumentFormatHTML) + SaveAsPDF(out)renderer.RenderHtmlFileAsPdf(path)

文件操作映射

Nutrient .NET SDK（GdPicture）IronPDF
converter.CombineToPDF(paths, out, PdfConformance.PDF)PdfDocument.Merge(pdfs)
pdf.GetPageCount()pdf.PageCount
pdf.SaveToFile(path)pdf.SaveAs(path)
pdf.SaveToByteArray(out bytes)pdf.BinaryData

水印映射

Nutrient .NET SDK（GdPicture）IronPDF
pdf.SetFillAlpha(...) + 每頁pdf.DrawTextBox(...)pdf.ApplyWatermark(html, rotation, vAlign, hAlign)
pdf.AddStandardFont(...) + 繪製調用字串中的HTML/CSS水印
SetFillAlpha(128) （0–255字節刻度）水印Opacity 0–100（整數）或CSS opacity
pdf.SetTextSize(48)CSS font-size: 48px

程式碼遷移範例

範例1：HTML轉PDF轉換

之前（Nutrient .NET SDK / GdPicture）：

// NuGet: Install-Package GdPicture
using GdPicture14;
using System.IO;

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

        // GdPicture's HTML loader is file-based, so stage the string to disk first.
        File.WriteAllText("input.html", htmlContent);

        using var converter = new GdPictureDocumentConverter();
        converter.LoadFromFile("input.html", DocumentFormat.DocumentFormatHTML);
        converter.SaveAsPDF("output.pdf");
    }
}

之後（IronPDF）：

// NuGet: Install-Package IronPdf
using IronPdf;

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

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

GdPicture方法需要一些額外步驟：HTML載入器是基於文件/URL的，因此記憶體中的HTML字串必須先在磁碟上放置，然後叫用SaveAsPDF。 HTML渲染依賴於系統安裝的Chrome或Edge（或通過SetWebBrowserPath提供的便攜路徑）。

IronPDF直接接受HTML字串。 建立SaveAs()保存。 無需臨時文件，也不依賴於主機瀏覽器——IronPDF附帶其自身嵌入的Chromium。 查看HTML到PDF文件以獲取其他渲染選項。

範例2：合併多個PDF

之前（Nutrient .NET SDK / GdPicture）：

// NuGet: Install-Package GdPicture
using GdPicture14;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        IEnumerable<string> sourceFiles = new List<string>
        {
            "document1.pdf",
            "document2.pdf"
        };

        using var converter = new GdPictureDocumentConverter();
        converter.CombineToPDF(sourceFiles, "merged.pdf", PdfConformance.PDF);
    }
}

之後（IronPDF）：

// NuGet: Install-Package IronPdf
using IronPdf;

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");
    }
}

GdPicture合併涉及基於路徑的PdfConformance值。

IronPDF在文件級別工作：用PdfDocument.Merge()方法合併，然後保存。 文件可以直接傳遞或作為可列舉物件傳遞。 了解更多合併和拆分PDF的資訊。

範例3：新增水印

之前（Nutrient .NET SDK / GdPicture）：

// NuGet: Install-Package GdPicture
using GdPicture14;

class Program
{
    static void Main()
    {
        using var pdf = new GdPicturePDF();
        pdf.LoadFromFile("document.pdf");
        pdf.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitPoint);

        var font = pdf.AddStandardFont(PdfStandardFont.PdfStandardFontHelveticaBold);
        int pageCount = pdf.GetPageCount();

        for (int i = 1; i <= pageCount; i++)
        {
            pdf.SelectPage(i);
            pdf.SetFillAlpha(128);  // ~50% (0..255)
            pdf.SetTextSize(48);
            pdf.SetOriginRotationInDegrees(45);
            pdf.DrawTextBox(font, 100, 300, 500, 400, "CONFIDENTIAL",
                PdfHorizontalAlignment.PdfHorizontalAlignmentCenter,
                PdfVerticalAlignment.PdfVerticalAlignmentMiddle);
        }

        pdf.SaveToFile("watermarked.pdf");
    }
}

之後（IronPDF）：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("document.pdf");

        pdf.ApplyWatermark("<h1 style='color:gray;opacity:0.5;'>CONFIDENTIAL</h1>",
            45,
            VerticalAlignment.Middle,
            HorizontalAlignment.Center);

        pdf.SaveAs("watermarked.pdf");
    }
}

此範例突顯了根本的架構差異。 GdPicture採用 程式性繪畫調用方法： 新增標準字體，然後迭代（基於1）遍歷每頁調用DrawTextBox。 阿爾法在0–255字節刻度上，旋轉設置為圖形狀態屬性，定位通過明確坐標來處理。

IronPDF使用 基於HTML方法： ApplyWatermark()方法接受帶有CSS樣式的HTML字串並將其應用於所有頁面的一次性調用。 您通過熟悉的CSS屬性控制外觀（font-size），而不是原始圖形調用。 此方法還支持更豐富的內容——漸變、圖像和更複雜的佈局——在同一字串中。 請參閱水印文件以獲取高級範例。

關鍵遷移注意事項

HTML輸入表面

GdPicture的HTML載入器基於文件/URL； IronPDF直接接受HTML字串：

// Nutrient .NET SDK (string -> file -> PDF):
File.WriteAllText("input.html", html);
converter.LoadFromFile("input.html", DocumentFormat.DocumentFormatHTML);
converter.SaveAsPDF("output.pdf");

//IronPDF(string -> PDF):
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

如果您確實需要異步操作，IronPDF提供了如RenderHtmlAsPdfAsync()的異步變體。

外部瀏覽器依賴

GdPicture的HTML渲染器依賴於系統的Chrome或Edge安裝（或由SetWebBrowserPath設置的便攜路徑）。 IronPDF附帶其自身嵌入的Chromium：

// Nutrient .NET SDK: optionally point to a portable Chrome
converter.SetWebBrowserPath(@"C:\Tools\chrome\chrome.exe");

// IronPDF: nothing to configure
var pdf = renderer.RenderHtmlAsPdf(html);

配置模式更改

GdPicture將佈局設置作為轉換器上的屬性值公開（HTML頁面寬/高度以英寸為單位，單獨邊距）。 IronPDF將它們整合到RenderingOptions袋中，並具有命名的紙張尺寸：

// Nutrient .NET SDK: properties on the converter (inches)
using var converter = new GdPictureDocumentConverter();
converter.HtmlPageWidth  = 8.27f;   // A4 width  (inches)
converter.HtmlPageHeight = 11.69f;  // A4 height (inches)
converter.HtmlMarginTop = 0.78f;
converter.HtmlMarginBottom = 0.78f;
converter.HtmlMarginLeft = 0.78f;
converter.HtmlMarginRight = 0.78f;

// IronPDF: properties on RenderingOptions (millimetres)
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
var pdf = renderer.RenderHtmlAsPdf(html);

從程式性水印到HTML水印

用單個HTML/CSS字串替換原始繪製調用：

// Nutrient .NET SDK: SetFillAlpha + SetTextSize + DrawTextBox in a per-page loop
pdf.SetFillAlpha(128);
pdf.SetTextSize(48);
pdf.SetOriginRotationInDegrees(45);
pdf.DrawTextBox(font, 100, 300, 500, 400, "CONFIDENTIAL",
    PdfHorizontalAlignment.PdfHorizontalAlignmentCenter,
    PdfVerticalAlignment.PdfVerticalAlignmentMiddle);

// IronPDF: one HTML/CSS string
pdf.ApplyWatermark("<h1 style='opacity:0.5; font-size:48px;'>CONFIDENTIAL</h1>",
    45, VerticalAlignment.Middle, HorizontalAlignment.Center);

頁碼處理

GdPicture沒有一級標頭/頁尾模型——頁碼在迴圈中為每頁繪製。 IronPDF公開了內建的{page} / {total-pages}佔位符：

// Nutrient .NET SDK: per-page DrawText loop (1-based)
for (int i = 1; i <= pdf.GetPageCount(); i++)
{
    pdf.SelectPage(i);
    pdf.DrawText(font, x, y, $"Page {i} of {pdf.GetPageCount()}");
}

// IronPDF: built-in placeholders
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "Page {page} of {total-pages}"
};

頁面索引

GdPicture是 基於1的 （SelectPage(1)是首頁）。IronPDFpdf.Pages 和 pdf.RemovePages(int) 是 基於0的。 差一個是最常見的遷移錯誤：

// Nutrient .NET SDK (1-based):
pdf.SelectPage(1);
pdf.DeletePage();

//IronPDF(0-based):
pdf.RemovePages(0);

故障排除

問題1：GdPictureDocumentConverter未找到

問題： GdPictureDocumentConverter類在IronPDF中不存在。

解決方案： 使用ChromePdfRenderer進行HTML/URL → PDF：

// Nutrient .NET SDK
using var converter = new GdPictureDocumentConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

問題2：GdPicturePDF未找到

問題： GdPicturePDF類在IronPDF中不存在。

解決方案： 使用PdfDocument：

// Nutrient .NET SDK
using var pdf = new GdPicturePDF();
pdf.LoadFromFile("input.pdf");

// IronPDF
var pdf = PdfDocument.FromFile("input.pdf");

問題3：DrawTextBox / SetFillAlpha未找到

問題： 原始繪製調用在IronPDF中不存在。

解決方案： 使用基於HTML的水印：

// Nutrient .NET SDK
pdf.SetFillAlpha(128);
pdf.DrawTextBox(font, 100, 300, 500, 400, "DRAFT",
    PdfHorizontalAlignment.PdfHorizontalAlignmentCenter,
    PdfVerticalAlignment.PdfVerticalAlignmentMiddle);

// IronPDF
pdf.ApplyWatermark("<div style='opacity:0.5;'>DRAFT</div>",
    45, VerticalAlignment.Middle, HorizontalAlignment.Center);

問題4：CombineToPDF未找到

問題： 基於路徑的合併方法不存在。

解決方案： 將每個PDF載入為PdfDocument.Merge()：

// Nutrient .NET SDK
converter.CombineToPDF(paths, "merged.pdf", PdfConformance.PDF);

// IronPDF
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

問題5：頁碼索引差一

問題： GdPicture使用基於1的頁碼索引； IronPDF使用基於0的。 直接遷移pdf.Pages[1]會跳過首頁。

解決方案： 鏈頁碼索引時減去一：

// Nutrient .NET SDK (first page)
pdf.SelectPage(1);

//IronPDF(first page)
var firstPage = pdf.Pages[0];

遷移檢查表

遷移前

  • 清點所有在程式碼庫中的GdPicture / PSPDFKit / Nutrient使用
  • 注意現有GdPicture程式碼中基於1與基於0的頁碼索引
  • 在GdPictureDocumentConverter上列出配置集（HTML頁面尺寸、邊距）
  • 識別水印和頁眉的程式性繪製（DrawTextBox）
  • 查看使用基於索引存取的表單字段程式碼（GetFormFieldName(i)）
  • 獲得IronPDF授權金鑰

套件變更

  • 移除GdPicture NuGet包（如存在GdPicture.WPF / GdPicture.WinForms，則移除）
  • 移除舊的PSPDFKit.NET包，如存在
  • 安裝IronPdf NuGet包：dotnet add package IronPdf
  • 更新命名空間導入（using GdPicture14; → using IronPdf;）

程式碼變更

  • 在啟動時加入授權金鑰配置
  • 將new ChromePdfRenderer()用於HTML/URL → PDF
  • 將new GdPicturePDF() + PdfDocument.FromFile()
  • 將PdfDocument.Merge()
  • 將程式性水印繪製調用轉換為pdf.ApplyWatermark(html, ...)
  • 用RenderingOptions替換轉換器屬性（命名的紙尺寸，毫米邊距）
  • 將頁眉/頁腳更新為{page} / {total-pages}佔位符
  • 全面將基於1的頁碼索引轉換為基於0的

遷移後

  • 如果它只是為了GdPicture而存在於部署圖像中，移除系統Chrome / Edge依賴
  • 執行回歸測試比較 PDF 輸出
  • 驗證頁眉/頁腳與頁碼
  • 測試水印渲染
  • 更新CI/CD管道
請注意: Nutrient，PSPDFKit，GdPicture和ORPALIS是其各自擁有者的商標。 本網站與Nutrient，PSPDFKit，GdPicture或ORPALIS無關聯、贊助或支持。 所有產品名稱、標誌和品牌均為其各自所有者的財產。 比較僅供參考，反映撰寫時公開可用的資訊。
Curtis Chau
Curtis Chau
技術作家

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

閱讀更多

相關文章