How to Migrate from iText to IronPDF in C#

AGPL許可陷阱

iText 為商業應用帶來了嚴重的法律和商業風險，而許多開發團隊發現這些風險時已經為時過晚：

1. AGPL 病毒式授權：如果您在 Web 應用程式中使用 iText，AGPL 要求您開源您的整個應用程式—不僅僅是 PDF 程式碼，而是您的整個程式碼庫。 對於大多數商業軟體來說，這是行不通的。

2.沒有永久許可： iText 取消了永久許可，強制每年續訂訂閱，這增加了總擁有成本。

3. pdfHTML 附加元件費用： HTML 轉 PDF 功能需要 pdfHTML 附加元件，該元件需在基本授權之外另行購買。

4.複雜的許可審計：企業部署面臨許可的複雜性和審計風險，這可能會延誤專案並造成法律風險。

5.僅限程式 API： iText 需要手動使用Paragraph 、 Table 、 Cell物件建立底層 PDF——對於複雜的佈局來說，這既繁瑣又容易出錯。

6.現代 Web 渲染有限：即使使用 pdfHTML，複雜的 CSS 和 JavaScript 內容也需要付出大量額外努力。

iText 與 IronPDF 對比

對於計劃在 2025 年和 2026 年採用 .NET 10 和 C# 14 的團隊，IronPDF 憑藉其 HTML 優先的方法，利用團隊已有的 Web 開發技能，提供了一個面向未來的基礎。

各功能預計工作量

範式轉移

iText此次遷移的根本轉變是從程式化PDF建置轉向HTML優先渲染：

iText：PdfWriter → PdfDocument → Document → Add(Paragraph) → Add(Table)
IronPDF：ChromePdfRenderer → RenderHtmlAsPdf(htmlString) → SaveAs()

這個典範轉移令人耳目一新：你無需學習 iText 的物件模型，而是可以使用 Web 開發人員已經掌握的 HTML 和 CSS 技能。

先決條件

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

NuGet 套件變更

# Remove iText packages
dotnet remove package itext7
dotnet remove package itext7.pdfhtml
dotnet remove package itextsharp

# Install IronPDF
dotnet add package IronPdf

# Remove iText packages
dotnet remove package itext7
dotnet remove package itext7.pdfhtml
dotnet remove package itextsharp

# Install IronPDF
dotnet add package IronPdf

許可證配置

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

識別 iText 使用情況

# Find all iText references
grep -r "using iText\|using iTextSharp" --include="*.cs" .
grep -r "PdfWriter\|PdfDocument\|Document\|Paragraph\|Table\|Cell" --include="*.cs" .
grep -r "HtmlConverter\|ConverterProperties" --include="*.cs" .

# Find all iText references
grep -r "using iText\|using iTextSharp" --include="*.cs" .
grep -r "PdfWriter\|PdfDocument\|Document\|Paragraph\|Table\|Cell" --include="*.cs" .
grep -r "HtmlConverter\|ConverterProperties" --include="*.cs" .

類別映射

命名空間映射

範例 1：HTML 轉 PDF

之前（iText 7）：

// NuGet: Install-Package itext7
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>";
        string outputPath = "output.pdf";

        using (FileStream fs = new FileStream(outputPath, FileMode.Create))
        {
            HtmlConverter.ConvertToPdf(html, fs);
        }
    }
}

// NuGet: Install-Package itext7
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>";
        string outputPath = "output.pdf";

        using (FileStream fs = new FileStream(outputPath, FileMode.Create))
        {
            HtmlConverter.ConvertToPdf(html, fs);
        }
    }
}

（IronPDF 之後）：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

iText 方法需要單獨的iText.Html2pdf套件（pdfHTML 插件，單獨出售），建立一個FileStream ，並將所有內容包裝在using語句中以便正確處置。 HtmlConverter.ConvertToPdf()方法直接寫入流。

IronPDF 的方法更簡潔：建立一個ChromePdfRenderer ，使用 HTML 字串呼叫RenderHtmlAsPdf() ，然後對產生的PdfDocument呼叫SaveAs() 。 沒有單獨的軟體包，沒有串流管理，而且 Chromium 渲染引擎提供了卓越的 CSS3 和 JavaScript 支援。 有關其他渲染選項，請參閱HTML 轉 PDF 文件。

範例 2：合併多個 PDF 文件

之前（iText 7）：

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Kernel.Utils;
using System.IO;

class Program
{
    static void Main()
    {
        string outputPath = "merged.pdf";
        string[] inputFiles = { "document1.pdf", "document2.pdf", "document3.pdf" };

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdfDoc = new PdfDocument(writer))
        {
            PdfMerger merger = new PdfMerger(pdfDoc);

            foreach (string file in inputFiles)
            {
                using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
                {
                    merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
                }
            }
        }
    }
}

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Kernel.Utils;
using System.IO;

