Blazor Sunucusunda Razor'u PDF'ye Dönüştürme C# İle

Hangi Model Sınıfı Yapısını Kullanmalıyım?

KişiBilgisi adlı standart bir C# sınıfı ekleyin. Bu sınıf, kişi bilgilerini depolamak için model olarak görev yapar. Aşağıdaki kodu ekleyin:

:path=/static-assets/pdf/content-code-examples/how-to/razor-to-pdf-blazor-server-model.cs

namespace BlazorSample.Data
{
    public class PersonInfo
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
    }
}

Namespace BlazorSample.Data
	Public Class PersonInfo
		Public Property Id() As Integer
		Public Property Name() As String
		Public Property Title() As String
		Public Property Description() As String
	End Class
End Namespace

Bu model, Razor bileşeninize aktarılan ve PDF'de render edilen veri yapısını temsil eder. IronPDF, basit POCO'lardan karmaşık entity framework modellerine kadar herhangi bir C# nesne modeli ile çalışır. PDF üretimi için modelleri tasarlarken, verilerin nihai belgede nasıl görüntüleneceğini düşünün ve özellikleri buna göre yapılandırın.

PDF Üretimi İçin Razor Bileşenini Nasıl Uygularım?

Razor bileşenlerini PDF'lere dönüştürmek için RenderRazorComponentToPdf yöntemini kullanın. Bu yönteme, ChromePdfRenderer sınıfını örnekleyerek erişin. Yöntem, dışa aktarma veya daha fazla değiştirme için PdfDocument nesnesi döndürür.

Döndürülen PdfDocument, PDF/A veya PDF/UA formatlarına dönüştürme dahil ek modifikasyonları destekler. Belgeyi birleştirebilir veya bölebilir, sayfaları döndürebilir ve açıklamalar veya yer imleri ekleyebilirsiniz. Gerektiğinde özel filigranlar uygulayın.

Person.razor adlı bir Razor bileşeni ekleyin. Aşağıdaki kodu girin:

@page "/Person"
@using BlazorSample.Data;
@using IronPdf;
@using IronPdf.Extensions.Blazor;

<h3>Person</h3>

@code {
    // A parameter to receive a list of persons from the parent component.
    [Parameter]
    public IEnumerable<PersonInfo> persons { get; set; }

    // Dictionary to hold parameters that will be passed to the PDF renderer.
    public Dictionary<string, object> Parameters { get; set; } = new Dictionary<string, object>();

    protected override async Task OnInitializedAsync()
    {
        // Initialize the persons list with some sample data.
        persons = new List<PersonInfo>
        {
            new PersonInfo { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
            new PersonInfo { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
            new PersonInfo { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
        };
    }

    private async void PrintToPdf()
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Apply text footer to the PDF pages.
        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            LeftText = "{date} - {time}",
            DrawDividerLine = true,
            RightText = "Page {page} of {total-pages}",
            Font = IronSoftware.Drawing.FontTypes.Arial,
            FontSize = 11
        };

        Parameters.Add("persons", persons);

        // Render Razor component to PDF and save it.
        PdfDocument pdf = renderer.RenderRazorComponentToPdf<Person>(Parameters);
        File.WriteAllBytes("razorComponentToPdf.pdf", pdf.BinaryData);
    }
}

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    @foreach (var person in persons)
    {
        <tr>
            <td>@person.Name</td>
            <td>@person.Title</td>
            <td>@person.Description</td>
        </tr>
    }
</table>

<button class="btn btn-primary" @onclick="PrintToPdf">Print to Pdf</button>

Bu yöntem, tüm RenderingOptions özelliklerine erişim sağlar. Metin ve HTML başlıkları ve altbilgileri ekleyin, sayfa numaraları dahil edin ve sayfa boyutlarını ve düzenini ayarlayın. RenderingOptions, özel kenar boşlukları, duyarlı tasarımlar için görünüm ayarları ve dinamik içerikler için JavaScript yürütme gecikmelerini destekler.

Farklı sayfa boyutları arasında PDF'lerin düzgün görünmesini sağlamak için Bootstrap gibi karmaşık düzenler veya CSS çerçevelerini keşfedin. duyarlı CSS render yeteneklerini inceleyin.

Razor Bileşenime Navigasyonu Nasıl Eklerim?

• "Paylaşılan klasör"e gidin ve NavMenu.razor'i açın. Razor bileşenimizi açacak bölümü ekleyin, Person. Bizim Person bileşenimiz ikinci seçenek olacaktır.

<div class="@NavMenuCssClass" @onclick="ToggleNavMenu">
    <nav class="flex-column">
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="" Match="NavLinkMatch.All">
                <span class="oi oi-home" aria-hidden="true"></span> Home
            </NavLink>
        </div>
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="Person">
                <span class="oi oi-list-rich" aria-hidden="true"></span> Person
            </NavLink>
        </div>
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="counter">
                <span class="oi oi-plus" aria-hidden="true"></span> Counter
            </NavLink>
        </div>
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="fetchdata">
                <span class="oi oi-list-rich" aria-hidden="true"></span> Fetch data
            </NavLink>
        </div>
    </nav>
</div>

Bu gezinme kurulumu, Blazor'un yönlendirme sistemi ile entegre olur ve kullanıcıların uygulamanızın ana gezinme menüsünden PDF üretim fonksiyonelliğine erişmesine olanak tanır. NavLink bileşeni, aktif yolun doğru vurgulanmasını sağlar.

PDF Üretim Süreci Nasıl Görünür?

Projeyi çalıştırın ve bir PDF belgesi oluşturun. "PDF'ye Yazdır" düğmesine tıklayın. IronPDF, Razor bileşeninizi işler, HTML'ye dönüştürür ve Chrome tabanlı render motorunu kullanarak bir PDF olarak işler. Bu, modern web tarayıcılarında görüldüğü gibi aynı görsel sadakati korur.

Oluşturulan PDF, projenizin çıktı dizininde kaydedilir. Kaydetme konumunu özelleştirin, doğrudan tarayıcı indirimi uygulayın veya PDF'leri Azure Blob Storage gibi bulut depolama alanlarında saklayın. Üretim uygulamaları için, PDF üretiminin başarısız olabileceği veya beklenenden fazla süre alabileceği senaryolar için hata ayıklama ve kullanıcı geri bildirimi uygulayın.