影片

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

已更新: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操作而不需要其餘工具包的團隊來說，表面積在一些具體方面顯現出來：

廣泛的工具包範圍： .NET SDK覆蓋了PDF, OCR, 條碼, TWAIN掃描，圖像處理和跨100多個文件格式的轉換。如果您需要這種廣泛的範圍是有用的——如果不需要，則比僅供PDF專案所需的表面積更多。
銷售驅動的定價： nutrient.io/sdk/pricing頁面轉發到一個聯絡表單，而不是發佈每位開發者的定價，因此小型團隊難以進行並排的成本比較。
品牌和包裹大改變： PSPDFKit → Nutrient（2024-10-23），再加上GdPicture的收購，意味著在舊程式碼中有三個名稱需要跟踪。 .NET SDK依然作為GdPicture NuGet包發行，命名空間GdPictureDocumentConverter不符合"Nutrient"或"PSPDFKit"品牌。
外部瀏覽器依賴於HTML轉PDF： .NET SDK的HTML渲染器依賴於系統安裝Chrome或Edge（或可攜帶路徑，您通過SetWebBrowserPath設置）。 IronPDF附帶其自身嵌入的Chromium。
程式性PDF API： 水印組成了DrawTextBox和OCG層標記；在迴圈中為每頁繪製標題和頁腳。從原始操作構成常見的PDF操作意味著每項任務有更多程式碼。

Nutrient .NET SDK與IronPDF比較

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

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

開始之前

前提條件

.NET Environment: .NET Framework 4.6.2+ or .NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet存取： 有能力安裝NuGet套件
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

# 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";

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

識別Nutrient .NET SDK用法

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

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

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

Imports GdPicture14
Imports System.IO

Class Program
    Shared Sub Main()
        Dim htmlContent As String = "<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 converter As New GdPictureDocumentConverter()
            converter.LoadFromFile("input.html", DocumentFormat.DocumentFormatHTML)
            converter.SaveAsPDF("output.pdf")
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

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

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

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"

        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

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

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

Imports GdPicture14
Imports System.Collections.Generic

Class Program
    Shared Sub Main()
        Dim sourceFiles As IEnumerable(Of String) = New List(Of String) From {
            "document1.pdf",
            "document2.pdf"
        }

        Using converter As New GdPictureDocumentConverter()
            converter.CombineToPDF(sourceFiles, "merged.pdf", PdfConformance.PDF)
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

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

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

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim pdf1 = PdfDocument.FromFile("document1.pdf")
        Dim pdf2 = PdfDocument.FromFile("document2.pdf")

        Dim merged = PdfDocument.Merge(pdf1, pdf2)
        merged.SaveAs("merged.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

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

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

Imports GdPicture14

Class Program
    Shared Sub Main()
        Using pdf As New GdPicturePDF()
            pdf.LoadFromFile("document.pdf")
            pdf.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitPoint)

            Dim font = pdf.AddStandardFont(PdfStandardFont.PdfStandardFontHelveticaBold)
            Dim pageCount As Integer = pdf.GetPageCount()

            For i As Integer = 1 To pageCount
                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)
            Next

            pdf.SaveToFile("watermarked.pdf")
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

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

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

Imports IronPdf
Imports IronPdf.Editing

Class Program
    Shared Sub Main()
        Dim 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")
    End Sub
End Class

$vbLabelText $csharpLabel

此範例突顯了根本的架構差異。 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");

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

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

' IronPDF(string -> PDF):
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

如果您確實需要異步操作，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);

// 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);

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

' IronPDF: nothing to configure
Dim pdf = renderer.RenderHtmlAsPdf(html)

$vbLabelText $csharpLabel

配置模式更改

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

// 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);

Imports GdPicture14
Imports IronPdf

' Nutrient .NET SDK: properties on the converter (inches)
Using converter As 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
End Using

' IronPDF: properties on RenderingOptions (millimetres)
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
Dim pdf = renderer.RenderHtmlAsPdf(html)

$vbLabelText $csharpLabel

從程式性水印到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);

// 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);

' 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)

$vbLabelText $csharpLabel

頁碼處理

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

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

' Nutrient .NET SDK: per-page DrawText loop (1-based)
For i As Integer = 1 To pdf.GetPageCount()
    pdf.SelectPage(i)
    pdf.DrawText(font, x, y, $"Page {i} of {pdf.GetPageCount()}")
Next

' IronPDF: built-in placeholders
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .HtmlFragment = "Page {page} of {total-pages}"
}

$vbLabelText $csharpLabel

頁面索引

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

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

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

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

' IronPDF(0-based):
pdf.RemovePages(0)

$vbLabelText $csharpLabel

故障排除

問題1：GdPictureDocumentConverter未找到

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

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

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

// IronPDF
var renderer = new ChromePdfRenderer();

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

// IronPDF
var renderer = new ChromePdfRenderer();

Imports GdPicture14
Imports IronPdf

' Nutrient .NET SDK
Using converter As New GdPictureDocumentConverter()
    ' Your code here
End Using

' IronPDF
Dim renderer As New ChromePdfRenderer()

$vbLabelText $csharpLabel

問題2：GdPicturePDF未找到

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

解決方案： 使用PdfDocument：

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

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

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

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

Imports GdPicture14
Imports IronPdf

' Nutrient .NET SDK
Using pdf As New GdPicturePDF()
    pdf.LoadFromFile("input.pdf")
End Using

' IronPDF
Dim pdfDocument = PdfDocument.FromFile("input.pdf")

$vbLabelText $csharpLabel

問題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);

// 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);

' 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)

$vbLabelText $csharpLabel

問題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");

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

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

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

' IronPDF
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged.pdf")

$vbLabelText $csharpLabel

問題5：頁碼索引差一

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

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

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

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

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

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

' Nutrient .NET SDK (first page)
pdf.SelectPage(1)

' IronPDF(first page)
Dim firstPage = pdf.Pages(0)

$vbLabelText $csharpLabel

遷移檢查表

遷移前

清點所有在程式碼庫中的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擁有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 文件中旋轉、縮放和重新定位頁面等基本技術，增強您的文件管理和編輯能力。

如何在 C# 中為 PDF 新增印章和水印

如何使用 C# 將 RTF 轉換為 PDF

開始免費30天試用

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

為何從Nutrient遷移到IronPDF

工具包表面積問題

Nutrient .NET SDK與IronPDF比較

開始之前

前提條件

NuGet包變更

授權配置

識別Nutrient .NET SDK用法

完整API參考

初始化映射

文件載入映射

PDF生成映射

文件操作映射

水印映射

程式碼遷移範例

範例1：HTML轉PDF轉換

範例2：合併多個PDF

範例3：新增水印

關鍵遷移注意事項

HTML輸入表面

外部瀏覽器依賴

配置模式更改

從程式性水印到HTML水印

頁碼處理

頁面索引

故障排除

問題1：GdPictureDocumentConverter未找到

問題2：GdPicturePDF未找到

問題3：DrawTextBox / SetFillAlpha未找到

問題4：CombineToPDF未找到

問題5：頁碼索引差一

遷移檢查表

遷移前

套件變更

程式碼變更

遷移後

相關文章

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

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

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

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

Thank You

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

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

包含什麼？

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

您的演示請求已提交。

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

Iron 支援團隊