C#'da CSHTML'den PDF'ye Nasıl Dönüştürülür?

PDF Dönüştürücü

PDF dönüştürücü, her türlü yazılabilir belgeyi veya web sayfasını bir PDF belgesine dönüştüren bir araçtır. HTML, Word, Excel veya herhangi başka bir yazılabilir belgeden PDF dosyaları oluşturmak için kullanılabilir. PDF dönüştürücüler, çevrimiçi araçlar, masaüstü yazılımları ve kütüphaneler dahil olmak üzere çeşitli formlarda gelir.

Razor Görünümü

Razor görünümü, ASP.NET Core'da HTML sayfalarını dinamik olarak oluşturmak için kullanılan bir görünüm motorudur. HTML işaretlemesini C# kodu ile birleştiren bir işaretleme dilidir.

Razor Görünümü

Razor görünümü, geliştiricilerin sunum mantığını iş mantığından ayırarak dinamik web sayfaları oluşturmasını kolaylaştırır.

Denetleyici Sınıfı

Denetleyici sınıfı, bir ASP.NET Core uygulamasında gelen HTTP taleplerini işleyen bir C# sınıfıdır. Özgül HTTP fiillerine (ör., GET, POST, PUT, DELETE) karşılık gelen yöntemler içerir ve bir HTTP yanıtı döndürür.

NuGet Paket Yöneticisi

NuGet Paket Yöneticisi, .NET projelerinde paketleri yönetmek için Visual Studio'da kullanılan bir araçtır. Geliştiricilerin projelerindeki paketleri kurmasını, güncellemasını ve kaldırmasını kolaylaştırır. NuGet paketleri, yeniden kullanılabilir kod içeren ve NuGet Paket Yöneticisi aracılığıyla dağıtılan kütüphanelerdir.

Bagimli Enjeksiyon

Bağımlılık enjeksiyonu, geliştiricilerin sınıflarına bağımlılıkları enjekte ederek uygulama bileşenlerini birbirinden ayırmalarına izin veren bir tasarım desenidir. Kodun daha modüler olmasını sağlayarak bağımlılıkları azaltır ve uygulamaların test edilmesini ve bakımını kolaylaştırır.

Artık önemli kavramları ele aldığımıza göre, IronPDF kullanarak CSHTML'yi PDF'ye dönüştürme sürecine dalalım.

Adım 1 IronPDF'i Yükleyin

İlk adım, C# projenize NuGet Paket Yöneticisi üzerinden IronPDF'i yüklemektir. IronPDF'i indirip IronPDF.dll dosyasını yükleyerek ve proje referanslarınıza ekleyerek yükleyebilirsiniz. NuGet Paket Yöneticisi'ni kullanarak IronPDF'i yüklemek için, Paket Yöneticisi Konsolunu açın ve şu komutu çalıştırın:

Adım 2 Bir CSHTML Dosyası Oluşturun

Sonraki adımda, PDF'ye dönüştürmek istediğiniz içeriği içeren bir CSHTML dosyası oluşturun. Bu örnekte, "Merhaba, Dünya!" metnini görüntüleyen basit bir CSHTML eğitimi dosyası oluşturacağız.

@{
    Layout = null;
}
Hello
Hello, World!

@{
    Layout = null;
}
Hello
Hello, World!

@
If True Then
	Layout = Nothing
End If
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Hello Hello, World!

Bu dosyayı proje dizininize "Hello.cshtml" olarak kaydedin.

C#'ta PDF Dosyaları

Adım 3 CSHTML'yi PDF belgesine dönüştür

CSHTML dosyasını PDF'ye dönüştürmek için, IronPDF kutuphanesini C# içinde kullanacağız. "Hello.cshtml" dosyasını PDF'ye dönüştürmek için işte kod:

