CSHTML'yi C#'ta PDF'e Nasıl Dönüştürülür

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

PDF dönüştürücü, basılabilir herhangi bir belge veya web sayfasını PDF belgesine dönüştüren bir araçtır. HTML, Word, Excel veya diğer herhangi bir bası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 çeşitli formlarda bulunur.

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ü, sunum mantığını iş mantığından ayırarak geliştiricilerin dinamik web sayfaları oluşturmasını kolaylaştırır.

Denetleyici Sınıfı

Bir denetleyici sınıfı, ASP.NET Core uygulamasında gelen HTTP isteklerini işleyen bir C# sınıfıdır. Belirli HTTP fiilleri (ör. GET, POST, PUT, DELETE) ile eşleşen yöntemler içerir ve bir HTTP yanıtı döndürür.

NuGet Paket Yöneticisi

NuGet Paket Yöneticisi, Visual Studio'da .NET projelerinde paketleri yönetmek için kullanılan bir araçtır. Geliştiricilerin projelerine paketler eklemelerini, güncellemelerini ve kaldırmaları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.

Bağımlılık Enjeksiyonu

Bağımlılık Enjeksiyonu, geliştiricilerin uygulama bileşenlerini, sınıflarına bağımlılıkları enjekte ederek ayırmasını sağlayan bir tasarım modelidir. Bağımlılıkları azaltarak ve kodu daha modüler hale getirerek uygulamaları test etmeyi ve bakımını kolaylaştırır.

Ö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 Yükle

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

Adım 2 Bir CSHTML Dosyası Oluştur

Sonra, PDF'ye dönüştürmek istediğiniz içeriği içeren bir CSHTML dosyası oluşturun. Bu örnekte, "Hello, World!" metnini görüntüleyen bir CSHTML öğreticisi 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ürme

CSHTML'yi PDF'ye dönüştürmek için, C#'ta IronPDF kütüphanesini kullanacağız. "Hello.cshtml"'yi 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, IronPDF ad alanı da dahil olmak üzere gerekli ad alanlarını yükleriz, bu da HTML'den PDF'ye dönüştürme işlevselliğini içerir.
• Ardından, Index yöntemi tanımlarız, bu yöntem yalnızca öğeler listesini bir Razor görünümüne döndürür.
• PDF belgesini oluşturmakla sorumlu olan DownloadPDF yöntemini tanımlarız.
• İlk olarak bir ChromePdfRenderer oluşturucusu oluşturuyoruz.
• Ardından RenderRazorViewToPdf genişletme metodunu kullanarak verilerle dolu bir Razor görünümünü PDF dosyasına dönüştürürüz.
• Daha sonra PDF'nin tarayıcıda görüntülenmek yerine indirilmeye zorlanması için Content-Disposition başlıklarını ayarlarız.
• Son olarak, PDF belgesini bir dosya olarak File yöntemiyle döndürürüz.

Bu, IronPDF ile C#'ta 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 vardır. Bu seçeneklerden bazılarına bakalım.

Uygulamayı Test Et

Gerekli olan tüm kodlar mevcut olduğunda, uygulamayı şimdi test edebiliriz. Bu adımları takip edin:

• Uygulamayı F5 tuşuna basarak veya Visual Studio'daki yeşil "Play" düğmesine tıklayarak çalıştırın.
• Web tarayıcınızda http://localhost:/Home/Index adresine gidin, port numarası Visual Studio tarafından atanmıştır.
• Öğelerin listesinin doğru bir şekilde görüntülendiğini doğrulayın.
• PDF belgesini oluşturmak ve indirmek için "PDF'yi İndir" bağlantısına tıklayın.

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

Adım 1 Yeni Bir Konsol Uygulaması Oluştur

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

Adım 2 IronPDF NuGet Paketini Yükle

Sonra, 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öneticisi'nde "IronPDF" araması yapın ve arama sonuçlarından "IronPDF" paketini seçin. Paket 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 örnekte, bir 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.

PDF dosyasını projeye eklemek için, Çözüm Gezgini'nde projenin üzerine sağ tıklayın ve bağlam menüsünden "Varolan Öğeyi Ekle"yi seçin.

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

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

Gerekli dosyalar yerleştirildikten sonra, PDF'yi IronPDF kullanarak bir CSHTML dosyasına dönüştürmek için kodu yazabiliriz. Konsol Uygulamanızın Main yöntemine 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