ビデオ

How to Add Stamps & Watermarks to PDFs in C#

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

GotenbergからIronPDFへの移行は、あなた for .NET PDFワークフローをHTTP API呼び出しによるDockerベースのマイクロサービス・アーキテクチャからプロセス内のネイティブC#ライブラリに変換します。 このガイドでは、.NETのプロフェッショナルな開発者向けに、インフラストラクチャのオーバーヘッド、ネットワーク遅延、コンテナ管理の複雑さを解消する、包括的でステップバイステップの移行パスを提供します。

なぜGotenbergからIronPDFに移行するのか

ゴテンベルク・アーキテクチャ問題

Gotenbergは、PDF生成のためのDockerベースのマイクロサービスアーキテクチャです。 強力で柔軟な反面、C#アプリケーションには大きな複雑さをもたらします：

1.インフラストラクチャのオーバーヘッド: Docker、コンテナ オーケストレーション (Kubernetes/Docker Compose)、サービス検出、負荷分散が必要です。 デプロイメントが複雑になるたびに

2.ネットワークレイテンシ： PDF操作ごとに別のサービスへのHTTP呼び出しが必要となり、リクエストごとに10～100ミリ秒以上の遅延が発生します。このレイテンシは、大量のデータを扱うシナリオでは急速に増大します。

3.コールド スタートの問題:コンテナーの起動により、最初のリクエストに 2 ～ 5 秒かかる場合があります。 ポッドの再起動、スケールアップのイベント、デプロイのたびにコールドスタートが発生します。

4.運用の複雑さ:コンテナの健全性、スケーリング、ログ記録、監視をメイン アプリケーションとは別の問題として管理する必要があります。

5.マルチパート フォーム データ:すべてのリクエストで、multipart/form-data ペイロードを構築する必要があります。これは冗長で、エラーが発生しやすく、保守が面倒です。

6.障害ポイント:ネットワーク タイムアウト、サービスの利用不可、コンテナのクラッシュはすべて、処理する責任があなたにあります。

7.**バージョン管理:**Gotenbergイメージはアプリケーションとは別に更新されます。 APIの変更は、予期せず統合を壊す可能性があります。

GotenbergとIronPDFの比較

アスペクトGotenbergIronPDF
デプロイメントDockerコンテナ＋オーケストレーション単一のNuGetパッケージ
アーキテクチャマイクロサービス（REST API）インプロセスライブラリ
リクエストあたりの待ち時間10-100ms以上（ネットワーク・ラウンドトリップ）<1msのオーバーヘッド
コールドスタート2～5秒（コンテナinit）1～2秒（最初のレンダリングのみ）
インフラDocker、Kubernetes、ロードバランサー不要
障害モードネットワーク、コンテナ、サービス障害.NET Standardの例外
APIスタイルREST multipart/form-dataC#ネイティブメソッドコール
スケーリング水平方向（コンテナを増やす）垂直方向（進行中）
デバッグ分散トレースが必要標準デバッガ
バージョン管理コンテナ画像タグNuGetパッケージのバージョン

現行 for .NETバージョンを対象とするチーム向けに、IronPDFはインフラ依存ゼロの基盤を提供し、現代 for .NETパターンにネイティブに統合します。

マイグレーションの複雑さの評価

機能別の見積もり作業

フィーチャー移行の複雑さ
HTMLからPDFへ低レベル
URLからPDFへ低レベル
カスタム用紙サイズ低レベル
マージン低レベル
PDFマージ低レベル
ヘッダー/フッター中規模
待ち時間低レベル
PDF/A変換低レベル

パラダイムシフト

このGotenberg移行における基本的な変化は、マルチパート フォーム データを使用した HTTP API 呼び出しからネイティブ C# メソッド呼び出しへの変更です。

Gotenberg：  Docker コンテナへの HTTP POST multipart/form-data
IronPDF：    C#オブジェクトの直接メソッド呼び出し
Text

始める前に

