Mesaj ikonu
Altbilgi içeriğine atla
  1. IronPDF
  2. IronPDF Blog
  3. Geçiş Kılavuzları
  4. Fluid to IronPDF Taşınması
GEçIş KıLAVUZLARı

Fluid (Şablonlama) Yapısından IronPDF'e Geçiş

Curtis Chau
Curtis Chau
Güncellendi:

Fluid, dinamik şablonlar oluşturmak ve içeriği sunum mantığından ayırmak için geliştiricilere esnek bir yol sunan Liquid şablon dilini uygulayan bir .NET kütüphanesidir. Fluid, dinamik metin çıktıları oluşturmakta etkili olsa da, doğrudan PDF oluşturmayı desteklemez — geliştiriciler HTML çıktısını PDF belgelerine dönüştürmek için ek bir PDF kütüphanesi entegre etmelidir. Bu iki kütüphaneli yaklaşım, birçok geliştirme ekibinin ortadan kaldırmaya çalıştığı bir karmaşıklık sunar.

Bu kılavuz, profesyonel .NET geliştiricilerin bu geçişi değerlendirmesi için adım adım talimatlar, kod karşılaştırmaları ve pratik örneklerle Fluid (şablonlama) ve harici PDF kütüphanelerinden IronPDF'ye tam bir geçiş yolu sağlar.

Fluid (Şablonlama) yerine IronPDF'ye Neden Göç Etmeli?

Fluid, sağlam bir Liquid tabanlı şablonlama motorudur, ancak PDF oluşturma için kullanılması önemli bir karmaşıklık getirir:

İki Kütüphane Bağımlılığı: Fluid yalnızca HTML üretir; PDF üretmek için ayrı bir PDF kütüphanesine (wkhtmltopdf, PuppeteerSharp, vb.) ihtiyaçınız var, bu da bağımlılıklarınızı ve bakım yükünüzü iki katına çıkarır.

Entegrasyon Karmaşıklığı: İki kütüphane koordine etmek, iki yapılandırma seti, hata yönetimi ve güncellemeleri yönetmek demektir. Bir şey kırıldığında, hata ayıklama daha zor hale gelir.

Liquid Syntax Öğrenme Eğrisi: Geliştiriciler, C# zaten güçlü dize işleme yeteneklerine sahipken, Liquid şablonlama sözdizimini ({{ }}, {% %}) öğrenmek zorundadır.

Sınırlı PDF Kontrolü: PDF çıktı kalitesi, Fluid ile eşleştireceğiniz PDF kütüphanesine bağlıdır, özel bir render motoruna değil.

Hata Ayıklama Zorlukları: Hatalar ya şablonlama ya da PDF oluşturma aşamasında meydana gelebilir, tek bir entegre çözümle karşılaştırıldığında sorun giderme sürecini daha zor hale getirir.

Thread Güvenliği Endişeleri: TemplateContext thread-güvenli değildir ve eşzamanlı uygulamalarda dikkatli bir yönetim gerektirir.

IronPDF vs Fluid (Şablonlama): Özellik Karşılaştırması

Mimari farklılıkları anlamak, teknik karar vericilerin geçiş yatırımını değerlendirmesine yardımcı olur:

Bağlam Fluid + PDF Kütüphanesi IronPDF
Bagimliliklar 2+ paket (Fluid + PDF kütüphanesi) Tek paket
Şablonlama Liquid sözdizimi ({{ }}) C# dizgi enterpolasyonu veya Razor
PDF Oluşturma Harici kütüphane gerekli Yerleşik Chromium motoru
CSS Desteği PDF kütüphanesine bağlı Flexbox/Grid ile tam CSS3
JavaScript PDF kütüphanesine bağlı Tam JavaScript desteği
İplik Güvenliği TemplateContext iş parçacığı-güvenli değil ChromePdfRenderer iş parçacığı-güvenli
Öğrenme Eğrisi Liquid + PDF kütüphane API'si HTML/CSS (web standartları)
Hata İşleme İki hata kaynağı Tek hata kaynağı

Hızlı Başlangıç: Fluid'den IronPDF'e Geçiş

Geçiş hemen bu temel adımlar ile başlatılabilir.

1. Adım: NuGet Paketlerini Değiştir

Fluid ve herhangi bir harici PDF kütüphanesini kaldırın:

