IRONSOFTWAREHOME

ASP.NET Core C# Uygulamasında Razor Sayfalarını PDF'lere Dönüştürme

Curtis Chau
Curtis Chau
Updated: 24 Nisan 2026

IronPDF, Razor Pages (.cshtml dosyaları) dosyalarının ASP.NET Core uygulamalarında PDF belgelerine sorunsuz bir şekilde dönüştürülmesini RenderRazorToPdf yöntemiyle sağlayarak, C# ve HTML renderinge tam destekle web içeriğinden PDF oluşturmayı kolaylaştırır.

Bir Razor Sayfası, web içeriği oluşturmak için C# ve HTML kombinasyonu ile bir .cshtml uzantılı olan bir dosyadır. ASP.NET Core'da, Razor Sayfaları web uygulamaları için kod organize etmenin daha basit bir yoludur, okunabilir veya basit veri girişi yapar.

Bir ASP.NET Core Web Uygulaması, modern web uygulamaları geliştirmek için platformlar arası bir framework olan ASP.NET Core kullanılarak oluşturulan bir web uygulamasıdır.

IronPDF, bir ASP.NET Core Web Uygulama projesi içinde Razor Sayfalarından PDF dosyaları oluşturma işlemini basitleştirir. Bu, ASP.NET Core Web Uygulamalarında PDF oluşturmayı kolaylaştırır.

Hızlı Başlangıç: Razor Sayfalarını Saniyeler İçinde PDF'ye Dönüştürme

Razor Sayfalarınızı, ASP.NET Core uygulamasında yüksek kaliteli PDF'lere dönüştürün. RenderRazorToPdf yöntemini kullanarak, CSHTML dosyalarını PDF belgelerine dönüştürebilir, iş akışınızı optimize edebilir ve belge dağıtımınızı geliştirebilirsiniz. Bu kılavuz, bunu dakikalar içinde başarmak için gerekli basit adımları adım adım açıklıyor.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Bu kod parçacığını kopyalayın ve çalıştırın.

    // Install-Package IronPdf.Extensions.Razor
    var pdf = new IronPdf.ChromePdfRenderer().RenderRazorToPdf("Views/Home/Index.cshtml");
    C#
  3. 3Canlı ortamınızda test için dağıtım yapın

    Ücretsiz deneme ile bugün projenizde IronPDF kullanmaya başlayın
    arrow pointer

Giriş

Razor Sayfaları, ASP.NET Core uygulamalarında dinamik web içeriği oluşturmak için güçlü ve sezgisel bir yol sağlar. IronPDF'nin render yetenekleri ile birleştirildiğinde, geliştiriciler web içeriklerinden doğrudan profesyonel PDF belgeleri oluşturabilir. Bu yaklaşım karmaşık PDF oluşturma mantığını ortadan kaldırır ve mevcut HTML ve CSS yeteneklerinizi kullanmanıza olanak tanır.

IronPDF ile Razor Sayfaları arasındaki entegrasyon, raporlar, faturalar, sertifikalar ve dinamik veri sunumu gerektiren diğer belgeler üretmek için özellikle değerlidir. Halihazırda aşina olduğunuz Razor sözdizimini kullanarak, artırılmış tutarlılık sağlarken web görünümleriniz ve PDF çıktılarınız arasında tutarlılığı koruyabilirsiniz.

Razor'dan PDF'ye Dönüştürme İçin Hangi NuGet Paketlerine İhtiyacım Var?

IronPdf.Extensions.Razor paketi, ana IronPdf paketinin bir uzantısıdır. Razor Pages dosyalarını PDF belgelerine render etmek için hem IronPdf.Extensions.Razor hem de IronPdf paketlerine ASP.NET Core Web App içinde ihtiyaç vardır. Ayrıntılı kurulum talimatları için kurulum genel bakış kılavuzumuzu ziyaret edin.

# Command to install IronPdf.Extensions.Razor package using NuGet Package Manager
Install-Package IronPdf.Extensions.Razor
SHELL
PDF için C# NuGet Kütüphanesi

NuGet ile yükleyin

Install-Package IronPdf.Extensions.Razor

ASP.NET Core'da Razor Sayfalarını PDF'ye Nasıl Dönüştürürüm?

