C# ile Blazor Server'da Razor'ı PDF'ye dönüştürme PdfDocument

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

PersonInfo adlı standart bir C# sınıfı ekleyin. Bu sınıf, kişi bilgilerini saklamak için model görevi görür. 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 iletilen ve PDF'de işlenen veri yapısını temsil eder. IronPDF, basit POCO'lardan karmaşık varlık çerçevesi modellerine kadar herhangi bir C# nesne modeli ile çalışır. PDF oluşturmada modeller tasarlarken, verinin nihai belgede nasıl görüneceğini düşünün ve özellikleri buna göre yapılandırın.

PDF Üretimi İçin Razor Bileşenini Nasıl Çalıştırırım?

Razor bileşenlerini PDF'lere dönüştürmek için RenderRazorComponentToPdf yöntemini kullanın. ` sınıfını örneklendirerek bu yönteme erişin. Yöntem, dışa aktarma veya daha fazla değişiklik için birPdfDocument` nesnesi döndürür.

Geri dönen PdfDocument, PDF/A veya PDF/UA formatlarına dönüştürme dahil olmak üzere ek değişiklikleri destekler. belgeyi birleştirebilir veya bölebilir, sayfaları döndürebilir ve açıklamalar veya yer işaretleri ekleyebilirsiniz. Gerek duyulduğunda ö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ını, duyarlı tasarımlar için görüntü alanı ayarlarını ve dinamik içerik için JavaScript yürütme gecikmelerini destekler.

Farklı sayfa boyutlarında PDF'lerin doğru görünmesini sağlamak için Bootstrap gibi karmaşık düzenler veya CSS çerçeveleri için responsive CSS işleme yeteneklerini keşfedin.

Razor Bileşenime Nasıl Navigasyon Eklerim?

• "Paylaşılan klasör"e gidin ve NavMenu.razor dosyasını açın. Razor bileşenimizi açacak bölümü ekleyin, Person. 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 navigasyon kurulumu, kullanıcıların PDF oluşturma işlevine uygulamanızın ana navigasyon menüsünden erişmesini sağlayacak şekilde Blazor'un yönlendirme sistemi ile entegre olur. NavLink bileşeni, etkin rotanın doğru şekilde 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 modern web tarayıcılarında aynı görsel sadakati koruyarak Chrome tabanlı işleme motorunu kullanarak PDF olarak sunar.

Oluşturulan PDF, projenizin çıkış dizinine kaydedilir. Kaydetme konumunu özelleştirin, doğrudan tarayıcı indirmeleri uygulayın veya Azure Blob Storage gibi bulut depolama alanlarında PDF'leri depolayın. Üretim uygulamaları için, PDF oluşturmada başarısız olabileceği veya beklenen süreyi aşabileceği senaryolar için hata ayıklama ve kullanıcı geri bildirimi uygulayın.