# Remove Fluid and external PDF library
dotnet remove package Fluid.Core
dotnet remove package WkHtmlToPdf-DotNet  # or whatever PDF library you used
dotnet remove package PuppeteerSharp       # if used
# Remove Fluid and external PDF library
dotnet remove package Fluid.Core
dotnet remove package WkHtmlToPdf-DotNet  # or whatever PDF library you used
dotnet remove package PuppeteerSharp       # if used
SHELL

IronPDF'i yükleyin:

# InstallIronPDF(all-in-one solution)
dotnet add package IronPdf
# InstallIronPDF(all-in-one solution)
dotnet add package IronPdf
SHELL

Adım 2: Alan Adlarını Güncelle

Fluid ad alanlarını IronPdf ile değiştirin:

// Before (Fluid + external PDF library)
using Fluid;
using Fluid.Values;
using SomeExternalPdfLibrary;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;  // For RenderingOptions
// Before (Fluid + external PDF library)
using Fluid;
using Fluid.Values;
using SomeExternalPdfLibrary;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;  // For RenderingOptions
Imports Fluid
Imports Fluid.Values
Imports SomeExternalPdfLibrary

Imports IronPdf
Imports IronPdf.Rendering ' For RenderingOptions
$vbLabelText   $csharpLabel

Adım 3: Lisansı Başlat

Uygulama başlangıcında lisans başlatmasını ekleyin:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
$vbLabelText   $csharpLabel

Kod Geçiş Örnekleri

Temel HTML'den PDF'e

En temel işlem, bu yaklaşımlar arasındaki ana farkı ortaya koyar.

Fluid Yaklaşımı:

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

        // Fluid 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);

        // Fluid 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)

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

IronPDF Yaklaşımı:

// 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, bir FluidParser oluşturmayı, şablon dizisini ayrıştırmayı, bir TemplateContext oluşturmayı, her değişken için SetValue() çağırmayı, HTML elde etmek için eşzamansız olarak render etmeyi ve ardından bir dosyaya yazmayı gerektirir—ki bu yine de bir PDF değildir. Kodda yer alan yorum, açıkça 'Fluid sadece HTML üretir - PDF'e dönüştürmek için başka bir kütüphane gereklidir.' der.

IronPDF bu karmaşıklığı ortadan kaldırır: bir render oluşturun, RenderHtmlAsPdf() çağrısı yapın ve doğrudan PDF olarak kaydedin. Ara HTML dosyaları, ek kütüphaneler yok.

Gelişmiş HTML-PDF senaryoları için HTML'den PDF'e dönüştürme kılavuzuna bakın.

Dinamik Verilerle Fatura Şablonu

Birden çok değişken ile belge şablonları, şablon kalıbı farklarını açıkça gösterir.

Fluid Yaklaşımı:

// 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);
        // Fluid 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);
        // Fluid 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)
        ' Fluid outputs HTML - requires additional PDF library
        File.WriteAllText("invoice.html", html)
    End Function
End Module
$vbLabelText   $csharpLabel

IronPDF Yaklaşımı:

// 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, Liquid'in {{variable}} sözdizimini her değişken için context.SetValue() ile kullanır. Yorum açıkça "Fluid HTML üretir - ek PDF kütüphanesi gerektirir" notunu belirtir. IronPDF, geliştiricilerin zaten bildiği standart C# dize interpolasyonu ($"{variable}") kullanır ve doğrudan PDF'ye çıktı verir.

Daha fazla belge oluşturma deseni için IronPDF eğiticilerini keşfedin.

Döngüler ile Dinamik Veriler

Koleksiyonlar ve döngüler içeren şablonlar, kontrol akışı farklarını gösterir.

Fluid Yaklaşımı:

// 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);
        // Fluid 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);
        // Fluid 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 As 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 As New TemplateContext()
        context.SetValue("title", "My List")
        context.SetValue("items", New String() {"Item 1", "Item 2", "Item 3"})

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

IronPDF Yaklaşımı:

// 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, geliştiricilerin öğrenmesi gereken bir şablonlama dili olan Liquid'in {% for item in items %}...{% endfor %} sözdizimini kullanır. Yorum "Fluid yalnızca HTML üretir - ayrı PDF dönüşümü gereklidir" notunu belirtir. IronPDF, geliştiricilerin öğrenmesi gereken yeni bir sözdizimi olmadan standart C# foreach döngülerini kullanır ve doğrudan PDF'ye çıktı verir.

Fluid API'denIronPDFEşleme Başvurusu

Bu eşleme, doğrudan API eşdeğerlerini göstererek geçişi hızlandırır.

