比較

Fluid TemplatingとIronPDFの比較：技術比較ガイド

公開日:

.NET開発者がPDF文書を動的に作成する必要がある場合、技術の選択はワークフローの効率と出力品質に大きく影響します。 Fluidテンプレートは、動的なHTMLコンテンツを生成するための人気のあるLiquidベースのエンジンです。 しかし、ネイティブのPDF生成機能がないため、PDF出力が必要な場合は複雑さが増します。 IronPdfはテンプレート化（HTML/CSS経由）と内蔵のChromiumレンダリングエンジンによるPDF生成の両方を扱う完全なソリューションを提供します。

この比較では、.NET PDFのニーズに対して、プロの開発者やアーキテクトが十分な情報に基づいた決定を下せるように、技術的に関連する次元で両方のアプローチを検証します。

流体テンプレートについて

Fluidは、主にテンプレートを使用して動的なテキスト出力を生成するために使用されるテンプレート言語Liquidを実装する.NETライブラリです。 このライブラリは、{{ }}を変数出力に、{% %}をループや条件文のような制御フロー文に使用するLiquid構文を使用して、開発者がコンテンツとプレゼンテーションロジックを分離することを可能にします。

Fluidは、FluidParserを使ってテンプレート文字列を解析し、TemplateContextを使ってデータ値をバインドします。 RenderAsync()メソッドは、ファイルに書き込んだり、さらに処理したりできる HTML 出力を生成します。 しかし、FluidはPDF生成を直接サポートしていません。開発者は、HTML出力をPDF形式に変換するために、別のPDFライブラリ（wkhtmltopdf、PuppeteerSharpなど）を統合する必要があります。

重要な考慮点は、TemplateContextはスレッドセーフではないので、複数のPDF文書が同時に生成されるような並行アプリケーションでは慎重な管理が必要だということです。

IronPDFの理解

IronPDFは.NET PDFライブラリで、HTMLコンテンツから直接PDFを生成するための完全なソリューションを提供します。 このライブラリは最新のChromiumレンダリングエンジンを使用しており、開発者は使い慣れたHTMLとCSSを使用してテンプレートを記述し、プロフェッショナルなPDFドキュメントに直接変換することができます。

IronPDFはChromePdfRendererを主要なレンダリングクラスとして使用し、RenderHtmlAsPdf()はHTML文字列を受け取り、保存、マージ、保護、あるいはさらに操作できるPdfDocumentオブジェクトを生成します。 レンダラーはスレッドセーフであり、同時PDF生成シナリオを簡素化します。

アーキテクチャと依存性の比較

これらのアプローチの基本的な違いは、アーキテクチャと必要な依存関係の数にあります。

アスペクトFluid + PDF ライブラリIronPDF
依存関係について2つ以上のパッケージ（Fluid + PDFライブラリ）単一パッケージ
テンプレート化する。リキッド構文 ({{ }}<//code>)C# 文字列補間または Razor
PDFジェネレーション。外部ライブラリが必要内蔵Chromiumエンジン
CSSサポートPDFライブラリに依存フルCSS3とFlexbox/Grid
JavaScript（ジャバスクリプトPDFライブラリに依存JavaScriptフルサポート
スレッドセーフティスレッドセーフではない TemplateContextChromePdfRendererはスレッドセーフです。
ラーニングカーブLiquid + PDF ライブラリ APIHTML/CSS（ウェブ標準）
エラー処理。2つのエラーソース単一のエラーソース

Fluidテンプレートは、2つのライブラリに依存するという課題をもたらします：テンプレート化にはFluidが必要で、変換には別のPDFライブラリが必要です。 これは、2組の設定、エラー処理パターン、更新サイクルを管理することを意味します。 IronPdfはこの2つの機能を1つのパッケージに統合しています。

コードの比較：一般的なPDF操作

基本的なHTMLからPDFへの生成

最も基本的な操作は、2つのアプローチのアーキテクチャの違いを示しています。

流体テンプレート:

// NuGet: Install-Package Fluid.Core
using Fluid;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var parser = new FluidParser();
        var template = parser.Parse("<html><body><h1>Hello {{name}}!</h1></body></html>");
        var context = new TemplateContext();
        context.SetValue("name", "World");
        var html = await template.RenderAsync(context);

        //流動的only generates HTML - you'd need another library to convert to PDF
        File.WriteAllText("output.html", html);
    }
}
// NuGet: Install-Package Fluid.Core
using Fluid;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var parser = new FluidParser();
        var template = parser.Parse("<html><body><h1>Hello {{name}}!</h1></body></html>");
        var context = new TemplateContext();
        context.SetValue("name", "World");
        var html = await template.RenderAsync(context);

        //流動的only generates HTML - you'd need another library to convert to PDF
        File.WriteAllText("output.html", html);
    }
}
Imports Fluid
Imports System.IO
Imports System.Threading.Tasks