class Program
{
    static void Main()
    {
        string outputPath = "merged.pdf";
        string[] inputFiles = { "document1.pdf", "document2.pdf", "document3.pdf" };

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdfDoc = new PdfDocument(writer))
        {
            PdfMerger merger = new PdfMerger(pdfDoc);

            foreach (string file in inputFiles)
            {
                using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
                {
                    merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
                }
            }
        }
    }
}

（IronPDF 之後）：

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

class Program
{
    static void Main()
    {
        var pdfDocuments = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf"),
            PdfDocument.FromFile("document3.pdf")
        };

        var merged = PdfDocument.Merge(pdfDocuments);
        merged.SaveAs("merged.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var pdfDocuments = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf"),
            PdfDocument.FromFile("document3.pdf")
        };

        var merged = PdfDocument.Merge(pdfDocuments);
        merged.SaveAs("merged.pdf");
    }
}

iText 合併作業需要大量的樣板程式碼：建立一個用於輸出的PdfWriter ，將其包裝在PdfDocument中，建立一個PdfMerger ，然後使用巢狀的 using 語句遍歷原始檔，每個PdfDocument和PdfReader都需要一個using語句。 您也必須使用merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages())來指定頁面範圍。

IronPDF 將此過程簡化為三個步驟：使用PdfDocument.FromFile()載入文檔，使用清單呼叫靜態的PdfDocument.Merge()方法，然後儲存。 整個合併操作變得易於閱讀和維護。 了解更多關於合併和拆分PDF的資訊。

範例 3：建立包含文字和圖像的 PDF

之前（iText 7）：

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;

class Program
{
    static void Main()
    {
        string outputPath = "document.pdf";

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdf = new PdfDocument(writer))
        using (Document document = new Document(pdf))
        {
            document.Add(new Paragraph("Sample PDF Document"));
            document.Add(new Paragraph("This document contains text and an image."));

            Image img = new Image(ImageDataFactory.Create("image.jpg"));
            img.SetWidth(200);
            document.Add(img);
        }
    }
}

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;

class Program
{
    static void Main()
    {
        string outputPath = "document.pdf";

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdf = new PdfDocument(writer))
        using (Document document = new Document(pdf))
        {
            document.Add(new Paragraph("Sample PDF Document"));
            document.Add(new Paragraph("This document contains text and an image."));

            Image img = new Image(ImageDataFactory.Create("image.jpg"));
            img.SetWidth(200);
            document.Add(img);
        }
    }
}

（IronPDF 之後）：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        string html = @"
            <h1>Sample PDF Document</h1>
            <p>This document contains text and an image.</p>
            <img src='image.jpg' width='200' />";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        string html = @"
            <h1>Sample PDF Document</h1>
            <p>This document contains text and an image.</p>
            <img src='image.jpg' width='200' />";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

這個例子最清楚地說明了典範轉移。 iText 需要：

• 三重嵌套using語句（ PdfWriter 、 PdfDocument 、 Document ）
• 使用new Paragraph()為每個文字元素建立Paragraph對象
• 使用ImageDataFactory.Create()載入映像
• 分別建立Image物件並呼叫SetWidth()
• 對每個元素呼叫document.Add()

IronPDF 使用標準 HTML：<h1>標題，<p>對於段落，以及<img>對於具有width屬性的圖像。 Web 開發人員可以立即利用他們現有的技能，設計師可以使用他們已經熟悉的 CSS 來設定文件樣式。

範式轉移：從程式化到 HTML 優先

此次 iText 遷移中最顯著的變化是概念上的。 iText 可以透過程式設計方式產生 PDF 檔案：

// iText approach
document.Add(new Paragraph("Title")
    .SetTextAlignment(TextAlignment.CENTER)
    .SetFontSize(24)
    .SetBold());

var table = new Table(UnitValue.CreatePercentArray(3)).UseAllAvailableWidth();
table.AddHeaderCell(new Cell().Add(new Paragraph("ID")));
table.AddHeaderCell(new Cell().Add(new Paragraph("Name")));
// ... many more lines

// iText approach
document.Add(new Paragraph("Title")
    .SetTextAlignment(TextAlignment.CENTER)
    .SetFontSize(24)
    .SetBold());

var table = new Table(UnitValue.CreatePercentArray(3)).UseAllAvailableWidth();
table.AddHeaderCell(new Cell().Add(new Paragraph("ID")));
table.AddHeaderCell(new Cell().Add(new Paragraph("Name")));
// ... many more lines

IronPDF 用 HTML 和 CSS：