Çekirdek Sınıf Eşleştirmesi

Fluid Sınıfı IronPDF Eşdeğeri
FluidParser N/A
FluidTemplate N/A
TemplateContext C# nesneleri/dizgileri
TemplateOptions RenderingOptions
FluidValue Yerel C# tipleri
Harici PDF sınıfı ChromePdfRenderer

Yöntem Eşleştirme

Fluid Yöntemi IronPDF Eşdeğeri
new FluidParser() new ChromePdfRenderer()
parser.Parse(source) N/A
template.RenderAsync(context) renderer.RenderHtmlAsPdf(html)
context.SetValue("key", value) var key = value;

Liquid Sözdiziminden C# Eşleme

Liquid Syntax C# Eşdeğeri
{{ variable }} $"{variable}"
{% for item in items %} foreach (var item in items)
{% if condition %} if (condition)
{{ x \\|upcase }} x.ToUpper()
{{ x \\|tarih: '%Y-%m-%d' }} x.ToString("yyyy-MM-dd")
{{ x \\|number_with_precision: 2 }} x.ToString("F2")

Yaygın Taşınma Sorunları ve Çözümleri

Sorun 1: Liquid Sözdizimi Dönüşümü

Fluid: {{ variable }} ve {% control %} sözdizimini kullanır.

Çözüm: C# dize interpolasyonu ve kontrol akışı ile değiştirin.

// Liquid: {{ name | upcase }}
// C#: $"{name.ToUpper()}"

// Liquid: {% for item in items %}{{item}}{% endfor %}
// C#: foreach (var item in items) { html += $"{item}"; }
// Liquid: {{ name | upcase }}
// C#: $"{name.ToUpper()}"

// Liquid: {% for item in items %}{{item}}{% endfor %}
// C#: foreach (var item in items) { html += $"{item}"; }
$vbLabelText   $csharpLabel

Sorun 2: TemplateContext Değişkenleri

Fluid: Veri geçirmek için context.SetValue("key", value) kullanır.

Çözüm: Standart C# değişkenleri kullanın.

// Before (Fluid)
var context = new TemplateContext();
context.SetValue("customer", customerName);

// After (IronPDF)
var customer = customerName;
var html = $"<p>Customer: {customer}</p>";
// Before (Fluid)
var context = new TemplateContext();
context.SetValue("customer", customerName);

// After (IronPDF)
var customer = customerName;
var html = $"<p>Customer: {customer}</p>";
' Before (Fluid)
Dim context As New TemplateContext()
context.SetValue("customer", customerName)

' After (IronPDF)
Dim customer = customerName
Dim html = $"<p>Customer: {customer}</p>"
$vbLabelText   $csharpLabel

Sorun 3: Konu Güvenliği

Fluid: TemplateContext thread-güvenli değildir ve eşzamanlı uygulamalarda dikkatli bir yönetim gerektirir.

Çözüm: ChromePdfRenderer thread-güvenlidir ve thread'ler arasında paylaşılabilir:

// Thread-safe usage
private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

public byte[] GeneratePdf(string html)
{
    var pdf = _renderer.RenderHtmlAsPdf(html);
    return pdf.BinaryData;
}
// Thread-safe usage
private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

public byte[] GeneratePdf(string html)
{
    var pdf = _renderer.RenderHtmlAsPdf(html);
    return pdf.BinaryData;
}
' Thread-safe usage
Private Shared ReadOnly _renderer As New ChromePdfRenderer()

Public Function GeneratePdf(html As String) As Byte()
    Dim pdf = _renderer.RenderHtmlAsPdf(html)
    Return pdf.BinaryData
End Function
$vbLabelText   $csharpLabel

Sorun 4: İki Aşamalı Hata Yönetimi

Fluid: Hatalar şablonlama aşamasında VEYA PDF oluşturma aşamasında meydana gelebilir.

Çözüm: IronPDF, tek hata kaynağına sahiptir.

try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    // Single point of failure—easier debugging
    Console.WriteLine($"PDF generation failed: {ex.Message}");
}
try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    // Single point of failure—easier debugging
    Console.WriteLine($"PDF generation failed: {ex.Message}");
}
Try
    Dim pdf = renderer.RenderHtmlAsPdf(html)
    pdf.SaveAs("output.pdf")
Catch ex As Exception
    ' Single point of failure—easier debugging
    Console.WriteLine($"PDF generation failed: {ex.Message}")
End Try
$vbLabelText   $csharpLabel

Fluid Göç Kontrol Listesi