前提条件

  1. .NETバージョン: IronPDFは.NET Framework 4.6.2以降および.NET Core 3.1以降 / .NET 5/6/7/8/9以降をサポートしています。 2.ライセンスキー: IronPDFからIronPDFライセンスキーを取得します。 3.インフラストラクチャの削除を計画する:移行後の廃止に向けてGotenbergコンテナを文書化する

すべてのGotenbergの使用法を特定する

# Find direct HTTP calls to Gotenberg
grep -r "gotenberg\|/forms/chromium\|/forms/libreoffice\|/forms/pdfengines" --include="*.cs" .

# Find GotenbergSharpApiClient usage
grep -r "GotenbergSharpClient\|Gotenberg.Sharp\|ChromiumRequest" --include="*.cs" .

# Find Docker/KubernetesGotenbergconfiguration
grep -r "gotenberg/gotenberg\|gotenberg:" --include="*.yml" --include="*.yaml" .
SHELL

NuGetパッケージの変更

# RemoveGotenbergclient (if using)
dotnet remove package Gotenberg.Sharp.API.Client

# Install IronPDF
dotnet add package IronPdf
SHELL

クイック スタート マイグレーション

ステップ 1: ライセンス構成の更新

ビフォア(Gotenberg):。

Gotenbergはライセンス不要ですが、コンテナURLのあるDockerインフラストラクチャが必要です。

private readonly string _gotenbergUrl = "http://localhost:3000";

翻訳後（IronPDF）：。

// Set once at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

ステップ 2: 名前空間インポートを更新する

// Before (Gotenberg)
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;

完全な API リファレンス

GotenbergエンドポイントからIronPDFへのマッピング

御殿場ルートIronPDF 同等物
POST /forms/chromium/convert/htmlChromePdfRenderer.RenderHtmlAsPdf()
POST /forms/chromium/convert/urlChromePdfRenderer.RenderUrlAsPdf()
POST /forms/pdfengines/mergePdfDocument.Merge()
POST /forms/pdfengines/convertpdf.SaveAs() の設定で
GET /health該当なし

フォーム パラメータと RenderingOptions のマッピング

Gotenberg パラメータIronPDF プロパティ変換に関する注意事項
paperWidth（インチ）RenderingOptions.PaperSize列挙型またはカスタムサイズを使用
paperHeight（インチ）RenderingOptions.PaperSize列挙型またはカスタムサイズを使用
marginTop（インチ）RenderingOptions.MarginTopmmは25.4倍
marginBottom（インチ）RenderingOptions.MarginBottommmは25.4倍
printBackgroundRenderingOptions.PrintHtmlBackgroundsブーリアン
landscapeRenderingOptions.PaperOrientationLandscape enum
"3s"）RenderingOptions.WaitFor.RenderDelay(ms)文字列をミリ秒に変換する

コード移行の例

例1: 基本的なHTMLからPDFへ

ビフォア(Gotenberg):。

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergExample
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";
        
        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();
        
        var html = "<html><body><h1>Hello from Gotenberg</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");
        
        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();
        
        await File.WriteAllBytesAsync("output.pdf", pdfBytes);
        Console.WriteLine("PDF generated successfully");
    }
}

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        var html = "<html><body><h1>Hello from IronPDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully");
    }
}

違いは大きいです：GotenbergではMultipartFormDataContentの構築、実行中のDockerコンテナへの非同期HTTP POST、およびバイト配列応答の処理が必要です。 IronPDFではChromePdfRendererメソッドコールでこれを3行に減らします - ネットワークの負荷なし、コンテナ依存なし、非同期の複雑さなし。 その他のレンダリングオプションについては、HTML to PDF documentationを参照してください。

例2: URLからPDFへの変換

ビフォア(Gotenberg):。

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergUrlToPdf
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/url";
        
        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();
        
        content.Add(new StringContent("https://example.com"), "url");
        
        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();
        
        await File.WriteAllBytesAsync("webpage.pdf", pdfBytes);
        Console.WriteLine("PDF from URL generated successfully");
    }
}

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfUrlToPdf
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL generated successfully");
    }
}