// IronPDF approach
string html = @"
    <style>
        h1 { text-align: center; font-size: 24px; font-weight: bold; }
        table { width: 100%; border-collapse: collapse; }
        th { background-color: #4CAF50; color: white; padding: 8px; }
    </style>
    <h1>Title</h1>
    <table>
        <tr><th>ID</th><th>Name</th></tr>
    </table>";

var pdf = renderer.RenderHtmlAsPdf(html);

// IronPDF approach
string html = @"
    <style>
        h1 { text-align: center; font-size: 24px; font-weight: bold; }
        table { width: 100%; border-collapse: collapse; }
        th { background-color: #4CAF50; color: white; padding: 8px; }
    </style>
    <h1>Title</h1>
    <table>
        <tr><th>ID</th><th>Name</th></tr>
    </table>";

var pdf = renderer.RenderHtmlAsPdf(html);

AGPL授權已取消

iText 的 AGPL 授權要求您將整個 Web 應用程式開源，或購買昂貴的商業許可。 IronPDF 的商業許可允許在專有軟體中部署，而無需病毒式許可要求。

無需安裝pdfHTML插件

iText 需要單獨購買 pdfHTML 外掛程式才能將 HTML 轉換為 PDF。 IronPDF 的基礎軟體包中包含了完整的基於 Chromium 的 HTML 渲染功能。

方法替換模式

問題 1：PdfWriter/文件模式

問題：程式碼使用了PdfWriter → PdfDocument → Document嵌套模式。

解決方案：替換為ChromePdfRenderer ：

// Delete this iText pattern:
// using (var writer = new PdfWriter(outputPath))
// using (var pdfDoc = new PdfDocument(writer))
// using (var document = new Document(pdfDoc))

// Replace with:
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

// Delete this iText pattern:
// using (var writer = new PdfWriter(outputPath))
// using (var pdfDoc = new PdfDocument(writer))
// using (var document = new Document(pdfDoc))

// Replace with:
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

問題 2：未找到 HtmlConverter

問題：程式碼使用了iText.Html2pdf.HtmlConverter ，這需要 pdfHTML 外掛程式。

解決方案：使用 IronPDF 內建的 HTML 渲染功能：

// iText (requires pdfHTML add-on)
HtmlConverter.ConvertToPdf(html, fileStream);

// IronPDF (built-in)
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

// iText (requires pdfHTML add-on)
HtmlConverter.ConvertToPdf(html, fileStream);

// IronPDF (built-in)
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

問題 3：PdfMerger 的複雜性

問題： iText 的PdfMerger需要嵌套讀取器和頁面範圍指定。

解決方案：使用 IronPDF 的靜態合併方法：

// iText merger pattern (delete this)
// using (PdfDocument pdfDoc = new PdfDocument(writer))
// {
//     PdfMerger merger = new PdfMerger(pdfDoc);
//     foreach (string file in inputFiles)
//     {
//         using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
//         {
//             merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
//         }
//     }
// }

// IronPDF (simple)
var merged = PdfDocument.Merge(pdfDocuments);
merged.SaveAs("merged.pdf");

// iText merger pattern (delete this)
// using (PdfDocument pdfDoc = new PdfDocument(writer))
// {
//     PdfMerger merger = new PdfMerger(pdfDoc);
//     foreach (string file in inputFiles)
//     {
//         using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
//         {
//             merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
//         }
//     }
// }

// IronPDF (simple)
var merged = PdfDocument.Merge(pdfDocuments);
merged.SaveAs("merged.pdf");

遷移前

• 清點程式碼庫中所有 iText API 呼叫
• 識別程序化 PDF 建置模式（段落、表格、儲存格）
• 文件 HtmlConverter 用法（pdfHTML 外掛程式）
• 評估AGPL合規風險
• 取得 IronPDF 許可證密鑰

程式碼遷移

• 刪除 iText NuGet 套件： dotnet remove package itext7 安裝 IronPdf NuGet 套件： dotnet add package IronPdf
• 更新命名空間導入（ using iText.* → using IronPdf ）
• 將PdfWriter / Document模式替換為ChromePdfRenderer 將Paragraph / Table / Cell轉換為 HTML 元素
• 將HtmlConverter.ConvertToPdf()替換為RenderHtmlAsPdf()
• 將合併作業更新為PdfDocument.Merge()
• 新增啟動時許可證金鑰初始化功能

測試

• 測試所有 PDF 生成路徑
• 驗證視覺輸出是否符合預期
• 使用複雜的 HTML/CSS 內容進行測試
• 基準性能

移民後

• 刪除 iText 許可證文件和引用
• 更新文檔
• 取消 iText 訂閱（如適用）
• 歸檔舊版 iText 程式碼