using System.IO;
using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace CSHTMLtoPDF.Controllers
{
    public class HomeController : Controller
    {
        private readonly IRazorViewRenderer _viewRenderService;
        public HomeController(IRazorViewRenderer viewRenderService)
        {
            _viewRenderService = viewRenderService;
        }

        public IActionResult Index()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };
            return View(items);
        }

        public IActionResult DownloadPDF()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };

            // Initialize a new instance of ChromePdfRenderer from IronPDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render the specified Razor view to a PDF document
            PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Index.cshtml", items);

            // Set the headers to force the browser to download the PDF
            var contentDisposition = new System.Net.Mime.ContentDisposition
            {
                FileName = "Items.pdf",
                Inline = false,
            };
            Response.Headers.Add("Content-Disposition", contentDisposition.ToString());

            // Return the PDF document to the client
            return File(pdf.BinaryData, "application/pdf");
        }
    }
}

using System.IO;
using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace CSHTMLtoPDF.Controllers
{
    public class HomeController : Controller
    {
        private readonly IRazorViewRenderer _viewRenderService;
        public HomeController(IRazorViewRenderer viewRenderService)
        {
            _viewRenderService = viewRenderService;
        }

        public IActionResult Index()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };
            return View(items);
        }

        public IActionResult DownloadPDF()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };

            // Initialize a new instance of ChromePdfRenderer from IronPDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render the specified Razor view to a PDF document
            PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Index.cshtml", items);

            // Set the headers to force the browser to download the PDF
            var contentDisposition = new System.Net.Mime.ContentDisposition
            {
                FileName = "Items.pdf",
                Inline = false,
            };
            Response.Headers.Add("Content-Disposition", contentDisposition.ToString());

            // Return the PDF document to the client
            return File(pdf.BinaryData, "application/pdf");
        }
    }
}

Imports System.IO
Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace CSHTMLtoPDF.Controllers
	Public Class HomeController
		Inherits Controller

		Private ReadOnly _viewRenderService As IRazorViewRenderer
		Public Sub New(ByVal viewRenderService As IRazorViewRenderer)
			_viewRenderService = viewRenderService
		End Sub

		Public Function Index() As IActionResult
			Dim items = { "Item 1", "Item 2", "Item 3" }
			Return View(items)
		End Function

		Public Function DownloadPDF() As IActionResult
			Dim items = { "Item 1", "Item 2", "Item 3" }

			' Initialize a new instance of ChromePdfRenderer from IronPDF
			Dim renderer As New ChromePdfRenderer()

			' Render the specified Razor view to a PDF document
			Dim pdf As PdfDocument = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Index.cshtml", items)

			' Set the headers to force the browser to download the PDF
			Dim contentDisposition = New System.Net.Mime.ContentDisposition With {
				.FileName = "Items.pdf",
				.Inline = False
			}
			Response.Headers.Add("Content-Disposition", contentDisposition.ToString())

			' Return the PDF document to the client
			Return File(pdf.BinaryData, "application/pdf")
		End Function
	End Class
End Namespace

Bu kodu adım adım inceleyelim:

• İlk olarak, HTML'yi PDF'ye dönüştürme işlevselliğini içeren IronPDF ad alanı dahil gerekli ad alanlarını ithal ediyoruz.
• Daha sonra bir listeyi Razor görünümüne döndüren Index yöntemini tanımlarız.
• PDF belgesini oluşturmaktan sorumlu DownloadPDF yöntemini tanımlarız.
• Bir ChromePdfRenderer oluşturucu oluşturarak başlarız.
• Sonra verilerle birlikte bir Razor görünümünü PDF dosyasına dönüştürmek için RenderRazorViewToPdf uzantı yöntemini kullanırız.
• Daha sonra PDF'in tarayıcıda görüntülenmek yerine indirilmesini zorlamak için Content-Disposition başlıklarını ayarlarız.
• Son olarak, PDF belgesini File metodu kullanarak bir dosya olarak iade ediyoruz.

Bu, C# içinde IronPDF ile CSHTML'yi PDF'ye dönüştürmek için temel koddur. Ancak, PDF çıktısını özelleştirmek için kullanabileceğiniz birçok seçenek ve ayar bulunmaktadır. Bu seçeneklerden bazılarına bir göz atalım.

Uygulamayı test et

Gerekli tüm kodlar yerindeyken artık uygulamayı test edebiliriz. Aşağıdaki adımları izleyin:

