Jak przekonwertować CSHTML na PDF w C#

Konwerter plików PDF

Konwerter PDF to narzędzie, które konwertuje dowolny dokument do druku lub stronę internetową na dokument PDF. Może być używane do generowania plików PDF z HTML, Word, Excel lub innych dokumentów do druku. Konwertery PDF dostępne są w różnych formach, w tym narzędzia online, oprogramowanie desktopowe i biblioteki.

Widok Razor

Widok Razor to mechanizm szablonów używany w ASP.NET Core do dynamicznego generowania stron HTML. Jest to składnia znaczników, która łączy znaczniki HTML z kodem C#.

Widok Razor

Widok Razor ułatwia programistom tworzenie dynamicznych stron internetowych przez oddzielenie logiki prezentacyjnej od logiki biznesowej.

Klasa kontrolera

Klasa kontrolera to klasa C# obsługująca przychodzące żądania HTTP w aplikacji ASP.NET Core. Zawiera metody, które odpowiadają określonym czasownikom HTTP (np. GET, POST, PUT, DELETE) i zwraca odpowiedź HTTP.

Menedżer Pakietów NuGet

Menedżer Pakietów NuGet to narzędzie używane w Visual Studio do zarządzania pakietami w projektach .NET. Ułatwia programistom instalowanie, aktualizowanie i odinstalowywanie pakietów w swoich projektach. Pakiety NuGet to biblioteki zawierające kod wielokrotnego użytku i dystrybuowane za pośrednictwem Menedżera Pakietów NuGet.

Wstrzykiwanie zależności

Dependency Injection to wzorzec projektowy, który pozwala programistom rozdzielać komponenty aplikacji, wstrzykując zależności do swoich klas. Ułatwia testowanie i utrzymanie aplikacji przez redukcję zależności i uczynienie kodu bardziej modularnym.

Teraz, gdy omówiliśmy ważne pojęcia, przejdźmy do procesu konwersji CSHTML na PDF za pomocą IronPDF.

Krok 1 Instalacja IronPDF

Pierwszym krokiem jest zainstalowanie IronPDF z Menedżera Pakietów NuGet w twoim projekcie C#. Możesz zainstalować IronPDF, pobierając plik IronPDF.dll i dodając go do odniesień w projekcie. Aby zainstalować IronPDF przy użyciu Menedżera Pakietów NuGet, otwórz konsolę Menedżera Pakietów i uruchom następujące polecenie:

Krok 2 Tworzenie pliku CSHTML

Następnie utwórz plik CSHTML, zawierający treść, którą chcesz przekonwertować na PDF. W tym przykładzie stworzymy prosty samouczek CSHTML, który wyświetla tekst "Hello, World!".

@{
    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!

Zapisz ten plik jako "Hello.cshtml" w katalogu projektowym.

Pliki PDF w C#

Krok 3 Konwersja CSHTML na dokument PDF

Aby przekonwertować plik CSHTML na PDF, będziemy korzystać z biblioteki IronPDF w C#. Oto kod do konwersji "Hello.cshtml" na 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");
        }
    }
}

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

Przeanalizujmy ten kod krok po kroku:

• Najpierw importujemy niezbędne przestrzenie nazw, w tym przestrzeń nazw IronPDF, która zawiera funkcjonalność konwersji HTML na PDF.
• Następnie definiujemy metodę Index, która po prostu zwraca listę elementów do widoku Razor.
• Definiujemy metodę DownloadPDF, odpowiedziąlną za generowanie dokumentu PDF.
• Zaczynamy od stworzenia renderera ChromePdfRenderer.
• Następnie używamy metody rozszerzenia RenderRazorViewToPdf, aby wygenerować widok Razor z danymi do pliku PDF.
• Ustawiamy nagłówki Content-Disposition, aby wymusić pobieranie PDF zamiast wyświetlania ich w przeglądarce.
• Na końcu, zwracamy dokument PDF jako plik, używając metody File.

To jest podstawowy kod do konwersji CSHTML na PDF przy użyciu IronPDF w C#. Jednakże, istnieje wiele opcji i ustawień, które można wykorzystać do spersonalizowania wyjścia PDF. Przyjrzyjmy się niektórym z tych opcji.

Testowanie aplikacji

Po umieszczeniu całego niezbędnego kodu możemy teraz przetestować aplikację. Postępuj zgodnie z poniższymi wskazówkami:

• Uruchom aplikację, naciskając F5 lub klikając zielony przycisk "Play" w Visual Studio.
• W przeglądarce internetowej przejdź do http://localhost:/Home/Index, gdzie znajduje się numer portu przypisany przez Visual Studio.
• Zweryfikuj, czy lista elementów jest wyświetlana poprawnie.
• Kliknij link "Pobierz PDF", aby wygenerować i pobrać dokument PDF.

Jeśli wszystko działa poprawnie, powinieneś zobaczyć dokument PDF zawierający listę elementów, które wcześniej zdefiniowałeś.

Krok 1 Utwórz nową aplikację konsolową

Otwórz Visual Studio i utwórz nową aplikację konsolową, wybierając "Plik > Nowy > Projekt" z menu, a następnie wybierając "Konsola (.NET Framework)" lub "Konsola (.NET Core)" z listy szablonów projektów.

Krok 2 Instalacja pakietu NuGet IronPDF

Następnie musimy zainstalować pakiet NuGet IronPDF w naszej aplikacji konsolowej. Aby to zrobić, kliknij prawym przyciskiem na projekt w Eksploratorze rozwiązań i wybierz "Zarządzaj pakietami NuGet" z menu kontekstowego.

W Menedżerze Pakietów NuGet wyszukaj "IronPDF" i wybierz pakiet "IronPDF" z wyników wyszukiwania. Kliknij przycisk "Instaluj", aby zainstalować pakiet i jego zależności.

Krok 3 Dodaj pliki PDF i CSHTML do projektu

Dla tego przykładu użyjemy przykładowego pliku PDF, który chcemy przekonwertować na plik CSHTML. Możesz użyć dowolnego pliku PDF dla tego kroku.

Dodaj plik PDF do projektu, klikając prawym przyciskiem na projekt w Eksploratorze rozwiązań i wybierając "Dodaj > Istniejący element" z menu kontekstowego.

Musimy również stworzyć pusty plik CSHTML, którego użyjemy do przechowywania konwertowanego łańcucha HTML. Aby to zrobić, kliknij prawym przyciskiem na projekt w Eksploratorze rozwiązań i wybierz "Dodaj > Nowy element" z menu kontekstowego. Wybierz "Strona HTML" z listy szablonów, nadaj nazwę plikówi (np. "converted.cshtml") i kliknij "Dodaj".

Krok 4 Konwersja pliku PDF do formatu CSHTML

Mając już niezbędne pliki, możemy teraz napisać kod do konwersji pliku PDF na plik CSHTML przy użyciu IronPDF. Dodaj następujący kod do metody Main swojej aplikacji konsolowej:

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