為 .NET 8 選擇文檔產生庫

iTextSharp — 與.NET 8 不相容

iTextSharp(iText 的原始.NET版本)自 2018 年以來就未更新過。它只面向.NET Framework ：

錯誤 NU1202：iTextSharp 5.5.13 程式包與 net8.0 不相容。

遷移路徑是 iText 7，它具有不同的 API，並且需要遵守 AGPL 協議(開源您的整個應用程式)或獲得商業許可。 價格未公開－第三方數據顯示每年費用為 15,000 美元至 210,000 美元。

wkhtmltopdf 封裝器 — .NET 8 上的 DLL 載入失敗

對 wkhtmltopdf 的 C# 封裝(DinkToPdf、Rotativa、NReco.PdfGenerator)會因.NET 8 部署模型特有的平台特定錯誤而失敗：

DinkToPdf — 未找到本機程式庫：

System.DllNotFoundException：無法載入 DLL"libwkhtmltox"

Rotativa.AspNetCore — 需要手動配置二進位檔案路徑，這與.NET 8 的容器優先部署方式相衝突：

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

TuesPechkin / NReco — 架構不符：

System.BadImageFormatException：無法載入檔案或組件

這些錯誤反映了一個更深層的問題：wkhtmltopdf於 2024 年 7 月存檔，但其中存在的 CVE 漏洞尚未修復。 原生二進位架構早於.NET 8 的平台偵測改進。 沒有解決辦法——只能遷移到另一個庫。

PdfSharp — Linux 系統繪圖常見故障

PdfSharp 依賴 System.Drawing.Common，而微軟在.NET 6 中已棄用其在非 Windows 平台上的相容性。在.NET 8 中，當部署到 Linux 或 Docker 時，這會導致執行時間失敗：

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

PdfSharp 6.x 一直在努力消除這種依賴性，但截至 2026 年初，跨平台支援仍不完善。對於僅限 Windows 的部署，PdfSharp 可與.NET 8 搭配使用。對於 Linux、Docker 或雲端部署，其相容性不穩定。

IronPDF — 完全支援.NET 8，跨平台

IronPDF原生支援 net8.0 和嵌入式 Chromium 渲染。 不依賴 System.Drawing.Common，不進行本地二進位管理，不進行平台特定的配置。

最小化 API 整合( .NET 8 的主要模式)：

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

對於使用控制器模式的團隊來說，相同的程式碼可以在控制器操作中運行——RenderHtmlAsPdf 返回一個 PdfDocument，你可以使用 .BinaryData 將其轉換為位元組。

授權：永久授權起價 749 美元(精簡版 — 1 位開發者，1 個專案)。 專業版：1,499 美元(10 位開發人員)。 企業版：2,999 美元(無限制)。 發佈於IronPDF 。

QuestPDF — 相容.NET 8，無需 HTML

QuestPDF 可與.NET 8 搭配使用，無需平台依賴。 它流暢的 C# API 以程式設計方式建立文件——無需 HTML 解析器、CSS 引擎或瀏覽器引擎：

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

QuestPDF 不轉換 HTML。 如果您的工作流程使用 HTML 範本(Razor視圖、儀表板匯出、Web 內容歸檔)，則需要不同的程式庫。 社區許可證適用於年收入低於 100 萬美元的企業； 此外，還需要商業許可。

iText 7 — 相容.NET 8，AGPL 許可

iText 7(iTextSharp 的繼任者)支援.NET 8。 pdfHTML 外掛程式使用自訂解析器提供 HTML 到 PDF 的轉換，而不是瀏覽器引擎，因此現代 CSS 功能(Flexbox、Grid)無法正確渲染。

許可：開源用途採用AGPL 許可，專有應用程式採用商業許可(訂閱，價格未公佈)。 iText 於 2024 年轉型為基於訂閱的商業授權模式。

標準 Debian 鏡像(建議)

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app

# IronPDF works without additional apt-get installs
# Chromium dependencies are handled internally

COPY --from=build /app/publish .

ENV DOTNET_RUNNING_IN_CONTAINER=true
EXPOSE 8080
ENTRYPOINT ["dotnet", "MyApp.dll"]

高山影像(佔地面積較小)

FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine
WORKDIR /app

# Alpine requires explicit Chromium dependencies
RUN apk add --no-cache chromium nss freetype harfbuzz ca-certificates ttf-freefont

COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyApp.dll"]

Debian鏡像不需要任何額外的軟體包。 Alpine鏡像檔較小，但需要明確安裝Chromium庫。 對於大多數部署而言，標準的 Debian 鏡像更簡單、更可靠。

從 iTextSharp 到IronPDF

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

從 wkhtmltopdf 封裝器到IronPDF

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

兩種情況下，API介面都更簡單。 遷移的主要成本是使用新的渲染器測試現有的 HTML 模板，以驗證輸出是否符合預期。