Jak przekonwertować strony Razor do PDF w aplikacji ASP.NET Core C

Wprowadzenie

Strony Razor zapewniają potężny i intuicyjny sposob na budowanie dynamicznych treści webowych w aplikacjach ASP.NET Core. Połączone z możliwosciami renderowania IronPDF, deweloperzy mogą tworzyć profesjonalne dokumenty PDF bezpośrednio z ich treści webowych. To podejście usuwa skomplikowana logike generowania PDF i pozwala na wykorzystanie juz znanych umiejetnosci HTML i CSS.

Integracja miedzy IronPDF a stronami Razor jest szczegółnie cenna przy generowaniu raportow, faktur, certyfikatow i innych dokumentów wymagajacych dynamicznej prezentacji danych. Używając tej samej skladni Razor, z która jestes juz zaznajomiony, możesz utrzymac spojnosc miedzy widokami webowymi a wyjsciami PDF.

Jakie paczki NuGet sa potrzebne do konwersji Razor do PDF?

Pakiet IronPdf.Extensions.Razor jest rozszerzeniem głównego pakietu IronPdf. Oba pakiety IronPdf.Extensions.Razor i IronPdf są potrzebne do renderowania stron Razor w dokumenty PDF w aplikacji sieciowej ASP.NET Core. Szczegółowe instrukcje dotyczące instalacji można znaleźć w naszym przewodniku instalacyjnym.

# Command to install IronPdf.Extensions.Razor package using NuGet Package Manager
Install-Package IronPdf.Extensions.Razor

# Command to install IronPdf.Extensions.Razor package using NuGet Package Manager
Install-Package IronPdf.Extensions.Razor

Zainstaluj za pomocą NuGet

Install-Package IronPdf.Extensions.Razor

nuget.org/packages/IronPDF.Extensions.Razor/

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak przekonwertować strony Razor do PDF w ASP.NET Core?

Będziesz potrzebowal projektu ASP.NET Core Web App, aby przekonwertować strony Razor na pliki PDF. Proces obejmuje stworzenie modelu dla Twoich danych, skonfigurowanie strony Razor do wyświetlania tych danych oraz użycie metody RenderRazorToPdf IronPDF do generowania PDF.

:path=/static-assets/pdf/content-code-examples/how-to/cshtml-to-pdf-razor-model.cs

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; }
    }
}

Namespace RazorPageSample.Models
	Public Class Person
		Public Property Id() As Integer
		Public Property Name() As String
		Public Property Title() As String
		Public Property Description() As String
	End Class
End Namespace

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

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

Renderuj strony Razor do PDF

Następnie, kod poniżej najpierw tworzy instancje klasy ChromePdfRenderer. Przekazywanie this do metody RenderRazorToPdf wystarczy, aby przekształcić tę stronę Razor w dokument PDF.

Masz pełny dostep do funkcji dostępnych w RenderingOptions. Funkcje te obejmuja możliwosc zastosowania numeracji stron w generowanym dokumencie PDF, ustawianie niestandardowych marginesow, oraz dodawanie niestandardowego tekstu oraz nagłówków i stopki HTML. Można również skonfigurować metadane dla swoich PDF, aby zapewnic wlasciwa identyfikacje dokumentu i możliwosc wyszukiwania.

• Otwórz rozwijane menu dla pliku Persons.cshtml, aby zobaczyć plik Persons.cshtml.cs.
• Zmodyfikuj Persons.cshtml.cs przy użyciu poniższego kodu.

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");
        }
    }
}

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");
        }
    }
}

Imports IronPdf.Razor
Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Mvc.RazorPages
Imports RazorPageSample.Models

Namespace RazorPageSample.Pages
	Public Class PersonsModel
		Inherits PageModel

		<BindProperty(SupportsGet := True)>
		Public Property Persons() As List(Of Person)

		' Handle GET request to load initial data
		Public Sub OnGet()
			Persons = New List(Of Person) From {
				New Person With {
					.Name = "Alice",
					.Title = "Mrs.",
					.Description = "Software Engineer"
				},
				New Person With {
					.Name = "Bob",
					.Title = "Mr.",
					.Description = "Software Engineer"
				},
				New Person With {
					.Name = "Charlie",
					.Title = "Mr.",
					.Description = "Software Engineer"
				}
			}

			ViewData("personList") = Persons
		End Sub

		' Handle POST request to convert Razor page to PDF
		Public Function OnPost() As IActionResult
			Persons = New List(Of Person) From {
				New Person With {
					.Name = "Alice",
					.Title = "Mrs.",
					.Description = "Software Engineer"
				},
				New Person With {
					.Name = "Bob",
					.Title = "Mr.",
					.Description = "Software Engineer"
				},
				New Person With {
					.Name = "Charlie",
					.Title = "Mr.",
					.Description = "Software Engineer"
				}
			}

			ViewData("personList") = Persons

			Dim renderer As New ChromePdfRenderer()

			' Render Razor Page to PDF document
			Dim pdf As PdfDocument = renderer.RenderRazorToPdf(Me)

			' 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");
		End Function
	End Class
End Namespace

Metoda RenderRazorToPdf zwraca obiekt PdfDocument, który może zostać poddany dalszemu przetwarzaniu i edytowaniu. Możesz eksportować PDF jako PDFA lub PDFUA, zastosować cyfrowy podpis do wygenerowanego dokumentu PDF lub łączyć i dzielić dokumenty PDF. Metoda umożliwia równiez obracanie stron, dodawanie adnotacji lub zakladek, oraz dodawanie własnych znakow wodnych do twojego PDF.

W celu zwiekszonego zarządzania dokumentami można również kompresowac PDF w celu zmniejszenia rozmiaru pliku bez utraty jakosci. Jest to szczegółnie przydatne w przypadku pracy z duzymi raportami lub gdy przepustowosc jest ograniczeniem. Dodatkowo, rozbudowane możliwosci edycji, jakie zapewnia IronPDF, sa opisane w naszym obszernym kursie na temat edycji PDF.

<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>

<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>

Co sie dzieje, gdy uruchamiam generowanie PDF?

To pokazuje, jak uruchomić projekt i wygenerować dokument PDF. Gdy klikniesz łącze nawigacyjne "Person", zobaczysz dane wyświetlone w formacie tabeli. Klikniecie przycisku "Print" uruchamia proces generowania PDF, konwertując obecny widok strony Razor do pobieranego dokumentu PDF.

Wygenerowany PDF zachowuje całe stylizacje i formatowanie z twojej strony Razor, zapewniając spojny wyglad miedzy widokiem webowym a wyjsciem PDF. To podejście jest szczegółnie przydatne przy generowaniu raportow, faktur, lub jakiegokolwiek dokumentu, ktory wymaga danych z bazy danych czy logiki biznesowej aplikacji.

Gdzie mogę pobrac kompletny przykład aplikacji ASP.NET Core Web App?

Możesz pobrac kompletny kod tego przewodnika jako spakowany plik, ktory możesz otworzyć w Visual Studio jako projekt ASP.NET Core Web App.

Pobierz projekt aplikacji ASP.NET Core Web App RazorPageSample.zip