How to Convert Razor Views to PDFs Headlessly in C

Neden IronPdf.Extensions.Razor Yerine Razor.Templating.Core'a İhtiyacım Var?

Razor.Templating.Core, gerçek başsız işleme sağlar—Razor Görünümlerini HTML'ye bir web bağlamı veya tarayıcı penceresi olmadan dönüştürme. Bu, arka plan hizmetleri, komut satırı uygulamaları veya arayüzsüz ortamlar için uygundur. IronPdf.Extensions.Razor çalışmak için bir web bağlamı gerektirir.

Hangi Proje Türü Başsız PDF Üretimi İçin 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ı üretim için IronPDF'yi Azure'a dağıtma konusuna bakın.

Gerekli NuGet Paketlerini Nasıl Kurarım?

NuGet Paket Yöneticisi kullanarak paketleri yükleyin. IronPDF ve Razor.Templating.Core'a ihtiyaçı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 Ne Tür HTML İçeriği Eklemeliyim?

PDF olarak ö render etmek istediğiniz HTML'yi 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 oluşturulmasını sağlamak için CSS ve yazdırma stillerini kullanın. IronPDF, karmaşık belge düzenleri için modern CSS3 özelliklerini destekler.

PDF Veri Gösterimi İçin Neden Tablolar Kullanılmalı?

Tablolar, yazılı belgelerde iyi çevrilen yapılandırılmış, düzenli bilgi sağlar. Farklı platformlar arasında tutarlı biçimlendirmeyi korurlar ve PDF formatında okunabilirdirler. IronPDF'nin işleme motoru, tablo düzenlerini iyi işler, kenarlıklar, aralıklar ve hizalamayı korur. Gelişmiş biçimlendirme için düzeni optimize etmek amacıyla özel kenar boşluklarını keşfedin.

PDF Çıkışı İçin Yaygın Biçimlendirme Düşünceleri Nelerdir?

PDF çıktısı için yazdırma odaklı CSS medya sorguları, göreli birimler yerine sabit piksel değerleri ve tutarlı render için yerleştirilmiş yazı tipleri kullanın. IronPDF, marka tutarlılığı için web yazı tiplerini ve simge yazı tiplerini destekler. Çok sayfalı belgeler ve profesyonel görünüm için uygun kenar boşlukları için sayfa kesmelerini düşünün.

PDF'lerime Uygulayabileceğim İşleme Seçenekleri Nelerdir?

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

PDF Üretimi Sırasında Hataları Nasıl Ele Alırım?

Güçlü PDF üretimi için hata işleme 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ükleme Ne Zaman Etkinleştirilmelidir?

Geliştirme ve sorun giderme sırasında detaylı günlükleme etkinleştirin. IronPDF'nin günlüğü, HTML ayrıştırma, varlık yükleme veya yapılandırma sorunlarını belirlemeye yardımcı olur. Üretim için, uygulamanızın günlük altyapısıyla entegre olmak için özel günlükleme kullanın.

Başka Hangi Yol İlgili Sorunları İzlemeliyim?

Tilde (~) yol sorununun ötesinde, resim kaynaklarının mutlak yollar veya doğru göreli referanslar kullandığından emin olun. Dış kaynaklar için varlıkların doğru şekilde yüklenmesini sağlamak için temel URL'ler kullanın. Azure Blob Storage resimleri için Azure Blob Storage'dan resimleri yerleştirme konusuna bakın.

Durağan Varlıklar PDF Üretimini Nasıl Etkiler?

Durağan varlıklar (CSS, JavaScript, resimler), PDF üretim performansını ve kalitesini etkiler. Varlıkların işleme sırasında erişilebilir olduğundan emin olun, optimize edilmiş resimler kullanın ve daha hızlı işleme için kritik CSS'yi içeri gömme düşünün. JavaScript yoğun içerik için işlem gecikmeleri ve zaman aşımı hakkında bilgi edinin.

Bir PDF belgesi oluşturmak için projeyi çalıştırın.

Çıktı PDF

Son PDF'im Nasıl Olmalı?

PDF'iniz tüm Razor Görünüm biçimlendirmesini—tablo yapıları, yazı tipleri, renkler ve düzen—korumalıdır. Temiz kenar boşlukları ve profesyonel bir görünümle uygun şekilde boyutlandırılmış olmalıdır. Çıktı kalitesini doğrulamak için IronPDF'nin rasterizasyon özelliklerini kullanarak sayfaları görüntü olarak önizleyin.

Yaygın PDF İşleme Sorunlarını Nasıl Çözebilirim?

Yaygın sorunlar arasında eksik stiller, kırık düzenler veya eksik içerik bulunur. Detaylı günlükleme etkinleştirin, varlık yollarını doğrulayın ve HTML'nin doğru şekilde doğrulandığından emin olun. Karmaşık düzenler için dönüşümden önce HTML'yi önizlemek için Chrome hata ayıklama araçlarını kullanın. Belirli işleme sorunları için içerik yüklenmesini sağlamak amacıyla WaitFor gecikmeleri kullanın.

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

Visual Studio 2019 veya daha yeni bir sürüme ve en az .NET 6.0 SDK'ye ihtiyaçınız var. Proje, NuGet paketini geri yüklemek için internet bağlantısı gerektirir. Çalıştırmadan önce Program.cs içinde IronPDF lisans anahtarınızı güncelleyin. Dağıtım için ilave gereksinimler için Windows kurulum kılavuzunu inceleyin.

Örneği Kendi Kullanım Durumuma Nasıl Uyarlayabilirim?

Örnek, spesifik 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 sistemleri ile entegre edin. Gelişmiş senaryolar için, iyileştirilmiş performans için asenkron PDF oluşturmayı veya dosya boyutlarını küçültmek için PDF sıkıştırma uygulayın. Belge özgünlüğü için dijital imzalar ekleyin veya hassas belgeler için şifre koruması uygulayın.