Gotenbergのアプローチでは別のエンドポイント(/forms/chromium/convert/url)、URLをフォームフィールドとするマルチパートコンテンツの構築、および非同期HTTP応答の処理が必要です。 IronPDFのPdfDocumentオブジェクトを同期的に返します。 URLからPDFへの変換の詳細については、こちらをご覧ください。

例3: カスタムの用紙サイズと余白

ビフォア(Gotenberg):。

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergCustomSize
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";
        
        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();
        
        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");
        content.Add(new StringContent("8.5"), "paperWidth");
        content.Add(new StringContent("11"), "paperHeight");
        content.Add(new StringContent("0.5"), "marginTop");
        content.Add(new StringContent("0.5"), "marginBottom");
        
        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();
        
        await File.WriteAllBytesAsync("custom-size.pdf", pdfBytes);
        Console.WriteLine("Custom size PDF generated successfully");
    }
}

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using System;
using IronPdf;
using IronPdf.Rendering;

class IronPdfCustomSize
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;
        
        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        
        pdf.SaveAs("custom-size.pdf");
        Console.WriteLine("Custom size PDF generated successfully");
    }
}

Gotenbergではマルチパートフォームデータに追加される文字列ベースのパラメータ("0.5")が必要です - 型の安全性なし、IntelliSenseなし、タイプミスしやすい。 IronPDFではPdfPaperSize enumと数値の余白値を持つ強く型付けされたプロパティを提供します。 IronPDFのマージンはミリメートル（50mm≈2インチ）ですが、Gotenbergはインチを使用していることに注意してください。

重要な移行に関する注意事項

単位変換

このGotenberg移行で最も重要な変換はマージン単位です：

// Gotenberg: margins in inches
content.Add(new StringContent("0.5"), "marginTop");    // 0.5 inches
content.Add(new StringContent("1"), "marginBottom");   // 1 inch

// IronPDF: margins in millimeters
renderer.RenderingOptions.MarginTop = 12.7;    // 0.5 inches × 25.4 = 12.7mm
renderer.RenderingOptions.MarginBottom = 25.4; // 1 inch × 25.4 = 25.4mm

変換式： millimeters = inches × 25.4

同期 vs 非同期

Gotenberg は HTTP 通信のため、非同期操作が必要です：

// Gotenberg: Forced async due to network calls
var response = await client.PostAsync(gotenbergUrl, content);
var pdfBytes = await response.Content.ReadAsByteArrayAsync();

// IronPDF: Synchronous in-process execution
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// IronPDF: Async wrapper if needed
var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf(html));

エラーハンドリング

// Gotenberg: HTTP error handling
try
{
    var response = await client.PostAsync(gotenbergUrl, content);
    response.EnsureSuccessStatusCode();  // What if 500? 503? Timeout?
}
catch (HttpRequestException ex) { /* Network error */ }
catch (TaskCanceledException ex) { /* Timeout */ }

// IronPDF: Standard .NET exceptions
try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
}
catch (Exception ex)
{
    Console.WriteLine($"PDF generation failed: {ex.Message}");
}

インフラストラクチャの削除

移行後は、インフラストラクチャからGotenbergを削除してください：

# REMOVE from docker-compose.yml:
# services:
#   gotenberg:
#     image: gotenberg/gotenberg:8
#     ports:
#       - "3000:3000"
#     deploy:
#       resources:
#         limits:
#           memory: 2G
YAML

パフォーマンスの考慮事項

レイテンシーの比較

手術ゴテンベルク（暖かい）Gotenberg（コールドスタート）IronPDF (ファーストレンダリング)IronPDF (後続)
シンプルなHTML150-300ms2～5秒1～2秒50-150ms
複雑なHTML500-1500ms3～7秒1.5-3秒200-800ms
URLレンダー1～5秒3～10秒1～5秒500ms-3s

