.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 Wrappers - .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");

' 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は、パッチが適用されていないCVEで2024年7月にアーカイブされました。 ネイティブ・バイナリ・アーキテクチャは、.NET 8のプラットフォーム検出の改善より前のものです。 修正はありません。別のライブラリへの移行のみです。

PdfSharp - Linux上のSystem.Drawing.Common Failures

PdfSharpはSystem.Drawing.Commonに依存していますが、Microsoftは.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

Imports PdfSharp.Pdf
Imports PdfSharp.Drawing

Dim document As 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();

Imports IronPdf

Dim builder = WebApplication.CreateBuilder(args)
Dim app = builder.Build()

app.MapGet("/invoice/{id}/pdf", Async Function(id As Integer, service As InvoiceService) 
    Dim invoice = Await service.GetInvoiceAsync(id)
    Dim renderer = New ChromePdfRenderer()

    Dim pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml())

    Return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
End Function)

app.Run()

RenderHtmlAsPdfは.BinaryDataでバイトに変換できるPdfDocumentを返します。

ライセンス: 749ドルからの永続ライセンス（Lite - 1開発者、1プロジェクト）。 Professional：1,499ドル（開発者10名）。 Enterprise：2,999ドル（無制限）。 ironPdf.comで公開されています。

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

Imports QuestPDF.Fluent
Imports QuestPDF.Infrastructure

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

Document.Create(Sub(container)
    container.Page(Sub(page)
        page.Size(PageSizes.A4)
        page.Margin(2, Unit.Centimetre)
        page.Content().Column(Sub(col)
            col.Item().Text("Q4 Report").FontSize(24).Bold()
            col.Item().Table(Sub(table)
                table.ColumnsDefinition(Sub(c)
                    c.RelativeColumn(2)
                    c.RelativeColumn(1)
                    c.RelativeColumn(1)
                End Sub)
                table.Header(Sub(h)
                    h.Cell().Text("Metric").Bold()
                    h.Cell().Text("Value").Bold()
                    h.Cell().Text("Change").Bold()
                End Sub)
                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%")
            End Sub)
        End Sub)
    End Sub)
End Sub).GeneratePdf("report.pdf")

QuestPDFはHTMLを変換しません。 ワークフローでHTMLテンプレート（Razorビュー、ダッシュボードエクスポート、ウェブコンテンツアーカイブ）を使用する場合は、別のライブラリが必要です。 コミュニティライセンスは、年間収益100万ドル未満の企業を対象としています； その上で、商用ライセンスが必要です。

iText 7 - .NET 8 互換、AGPL ライセンス

iText 7（iTextSharpの後継）は.NET 8をサポートしています。pdfHTMLアドオンは、ブラウザエンジンではなくカスタムパーサーでHTMLからPDFへの変換を行うため、最新のCSS機能（Flexbox、Grid）は正しくレンダリングされません。

ライセンスAGPL for open source use, 商業ライセンス（サブスクリプション、価格は公表されていません） for proprietary applications. 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

#IronPDFworks 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へ

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

Imports iTextSharp.text
Imports iTextSharp.text.pdf
Imports IronPdf
Imports System.IO

' Before (iTextSharp — doesn't compile against net8.0)
Dim doc As 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)
Dim renderer As New ChromePdfRenderer()
Dim 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;

Imports IronPdf

' Before (DinkToPdf — DllNotFoundException on .NET 8)
Dim converter = New SynchronizedConverter(New PdfTools())
Dim doc = New HtmlToPdfDocument With {
    .Objects = {New ObjectSettings With {.HtmlContent = html}}
}
Dim bytes = converter.Convert(doc)

' After (IronPDF — native .NET 8 support)
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)
bytes = pdf.BinaryData

どちらの場合も、APIの表面はよりシンプルです。 主な移行コストは、既存の HTML テンプレートを新しいレンダラーでテストし、出力が期待に一致することを確認することです。