Module Program
    Async Function Main() As Task
        Dim parser As New FluidParser()
        Dim template = parser.Parse("<html><body><h1>Hello {{name}}!</h1></body></html>")
        Dim context As New TemplateContext()
        context.SetValue("name", "World")
        Dim html = Await template.RenderAsync(context)

        '流動的only generates HTML - you'd need another library to convert to PDF
        File.WriteAllText("output.html", html)
    End Function
End Module
$vbLabelText   $csharpLabel

IronPDF:

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World!</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World!</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim html = "<html><body><h1>Hello World!</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
    End Sub
End Class
$vbLabelText   $csharpLabel

Fluidは、FluidParserを作成し、テンプレート文字列を解析し、TemplateContextを作成し、SetValue()で値を設定し、RenderAsync()を呼び出し、そして結果のHTMLをファイルに書き込む必要があります。コードのコメントには、明確にこう書かれています："FluidはHTMLを生成するだけです。PDFに変換するには別のライブラリが必要です。"

IronPDFはChromePdfRendererを作成し、RenderHtmlAsPdf()に直接HTMLを渡し、SaveAs()を呼び出してPDFファイルを作成します。

高度なHTMLレンダリングオプションについては、HTMLからPDFへの変換ガイドをご覧ください。

動的データを含む請求書テンプレート

請求書のようなビジネス文書の生成では、データ・バインディングの違いが示されます。

流体テンプレート:

// NuGet: Install-Package Fluid.Core
using Fluid;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var parser = new FluidParser();
        var template = parser.Parse(@"
            <html><body>
                <h1>Invoice #{{invoiceNumber}}</h1>
                <p>Date: {{date}}</p>
                <p>Customer: {{customer}}</p>
                <p>Total: ${{total}}</p>
            </body></html>");

        var context = new TemplateContext();
        context.SetValue("invoiceNumber", "12345");
        context.SetValue("date", DateTime.Now.ToShortDateString());
        context.SetValue("customer", "John Doe");
        context.SetValue("total", 599.99);

        var html = await template.RenderAsync(context);
        //流動的outputs HTML - requires additional PDF library
        File.WriteAllText("invoice.html", html);
    }
}
// NuGet: Install-Package Fluid.Core
using Fluid;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var parser = new FluidParser();
        var template = parser.Parse(@"
            <html><body>
                <h1>Invoice #{{invoiceNumber}}</h1>
                <p>Date: {{date}}</p>
                <p>Customer: {{customer}}</p>
                <p>Total: ${{total}}</p>
            </body></html>");

        var context = new TemplateContext();
        context.SetValue("invoiceNumber", "12345");
        context.SetValue("date", DateTime.Now.ToShortDateString());
        context.SetValue("customer", "John Doe");
        context.SetValue("total", 599.99);

        var html = await template.RenderAsync(context);
        //流動的outputs HTML - requires additional PDF library
        File.WriteAllText("invoice.html", html);
    }
}
Imports Fluid
Imports System
Imports System.IO
Imports System.Threading.Tasks

