How to Convert Razor Views to PDFs Headlessly in C

Neden IronPdf.Extensions.Razor yerine Razor.Templating.Core'a ihtiyacım var?

Razor.Templating.Core, web bağlamı veya tarayıcı penceresi olmadan Razor Görünümlerini HTML'ye dönüştürerek gerçek başsız görüntüleme sağlar. Bu, arka plan hizmetleri, konsol uygulamaları veya UI'siz ortamlar için uygundur. IronPdf.Extensions.Razor çalışabilmesi için bir web bağlamı gerektirir.

Başsız PDF Oluşturma İçin Hangi Proje Türü En İyi Çalışır?

ASP.NET Core Web Uygulaması (Model-View-Controller) projeleri, gerekli Razor Görünüm altyapısını esnek dağıtım seçenekleriyle sağlar. Bu yaklaşımı arka plan hizmetlerinde, Azure İşlevlerinde veya konsol uygulamalarında kullanın. Bulut tabanlı oluşturma için IronPDF'yi Azure'a dağıtma konusuna bakın.

Gerekli NuGet Paketlerini Nasıl Yüklerim?

NuGet Paket Yöneticisi kullanarak paketleri yükleyin. IronPdf ve Razor.Templating.Core'ye ihtiyacınız var:

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

' Install via Package Manager Console
' Install-Package IronPdf
' Install-Package Razor.Templating.Core

' Or add to your .vbproj file
' <PackageReference Include="IronPdf" Version="2024.x.x" />
' <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

Razor Görünümüme Hangi HTML İçeriğini Eklemeliyim?

PDF olarak render edeceğiniz HTML'i ekleyin:

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

Karmaşık düzenler için, mükemmel PDF render'i sağlamak adına CSS ve baskı stillerini kullanın. IronPDF, gelişmiş belge düzenleri için modern CSS3 özelliklerini destekler.

PDF Veri Görüntüleme İçin Neden Tablolar Kullanılmalı?

Tablolar, basılı belgelere iyi çevirilen, yapılandırılmış ve organize bilgi sağlar. Farklı platformlar arasında tutarlı biçimlendirme sağlarlar ve PDF formatında okunabilirler. IronPDF'nin render motoru, kenarlıkları, boşlukları ve hizalamaları korumada tablo düzenlerini iyi işler. Gelişmiş biçimlendirme için, düzeni optimize etmek adına özel kenar boşluklarını araştırın.

PDF Çıktısı İçin Genel Biçimlendirme Düşünceleri Nelerdir?

PDF çıktısı için, baskı özeline özgü CSS medya sorgularını, göreli birimler yerine sabit piksel değerlerini ve tutarlı render için gömülü yazı tiplerini kullanın. IronPDF, web yazı tipleri ve simge yazı tipleri ile marka tutarlılığını destekler. Çok sayfalı belgeler için sayfa sonlarını ve profesyonel görünüm için uygun kenar boşluklarını düşünün.

PDF'lerime Uygulayabileceğim Hangi Render Seçenekleri Mevcut?

IronPDF geniş kapsamlı render seçenekleri sunar. Başlıklar ve altbilgiler ekleyin, özel kağıt boyutları ayarlayın, sayfa yönünü kontrol edin ve filigranlar ekleyin. ChromePdfRenderer, PDF oluşturmayı özelleştirmek için 50'den fazla özellik sunar.

PDF Oluşturma Sırasında Hataları Nasıl Yönetirim?

Güçlü PDF oluşturma için hata yönetimini uygulayın:

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

Imports IronPdf
Imports System.Threading.Tasks

Public Class PdfGenerator
    Public Shared Async Function GeneratePdfAsync() As Task(Of IResult)
        Try
            Dim html = Await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml")
            Dim renderer = New ChromePdfRenderer()
            Dim pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot")
            Return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf")
        Catch ex As Exception
            ' Log the error details
            IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}")
            Return Results.Problem("Failed to generate PDF", statusCode:=500)
        End Try
    End Function