インフラストラクチャのコスト削減

リソースGotenbergIronPDF
必要なコンテナ1-N (スケーリング)0
コンテナあたりのメモリ512MB-2GB該当なし
リクエストあたりのネットワーク・オーバーヘッド10-100ms0ms
ヘルスチェックのエンドポイント必須不要
ロードバランサ多くの場合不要

トラブルシューティング

問題 1: HttpClient パターンは必要ない

問題： コードは依然としてMultipartFormDataContentを使用しています。

解決策： 全てChromePdfRendererに置き換え：

// Remove all of this:
// using var client = new HttpClient();
// using var content = new MultipartFormDataContent();
// content.Add(new StringContent(html), "files", "index.html");
// var response = await client.PostAsync(url, content);

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

課題2：マージンの単位が間違っている

問題:移行後、PDF の余白が正しくありません。

解決策:インチをミリメートルに変換する:

//Gotenbergused inches: "0.5"
//IronPDFuses millimeters: 0.5 × 25.4 = 12.7
renderer.RenderingOptions.MarginTop = 12.7;

課題3：コンテナURLリファレンス

問題： コードにはhttp://gotenberg:3000または類似のURLが含まれています。

解決策:すべてのコンテナ URL 参照を削除します(IronPDF はインプロセスで実行されます)。

// Remove:
// private readonly string _gotenbergUrl = "http://gotenberg:3000";

//IronPDFneeds no URL - it's in-process
var renderer = new ChromePdfRenderer();

移行チェックリスト

移行前

  • コードベース内のすべてのGotenberg HTTP呼び出しをインベントリする
  • 現在のGotenberg構成 (タイムアウト、余白、用紙サイズ) を文書化します。
  • すべてのDocker/Kubernetes Gotenberg構成を特定する
  • IronPDFライセンスキーを取得する
  • インフラの廃止を計画する

コードの移行

-IronPDFNuGetパッケージをインストールしてください: dotnet add package IronPdf

  • Gotenbergクライアントパッケージを削除する
  • GotenbergへのすべてのHTTP呼び出しをIronPDFメソッド呼び出しに置き換えます
  • 余白の単位をインチからミリメートルに変換する
  • エラー処理を更新 (HTTP エラー → .NET例外)
  • 起動時にライセンスキーの初期化を追加

インフラストラクチャの移行

  • Docker Compose / KubernetesからGotenbergを削除する
  • CI/CD パイプラインを更新 (Gotenberg イメージ プルを削除)
  • Gotenbergヘルスチェックを削除
  • 設定からGotenberg URLを削除する

テスティング

  • HTMLからPDFへの変換テスト
  • URLからPDFへの変換テスト
  • マージンとサイズの正確さを確認する
  • 負荷テスト
  • 最初のレンダリングのウォームアップ時間をテストする

移行後

  • Gotenbergコンテナのデプロイメントを削除する -Gotenberg構成ファイルをアーカイブする
  • ドキュメントの更新
  • アプリケーションのメモリ使用量を監視する
  • 孤立したネットワーク接続がないことを確認する
ご注意: Gotenbergはその所有者の登録商標です。 このサイトは、Gotenbergと提携、承認、または支援を受けておらず、すべての製品名、ロゴ、およびブランドはそれぞれの所有者が所有するものです。 比較は情報提供のみを目的としており、執筆時点で公開されている情報を反映しています。
Curtis Chau
Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

詳しく読む

関連する記事

How to Render PDFs with Custom Paper Size | IronPDF
更新日 2026年7月19日
How to Render PDFs with Custom Paper Size | IronPDF
このビデオチュートリアルでは、C#とIronPDFを使ってPDFドキュメントにクリック可能な目次を作成する方法を説明します。大きなPDFファイルのナビゲーションを強化するための理想的なステップバイステップのガイドを提供します。これらの実践的なコーディングテクニックを学ぶことで、ドキュメントのユーザビリティと読者のエクスペリエンスを向上させましょう。
詳しく読む