Razor Sayfalarını PDF dosyalarına dönüştürmek için bir ASP.NET Core Web Uygulaması projesi gerekecek. İşlem, verileriniz için bir model oluşturarak, bu veriyi göstermek için bir Razor Sayfası ayarlayarak ve ardından IronPDF'nin RenderRazorToPdf yöntemi ile PDF çıktısını üretmeyi içerir.

Neden PDF Oluşturma İçin Bir Model Sınıfına İhtiyacım Var?

Model sınıfları, Razor Sayfalarınızda veri sunumunun omurgası olarak hizmet eder. Denetleyici mantığınızdan görünümünüze veri geçişinin yapılandırılmış bir yolunu sağlar, tür güvenliğini ve sürdürülebilirliği sağlar. PDF oluştururken, bu modeller daha da önemli hale gelir çünkü son belgenizde görünecek verilerin tam yapısını tanımlarlar.

  • Projeye yeni bir klasör oluştur ve "Models" adını ver.
  • Klasöre standart bir C# sınıfı ekleyin ve adını Person yapın. Bu sınıf, bireysel veri için bir model görevi görecektir. Aşağıdaki kod parçasını kullanın:
namespace RazorPageSample.Models
{
    public class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
    }
}

PDF Dönüşümü İçin Bir Razor Sayfası Nasıl Ayarlarım?

"Pages" klasörüne boş bir Razor Sayfası ekleyin ve adını persons.cshtml yapın.

  • Aşağıda verilen kod örneğini kullanarak yeni oluşturulan Persons.cshtml dosyasını düzenleyin.

Aşağıdaki kod bilgiyi tarayıcıda görüntüler. Razor sözdiziminin, C# kodunu HTML içinde sorunsuz bir şekilde entegrasyon yapmasına nasıl izin verdiğine dikkat edin, bu da dönüştürülebilecek dinamik içerik oluşturmak için mükemmel hale getirir:

@page
@using RazorPageSample.Models;
@model RazorPageSample.Pages.PersonsModel
@{
}

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    @foreach (var person in ViewData["personList"] as List<Person>)
    {
        <tr>
            <td>@person.Name</td>
            <td>@person.Title</td>
            <td>@person.Description</td>
        </tr>
    }
</table>

<form method="post">
    <button type="submit">Print</button>
</form>
HTML

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

Razor Sayfalarını PDF'lere Dönüştürme

Ardından, aşağıdaki kod önce ChromePdfRenderer sınıfını başlatır. this'i RenderRazorToPdf yöntemine geçirmek, bu Razor Sayfasını bir PDF belgesine dönüştürmek için yeterlidir.

RenderingOptions'ta mevcut olan özelliklere tam erişiminiz var. Bu özellikler, oluşturulan PDF'ye sayfa numaraları uygulama, özel kenar boşlukları ayarlama ve özel metin ve HTML başlıklarını ve alt bilgilerini ekleme yeteneğini içerir. PDF'lerinizin doğru bir şekilde tanımlandığından ve aranabilirliğin sağlandığından emin olmak için meta veriler yapılandırabilirsiniz.

  • Persons.cshtml.cs dosyasını görmek için Persons.cshtml dosyasının açılır menüsünü açın.
  • Aşağıdaki kod ile Persons.cshtml.cs dosyasını değiştirin.
using IronPdf.Razor;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using RazorPageSample.Models;

namespace RazorPageSample.Pages
{
    public class PersonsModel : PageModel
    {
        [BindProperty(SupportsGet = true)]
        public List<Person> Persons { get; set; }
        
        // Handle GET request to load initial data
        public void OnGet()
        {
            Persons = new List<Person>
            {
                new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
                new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
                new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
            };

            ViewData["personList"] = Persons;
        }

        // Handle POST request to convert Razor page to PDF
        public IActionResult OnPost()
        {
            Persons = new List<Person>
            {
                new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
                new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
                new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
            };

            ViewData["personList"] = Persons;

            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render Razor Page to PDF document
            PdfDocument pdf = renderer.RenderRazorToPdf(this);

            // Return the generated PDF file with appropriate content headers
            Response.Headers.Add("Content-Disposition", "inline");
            return File(pdf.BinaryData, "application/pdf", "razorPageToPdf.pdf");

            // Optionally view the output PDF in browser (uncomment below line if needed)
            // return File(pdf.BinaryData, "application/pdf");
        }
    }
}