End Class

Detaylı Günlüklemeyi Ne Zaman Aktifleştirmeliyim?

Detaylı günlüklemeyi geliştirme ve sorun giderme sırasında etkinleştirin. IronPDF'nin günlüğü, render süreci hakkında içgörüler sağlar, HTML analizini, varlık yüklemeyi veya yapılandırma sorunlarını tanımlamaya yardımcı olur. Üretim için, özel günlükleme kullanarak uygulamanızın günlük yapısına entegre edin.

Başka Hangi Yol İlgili Sorunlarına Dikkat Etmeliyim?

Tilde (~) yol sorununun ötesinde, görüntü kaynaklarının mutlak yollar veya doğru göreli referanslar kullandığından emin olun. Dış kaynaklar için, varlıkların doğru bir şekilde yüklenmesini sağlamak için temel URL'ler kullanın. Azure Blob Storage görüntüleri için, Azure Blob Storage'dan görüntüleri gömme konusunda bilgi alın.

Statik Varlıklar PDF Oluşturmayı Nasıl Etkiler?

Statik varlıklar (CSS, JavaScript, resimler), PDF oluşturma performansı ve kalitesini etkiler. Render sırasında varlıkların erişilebilir olduğunu sağlayın, optimize edilmiş görüntüler kullanın ve daha hızlı render için kritik CSS'i satır içi eklemeyi düşünün. JavaScript ağırlıklı içeriklerde render gecikmeleri ve zaman aşımları hakkında bilgi edinin.

Projeyi çalıştırarak bir PDF belgesi oluşturun.

Çıktı PDF

Son PDF'im Neye Benzemeli?

PDF'niz tüm Razor Görünüm biçimlendirmelerini—tablo yapıları, yazı tipleri, renkler ve düzen—korumalıdır. Uygun bir boyutlandırma, temiz kenar boşlukları ve profesyonel görünüm sağlamalıdır. Çıktı kalitesini doğrulamak için IronPDF'nin rasterizasyon özelliklerini kullanarak sayfaları görüntü olarak önizleyin.

Yaygın PDF Render Sorunlarını Nasıl Çözerim?

Yaygın sorunlar arasında eksik stiller, bozuk düzenler veya eksik içerik bulunur. Detaylı günlüklemeyi etkinleştirin, varlık yollarını doğrulayın ve HTML'in düzgün bir şekilde doğrulandığından emin olun. Karmaşık düzenler için, Chrome hata ayıklama araçlarını kullanarak dönüştürmeden önce HTML'yi önizleyin. Belirli render sorunları için, içerik yüklemesi öncesinde WaitFor gecikmelerini kullanın.

Örnek Projeyi Çalıştırmak İçin Gereksinimler Nelerdir?

Visual Studio 2019 veya sonrası ile .NET 6.0 SDK veya üstüne ihtiyacınız var. Proje, NuGet paketi geri yüklemesi için internet bağlantısı gerektirir. Çalıştırmadan önce Program.cs içindeki IronPDF lisans anahtarınızı güncelleyin. Dağıtım için, ek gereksinimler için Windows kurulum kılavuzunu inceleyin.

Örneği Kendi Kullanım Durumuma Nasıl Özelleştiririm?

Örnek, belirli ihtiyaçlarınız için bir temel sağlar. Dinamik veri modelleri ekleyin, sıkça oluşturulan PDF'ler için önbellekleme uygulayın veya mevcut kimlik doğrulama ile entegrasyon yapın. Gelişmiş senaryolar için, performansı artırmak adına eşzamanlı olmayan PDF oluşturmayı keşfedin veya dosya boyutlarını azaltmak için PDF sıkıştırma uygulayın. Belge doğruluğu için dijital imzalar ekleyin veya hassas belgeler için şifre koruması uygulayın.