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, Razor Görünümlerini web bağlamı veya tarayıcı penceresi olmadan HTML'ye dönüştüren gerçek bir başsız işleme sağlar. Bu, arka plan hizmetleri, konsol uygulamaları veya UI'siz ortamlar için uygundur. IronPdf.Extensions.Razor işlev görmek 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 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" />

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:

:path=/static-assets/pdf/content-code-examples/how-to/cshtml-to-pdf-razor-headlessly-6.cs

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

Try
    Dim html = Await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml")
    Dim renderer As 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

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.

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

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çinde 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.