• Visual Studio'da F5 tuşuna basarak veya yeşil "Oynat" düğmesine tıklayarak uygulamayı çalıştırın.
• Web tarayıcınızda, Visual Studio tarafından atanan port numarası olan http://localhost:/Home/Index konumuna gidin.
• Öğelerin listesinin doğru görüntülendiğini doğrulayın.
• "PDF İndir" bağlantısına tıklayın ve PDF belgesini oluşturup indirin.

Her şey doğru çalışıyorsa, tanımladığınız öğe listesini içeren bir PDF belgesi görmelisiniz.

Adım 1 Yeni bir Konsol Uygulaması Oluşturun

Visual Studio'yu açın ve menüden "Dosya > Yeni > Proje"yi seçerek, ardından proje şablonları listesinden "Konsol Uygulaması (.NET Framework)" veya "Konsol Uygulaması (.NET Core)" seçerek yeni bir Konsol Uygulaması oluşturun.

Adım 2 IronPDF NuGet Paketini Yükleyin

Ardından, Konsol Uygulamamızda IronPDF NuGet paketini yüklememiz gerekiyor. Bunu yapmak için Çözüm Gezgini'nde projeye sağ tıklayın ve bağlam menüsünden "NuGet Paketlerini Yönet"i seçin.

NuGet Paket Yöneticisinde, "IronPDF" arayın ve arama sonuçlarından "IronPDF" paketini seçin. Paketi ve bağımlılıklarını yüklemek için "Yükle" düğmesine tıklayın.

Adım 3 Projeye PDF ve CSHTML Dosyaları Ekleyin

Bu örnek için, CSHTML dosyasına dönüştürmek istediğimiz örnek bir PDF dosyası kullanacağız. Bu adım için istediğiniz herhangi bir PDF dosyasını kullanabilirsiniz.

Çözüm Gezgini'nde projeye sağ tıklayıp bağlam menüsünden "Varolan Öğe Ekle"yi seçerek PDF dosyasını projeye ekleyin.

Ayrıca, dönüştürülmüş HTML dizgisini depolamak için kullanacağımız boş bir CSHTML dosyası oluşturmamız gerekecek. Bunu yapmak için Çözüm Gezgini'nde projeye sağ tıklayın ve bağlam menüsünden "Yeni Öğe Ekle"yi seçin. Şablonlar listesinden "HTML Sayfası"nı seçin, ardından dosyaya bir ad verin (örneğin, "converted.cshtml") ve "Ekle"ye tıklayın.

Adım 4 PDF'yi bir CSHTML Dosyasına Dönüştürün

Gerekli dosyalar yerinde olduğunda, artık PDF'yi IronPDF kullanarak bir CSHTML dosyasına dönüştürmek için kodu yazabiliriz. Konsol Uygulamanızın Ana metoduna aşağıdaki kodu ekleyin:

using IronPdf;

namespace PdfToHtml
{
    class Program
    {
        static void Main(string[] args)
        {
            // Load the PDF file
            PdfDocument pdf = PdfDocument.FromFile("sample.PDF");

            // Convert the PDF to an HTML string
            string html = pdf.ToHtml();

            // Save the HTML string to the CSHTML file
            System.IO.File.WriteAllText("converted.cshtml", html);
        }
    }
}

using IronPdf;

namespace PdfToHtml
{
    class Program
    {
        static void Main(string[] args)
        {
            // Load the PDF file
            PdfDocument pdf = PdfDocument.FromFile("sample.PDF");

            // Convert the PDF to an HTML string
            string html = pdf.ToHtml();

            // Save the HTML string to the CSHTML file
            System.IO.File.WriteAllText("converted.cshtml", html);
        }
    }
}

Imports IronPdf

Namespace PdfToHtml
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Load the PDF file
			Dim pdf As PdfDocument = PdfDocument.FromFile("sample.PDF")

			' Convert the PDF to an HTML string
			Dim html As String = pdf.ToHtml()

			' Save the HTML string to the CSHTML file
			System.IO.File.WriteAllText("converted.cshtml", html)
		End Sub
	End Class
End Namespace