Module Program
    Async Function Main() As Task
        Dim parser As New FluidParser()
        Dim template = parser.Parse("
            <html><body>
                <h1>Invoice #{{invoiceNumber}}</h1>
                <p>Date: {{date}}</p>
                <p>Customer: {{customer}}</p>
                <p>Total: ${{total}}</p>
            </body></html>")

        Dim context As New TemplateContext()
        context.SetValue("invoiceNumber", "12345")
        context.SetValue("date", DateTime.Now.ToShortDateString())
        context.SetValue("customer", "John Doe")
        context.SetValue("total", 599.99)

        Dim html = Await template.RenderAsync(context)
        '流動的outputs HTML - requires additional PDF library
        File.WriteAllText("invoice.html", html)
    End Function
End Module
$vbLabelText   $csharpLabel

IronPDF:

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var invoiceNumber = "12345";
        var date = DateTime.Now.ToShortDateString();
        var customer = "John Doe";
        var total = 599.99;

        var html = $@"
            <html><body>
                <h1>Invoice #{invoiceNumber}</h1>
                <p>Date: {date}</p>
                <p>Customer: {customer}</p>
                <p>Total: ${total}</p>
            </body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("invoice.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var invoiceNumber = "12345";
        var date = DateTime.Now.ToShortDateString();
        var customer = "John Doe";
        var total = 599.99;

        var html = $@"
            <html><body>
                <h1>Invoice #{invoiceNumber}</h1>
                <p>Date: {date}</p>
                <p>Customer: {customer}</p>
                <p>Total: ${total}</p>
            </body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("invoice.pdf");
    }
}
Imports IronPdf
Imports System

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        Dim invoiceNumber As String = "12345"
        Dim [date] As String = DateTime.Now.ToShortDateString()
        Dim customer As String = "John Doe"
        Dim total As Double = 599.99

        Dim html As String = $"
            <html><body>
                <h1>Invoice #{invoiceNumber}</h1>
                <p>Date: {[date]}</p>
                <p>Customer: {customer}</p>
                <p>Total: ${total}</p>
            </body></html>"

        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("invoice.pdf")
    End Sub
End Module
$vbLabelText   $csharpLabel

Fluidは、各変数にcontext.SetValue()を持つLiquid構文（{invoiceNumber}}<//code>, {date}}<//code>）を使用しています。 IronPDFは開発者がすでに知っているC#の文字列補間($"{invoiceNumber}", $"{date}")を使用します。 Fluidの例では、ワークフローを完了するために"追加のPDFライブラリが必要"であることを明記しています。

動的なリストとコレクション

データ・コレクションを繰り返し処理することで、コントロール・フローの違いを示しています。

流体テンプレート:

// NuGet: Install-Package Fluid.Core
using Fluid;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var parser = new FluidParser();
        var template = parser.Parse(@"
            <html><body>
                <h1>{{title}}</h1>
                <ul>
                {% for item in items %}
                    <li>{{item}}</li>
                {% endfor %}
                </ul>
            </body></html>");

        var context = new TemplateContext();
        context.SetValue("title", "My List");
        context.SetValue("items", new[] { "Item 1", "Item 2", "Item 3" });

        var html = await template.RenderAsync(context);
        //流動的generates HTML only - separate PDF conversion needed
        File.WriteAllText("template-output.html", html);
    }
}
// NuGet: Install-Package Fluid.Core
using Fluid;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var parser = new FluidParser();
        var template = parser.Parse(@"
            <html><body>
                <h1>{{title}}</h1>
                <ul>
                {% for item in items %}
                    <li>{{item}}</li>
                {% endfor %}
                </ul>
            </body></html>");

        var context = new TemplateContext();
        context.SetValue("title", "My List");
        context.SetValue("items", new[] { "Item 1", "Item 2", "Item 3" });

        var html = await template.RenderAsync(context);
        //流動的generates HTML only - separate PDF conversion needed
        File.WriteAllText("template-output.html", html);
    }
}
Imports Fluid
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks

Class Program
    Shared Async Function Main() As Task
        Dim parser = New FluidParser()
        Dim template = parser.Parse("
            <html><body>
                <h1>{{title}}</h1>
                <ul>
                {% for item in items %}
                    <li>{{item}}</li>
                {% endfor %}
                </ul>
            </body></html>")

        Dim context = New TemplateContext()
        context.SetValue("title", "My List")
        context.SetValue("items", New String() {"Item 1", "Item 2", "Item 3"})

        Dim html = Await template.RenderAsync(context)
        '流動的generates HTML only - separate PDF conversion needed
        File.WriteAllText("template-output.html", html)
    End Function
End Class
$vbLabelText   $csharpLabel

IronPDF:

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var title = "My List";
        var items = new[] { "Item 1", "Item 2", "Item 3" };

        var html = $@"
            <html><body>
                <h1>{title}</h1>
                <ul>";

        foreach (var item in items)
        {
            html += $"<li>{item}</li>";
        }

        html += "</ul></body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("template-output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var title = "My List";
        var items = new[] { "Item 1", "Item 2", "Item 3" };

        var html = $@"
            <html><body>
                <h1>{title}</h1>
                <ul>";

        foreach (var item in items)
        {
            html += $"<li>{item}</li>";
        }

        html += "</ul></body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("template-output.pdf");
    }
}
Imports IronPdf
Imports System
Imports System.Collections.Generic

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        Dim title As String = "My List"
        Dim items As String() = {"Item 1", "Item 2", "Item 3"}

        Dim html As String = $"
            <html><body>
                <h1>{title}</h1>
                <ul>"

        For Each item As String In items
            html += $"<li>{item}</li>"
        Next

        html += "</ul></body></html>"

        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("template-output.pdf")
    End Sub
End Module
$vbLabelText   $csharpLabel

FluidはLiquidループ構文（{% for item in items %}...{% endfor %}）を使用し、IronPDFは標準的なC#のforeachループを使用します。 Fluidの例では、ワークフローを完成させるために"別途PDF変換が必要"であることを再度指摘しています。

HTMLレンダリングについてはIronPDFチュートリアルをご覧ください。

シンタックス マッピング リファレンス

流体テンプレートの移行を評価したり、機能を比較したりする開発者のために、このマッピングは同等の構文を示します：

変数出力