RenderRazorToPdf yöntemi, ek işlem ve düzenleme yapabilecek bir PdfDocument nesnesi döndürür. PDF belgesini PDFA veya PDFUA olarak dışa aktarabilir, render edilen PDF belgesine dijital imza uygulayabilir veya PDF belgelerini birleştirebilir ve bölebilirsiniz. Yöntem ayrıca sayfaları döndürme, açıklamalar veya yer imleri ekleme ve PDF'nize özel filigranlar damgalamanıza olanak tanır.

Gelişmiş belge yönetimi için, dosya kalitesinden ödün vermeden dosya boyutunu azaltmak amacıyla PDF'leri sıkıştırabilirsiniz. Bu, özellikle büyük raporlarla uğraşırken veya bant genişliği bir endişe olduğunda kullanışlıdır. Ayrıca, IronPDF tarafından sunulan kapsamlı düzenleme yetenekleri, kapsamlı PDF düzenleme kılavuzumuzda belgelenmiştir.

PDF Oluşturma Sayfası İçin Nasıl Gezinme Eklenir?

Gezinme, ASP.NET Core uygulamanızda kullanıcı deneyimi için çok önemlidir. Ana gezinmenize PDF oluşturma sayfasını entegre ederek kullanıcılar, URL'leri elle girmeden bu işlevselliğe kolayca erişebilir.

  • Pages klasörüne gidin -> Shared klasörü -> _Layout.cshtml. "Person" gezinme öğesini "Home"'dan sonra yerleştirin.

asp-page özelliğinin değeri, bizim dosya adımızla tam olarak eşleştiğinden emin olun, bu durumda dosya adı Persons. Bu, ASP.NET Core uygulamanızda doğru yönlendirilmeyi sağlar:

<header>
    <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
        <div class="container">
            <a class="navbar-brand" asp-area="" asp-page="/Index">RazorPageSample</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
                    aria-expanded="false" aria-label="Toggle navigation">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
                <ul class="navbar-nav flex-grow-1">
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Index">Home</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Persons">Person</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Privacy">Privacy</a>
                    </li>
                </ul>
            </div>
        </div>
    </nav>
</header>
HTML

PDF Oluşturma Çalıştırdığımda Ne Olur?

Bu, projeyi nasıl çalıştıracağınızı ve bir PDF belgesi oluşturacağınızı gösterir. "Person" gezinme bağlantısına tıkladığınızda, verileri tablo formatında göreceksiniz. "Yazdır" düğmesine tıklamak, PDF oluşturma sürecini tetikler ve mevcut Razor Sayfa görünümünü indirilebilir bir PDF belgesine dönüştürür.

IronPDF kullanarak PDF oluşturma için OnGet ve OnPostAsync metotlarına sahip C# PersonsModel sınıfını gösteren Visual Studio

Oluşturulan PDF, Razor Sayfanızdaki tüm stil ve biçimlendirmeleri koruyarak web görünümünüz ve PDF çıktınız arasında tutarlı bir görünüm sağlar. Bu yaklaşım, uygulamanızın veritabanı veya iş mantığından alınan verileri gerektiren raporlar, faturalar veya diğer belgeler oluşturmak için özellikle kullanışlıdır.

Tamamlanmış Bir ASP.NET Core Web Uygulaması Örneğini Nereden İndirebilirim?

Bu kılavuzun tam kodunu zipli dosya olarak indirip, Visual Studio'da bir ASP.NET Core Web Uygulaması projesi olarak açabilirsiniz.

RazorPageSample.zip ASP.NET Core Web Uygulaması Projesini İndirin

Sıkça Sorulan Sorular

ASP.NET Core'da Razor Sayfalarını PDF'e nasıl dönüştürebilirim?

IronPDF'in RenderRazorToPdf metodunu kullanarak ASP.NET Core'da Razor Sayfalarını PDF'e dönüştürebilirsiniz. Basitçe, IronPdf.Extensions.Razor paketini yükleyin ve .cshtml dosyalarınızı doğrudan PDF belgelerine dönüştürmek için ChromePdfRenderer'ı kullanın.