Ön Taşınma Görevleri

Kod tabanınızı gözden geçirerek tüm Fluid kullanımını belirleyin.

# Find all Fluid references
grep -r "FluidParser\|FluidTemplate\|TemplateContext\|using Fluid" --include="*.cs" --include="*.csproj" .

# Find Liquid template files
find . -name "*.liquid" -o -name "*.html" | xargs grep -l "{{"
# Find all Fluid references
grep -r "FluidParser\|FluidTemplate\|TemplateContext\|using Fluid" --include="*.cs" --include="*.csproj" .

# Find Liquid template files
find . -name "*.liquid" -o -name "*.html" | xargs grep -l "{{"
SHELL

Tüm şablonları belgeleyin: dosya konumları, kullanılan değişkenler, döngüler ve koşullar ve harici PDF kütüphane yapılandırması.

Kod Güncelleme Görevleri

  1. Fluid.Core NuGet paketini kaldırın
  2. Harici PDF kütüphane paketini kaldırın
  3. IronPdf NuGet paketini yükleyin
  4. Namespace ithalatlarını Fluid'dan IronPdf'ya güncelleyin
  5. {{ variable }}'yi $"{variable}"'ya dönüştürün
  6. {% for item in collection %}'yi C# foreach'ye dönüştürün
  7. {% if condition %}'yi C# if ifadelerine dönüştürün
  8. Liquid filtrelerini C# yöntemlerine dönüştürün (örneğin,| upcase→.ToUpper()`)
  9. FluidParser'yi ChromePdfRenderer ile değiştirin
  10. TemplateContext.SetValue()'i doğrudan C# değişkenleriyle değiştirin
  11. Harici PDF kütüphane çağrılarını kaldırın
  12. BaşlangıçtaIronPDFlisans başlatılmasını ekleyin

Taşınım Sonrası Test

Geçiş sonrasında aşağıdaki yönleri doğrulayın:

  • PDF çıktısının beklentilerle eşleştiğini doğrulayın
  • Tüm şablon varyasyonlarının düzgün şekilde oluşturulduğunu test edin
  • Görsellerin ve stilingin düzgün görüntülendiğini kontrol edin
  • Sayfa kesmelerinin düzgün gerçekleştiğini doğrulayın
  • Çeşitli veri boyutlarıyla test edin
  • Fluid + harici kütüphane ile kıyaslayarak performans testi yapın
  • Aynı anda çalışan senaryolarda konu güvenliğini test edin

Temizlik İşleri

  • .liquid şablon dosyalarını silin (artık gerekliyse)
  • Fluid ile ilgili yardımcı kodu kaldırın
  • Belgeleri güncelleyin
  • Kullanılmayan bağımlılıkları temizleyin

IronPDF'e Geçişin Temel Avantajları

Harici PDF kütüphaneleri ile Fluid'den (şablonlama) IronPDF'ye geçmek, birkaç önemli avantaj sunar:

Tek Paket Çözümü: İki kütüphane bağımlılığını ortadan kaldırın. IronPDF, hem şablonlama (HTML/CSS aracılığıyla) hem de PDF oluşturmayı tek bir pakette ele alır.

Yeni Sözdizimi Öğrenmeye Gerek Yok: Liquid şablonlama sözdizimi öğrenmek yerine standart C# dize interpolasyonu ve kontrol akışı kullanın.

Thread-Safe Rendering: ChromePdfRenderer thread-güvenlidir, TemplateContext aksine, eşzamanlı PDF üretimini basitleştirir.

Chromium Rendering Engine: Endüstri standardı oluşturma, Flexbox ve Grid dahil olmak üzere tam CSS3 desteği ve tam JavaScript çalıştırmasını sağlar.

Tek Hata Kaynağı: Şablonlama ve PDF oluşturma aşamaları arasında koordine etmek yerine yalnızca bir kütüphanede sorun gidermek, hata ayıklamayı basitleştirir.

Aktif Geliştirme: 2026 boyunca .NET 10 ve C# 14 benimsenmesi arttıkça, IronPDF'in düzenli güncellemeleri mevcut ve gelecekteki .NET sürümleriyle uyumluluğu sağlar.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku

İlgili Makaleler

30 günlük deneme → Tam ürün. Sınırlama yok. Kart gerekmez. Ücretsiz Deneme Başlat

Iron Destek Ekibi

Haftanın 5 günü, 24 saat çevrimiçiyiz.
Sohbet
E-posta
Beni Ara