フルイド（液体）IronPdf (C#)
{{ 変数 }}<//code>$"{変数}"</code
{{ オブジェクト.プロパティ }}<//code>$"{オブジェクト.プロパティ}"</code

コントロールフロー

フルイド（液体）IronPdf (C#)
{% for item in items %}<//code>foreach (var item in items)
{% endfor %}<//code>}<//code>
{% if 条件 %}<//code>if (条件)。
{% endif %}<//code>}<//code>

フィルタからメソッドへ

フルイド（液体）IronPdf (C#)
{{ x \|アップケース }}x.ToUpper()</code
{{ x \|ダウンケース }}x.ToLower()</code
{{ x \|date: '%Y-%m-%d' }}.x.ToString("yyyy-MM-dd")。

コア クラス マッピング

流動的IronPDF
FluidParser</code該当なし
テンプレートコンテキスト</codeC#オブジェクト/文字列
context.SetValue("key", value).var キー = 値;.
template.RenderAsync(context).renderer.RenderHtmlAsPdf(html).
テンプレートオプション</codeレンダリングオプション</code

機能比較の概要

フィーチャー流体テンプレートIronPDF
PDF生成❌ (外部ライブラリが必要)✅ (ビルトイン)
HTML出力✅✅
リキッド構文✅該当なし（C#を使用）
C# 文字列補間該当なし✅
スレッドセーフコンテキスト❌✅
単一パッケージソリューション❌✅
CSS3 フレックスボックス/グリッドPDFライブラリに依存✅
JavaScriptサポートPDFライブラリに依存✅
ヘッダー/フッターPDFライブラリに依存✅ (HTMLベース)
PDFセキュリティPDFライブラリに依存✅
PDFマージPDFライブラリに依存✅

チームがFluid TemplatingからIronPDFへの移行を検討するとき

開発チームはいくつかの理由で流体テンプレートからIronPDFへの移行を評価しています：

2つのライブラリの複雑さ: FluidはHTMLを生成するだけです-チームはPDFを作成するために別のPDFライブラリ（wkhtmltopdf、PuppeteerSharpなど）を必要とします。 これは、依存関係、構成、潜在的なエラーの原因を倍増します。 IronPDFはテンプレート作成（HTML/CSS経由）とPDF生成の両方を1つのパッケージで提供することにより、このような問題を解決します。

統合とデバッグのオーバーヘッド: 2つのライブラリを調整するということは、2組の設定、エラー処理パターン、更新サイクルを管理するということです。 テンプレート化またはPDF生成のいずれかの段階でエラーが発生する可能性があり、トラブルシューティングが困難になります。 IronPdfはよりシンプルなデバッグのために単一のエラーソースを提供します。

スレッドセーフの要件:テンプレートコンテキスト</codeはスレッドセーフではないため、並行アプリケーションでは慎重な管理が必要です。 ChromePdfRendererはスレッドセーフで、WebアプリケーションでよくあるマルチスレッドPDF生成シナリオを簡素化します。

学習曲線に関する考察:開発者は、C#がすでに補間とStringBuilderを通して強力な文字列処理を提供しているのに、液体のテンプレート構文（{{ }}、{% %}）を学ばなければなりません。 IronPdfはほとんどの開発者がすでに持っているHTML/CSSの知識を活用します。

PDF出力の品質: PDF出力の品質と機能は、Fluidとどの外部PDFライブラリがペアになっているかに完全に依存します。 IronPdfに内蔵されたChromiumエンジンはFlexboxやGridレイアウトを含むCSS3をフルサポートし、一貫した高品質のレンダリングを提供します。

長所と考慮点

フルイド テンプレートの強み

  • 懸念事項の分離： コンテンツとプレゼンテーションのロジックをきれいに分離すること。
  • Liquidの互換性: 他のプラットフォームからの開発者におなじみの標準的なLiquidの構文
  • MITライセンス: オープンソース、パーミッシブライセンス
  • 柔軟性：さまざまなPDFライブラリと組み合わせることができます。

流動的なテンプレート作成の考察

  • PDFライブラリではありません:テンプレート用に特別に構築されており、PDF出力機能を欠いています。
  • 統合の必要性： PDF生成のための他のソリューションとのつなぎ合わせが必要です。
  • 学習曲線: 標準的なC#を超えるLiquid構文の学習が必要です。
  • スレッドセーフ: TemplateContextは同時実行シナリオではスレッドセーフではありません。
  • デバッグの複雑さ：エラーはテンプレート化またはPDF生成のいずれかの段階で発生する可能性があります。

IronPDFの強み

  • オールインワン・ソリューション： HTMLテンプレート化とPDF生成を1つのパッケージで実現
  • Chromiumレンダリング: ピクセルパーフェクトな出力のための業界標準のレンダリングエンジン。
  • ウェブ技術：完全なCSS3、Flexbox、グリッド、およびJavaScriptのサポート
  • スレッドセーフ: ChromePdfRendererは並行処理のためのスレッドセーフです。
  • 単一のエラーソース: 統一されたエラー処理でデバッグがより簡単になります。
  • プロフェッショナルな機能: ヘッダー、フッター、透かし、セキュリティ-すべて組み込みです。
  • 包括的なリソース: 豊富なチュートリアルとドキュメント。

IronPDFについての考察

  • リキッド構文なし:代わりにC#文字列補間を使用（C#開発者にはおなじみです）。
  • 商用ライセンス: 本番使用ライセンスが必要です。

結論

FluidテンプレートとIronPDFは.NETエコシステムにおいて異なる主要な目的を果たします。 Fluidは、動的なHTMLコンテンツを生成するためのLiquidベースのテンプレートエンジンとして優れており、懸念事項のクリーンな分離と標準的なLiquid構文を備えています。 ただし、PDFを生成しないことを明示しているため、開発者は別のPDFライブラリを統合して調整する必要があります。

IronPDFはオールインワンのソリューションを提供し、2つのライブラリ依存の問題を解決します。 テンプレートにHTML/CSSを使用し、PDFレンダリングに組み込みのChromiumエンジンを提供することで、IronPDFは複雑さを軽減し、デバッグを改善し、スレッドセーフを保証します。

組織が.NET 10、C# 14、および2026年までのアプリケーション開発を計画しているため、特定の要件に応じて選択する必要があります。 Liquid の構文の互換性を重視し、すでに PDF 生成インフラを持っているチームは、Fluid を使い続けることができます。 複数のライブラリを調整するオーバーヘッドなしに合理的なPDF生成を求めるチームにとって、IronPdfはより統合されたアプローチを提供します。

無料トライアルでIronPDFの評価を開始し、包括的なドキュメントを参照して、特定の要件への適合性を評価してください。