Razor'dan PDF'e dönüşüm için hangi NuGet paketlerine ihtiyaç duyuluyor?

İki NuGet paketine ihtiyacınız var: IronPdf.Extensions.Razor (genişletme paketi) ve IronPdf (ana paket). Her iki paket de ASP.NET Core Web Uygulamalarında Razor Sayfalarını PDF belgelerine dönüştürmek için gereklidir.

Razor Sayfalarımı PDF'e dönüştürürken dinamik veri kullanabilir miyim?

Evet, IronPDF, Razor Sayfalarındaki dinamik verileri tam olarak destekler. C# kodu, model bağlama ve tüm standart Razor sözdizimi özelliklerini PDF'e dönüştürürken kullanabilirsiniz, bu da dinamik içerikle raporlar, faturalar ve sertifikalar üretmek için idealdir.

Razor Sayfalarından hangi tür belgeler üretebilirim?

IronPDF'in Razor'dan PDF'e dönüşümü, raporlar, faturalar, sertifikalar, makbuzlar ve dinamik veri sunumu gerektiren diğer belgeler gibi çeşitli belge türlerini üretmek için mükemmeldir, mevcut HTML ve CSS stilinizi koruyarak.

Projemde Razor'dan PDF'e dönüşümü ne kadar hızlı uygulayabilirim?

IronPDF ile dakikalar içinde Razor'dan PDF'e dönüşüm uygulayabilirsiniz. Minimal iş akışı sadece 5 adım içerir: kütüphaneyi yüklemek, bir model sınıfı eklemek, bir Razor Sayfası oluşturmak, .cs dosyasını RenderRazorToPdf metodu kullanacak şekilde düzenlemek ve uygulamanızı çalıştırmak.

Dönüşüm, HTML ve CSS stilimi korur mu?

Evet, IronPDF, Razor Sayfalarını PDF'e dönüştürürken HTML ve CSS stilinizi korur. Bu, web görünümleriniz ve PDF çıktılarınız arasında tutarlılığı korumanıza ve zaten oluşturduğunuz stil ve yerleşimi kullanmanıza olanak tanır.

What features does IronPDF offer for PDF document management?

IronPDF provides features such as PDF compression, digital signature integration, merging and splitting documents, rotation, annotation, bookmarking, and watermark stamping, offering comprehensive PDF document management capabilities.

Where can I find a complete example of an ASP.NET Core Web App using IronPDF for PDF conversion?

You can download a complete example of an ASP.NET Core Web App demonstrating Razor Page to PDF conversion with IronPDF from the provided link in the guide, available as a zipped project file.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...
Daha Fazla Oku

Başlamaya Hazır mısınız?

Nuget Downloads 20,756,830Sürüm:2026.7yeni yayınlandı

ÜCRETSİZİNİZİ EDİNİN

30 günlük Deneme Anahtarınızı anında edinin.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmez
bullet_testÜretimde Test
filigran olmadan
bullet_calendar30 gün tamamen
işlevsel ürün
bullet_supportDeneme sırasında teknik
24/5 destek
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez
PDF için C# NuGet Kütüphanesi
NuGet ile yükleyin

Sürüm: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Çözüm Gezgini'nde Referanslar'a sağ tıklayın, NuGet Paketlerini Yönet
  2. Tarayıcıya tıklayın ve "IronPdf" arayın
  3. Paketi seçin ve yükleyin
C# PDF DLL
DLL İndir

Sürüm: 2026.7

veya Windows Yükleyiciyi şuradan buradan indirin.

  1. IronPDF'i, ~/Libs gibi bir yere, Solution dizininiz içinde indirin ve açın.
  2. Visual Studio Çözüm Gezgini'nde, Referanslar'a sağ tıklayın. Tarayıcı sekmesini seçin, "IronPdf.dll"

Lisanslar $999

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Ücretsiz Canlı Demo rezervasyonu yapın
Booking Badge

Dünya Çapında Milyonlarca Mühendisin Güvendiği

Iron Software müşteri logoları
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez