Konvertieren von Razor Pages in PDFs in ASP.NET Core C# App

Einführung

Razor Pages bieten eine leistungsstarke und intuitive Möglichkeit, dynamische Webinhalte in ASP.NET Core-Anwendungen zu erstellen. In Kombination mit den Rendering-Funktionen von IronPDF können Entwickler professionelle PDF-Dokumente direkt aus ihren Webinhalten erstellen. Bei diesem Ansatz entfällt die komplexe PDF-Generierungslogik, und Sie können Ihre vorhandenen HTML- und CSS-Kenntnisse nutzen.

Die Integration von IronPDF und Razor Pages ist besonders wertvoll für die Erstellung von Berichten, Rechnungen, Zertifikaten und allen anderen Dokumenten, die eine dynamische Datendarstellung erfordern. Durch die Verwendung derselben Razor-Syntax, mit der Sie bereits vertraut sind, können Sie die Konsistenz zwischen Ihren Webansichten und PDF-Ausgaben wahren.

Welche NuGet-Pakete benötige ich für die Konvertierung von Razor in PDF?

Das Paket IronPdf.Extensions.Razor ist eine Erweiterung des Hauptpakets IronPdf . Die Pakete IronPdf.Extensions.Razor und IronPdf werden benötigt, um Razor Pages in einer ASP.NET Core Webanwendung als PDF-Dokumente zu rendern. Ausführliche Installationsanweisungen finden Sie in unserer Installationsübersicht .

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

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

Installation mit NuGet

Install-Package IronPdf.Extensions.Razor

nuget.org/packages/IronPdf.Extensions.Razor/

Wie konvertiere ich Razor Pages in ASP.NET Core in PDFs?

Sie benötigen ein ASP.NET Core Web App-Projekt, um Razor Pages in PDF-Dateien zu konvertieren. Der Prozess beinhaltet das Erstellen eines Modells für Ihre Daten, das Einrichten einer Razor Page zur Anzeige dieser Daten und anschließend die Verwendung der RenderRazorToPdf Methode von IronPDF zur Generierung der PDF-Ausgabe.

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

Razor-Seiten in PDFs rendern

Zunächst wird die ChromePdfRenderer-Klasse instanziiert. Es genügt, this an die Methode RenderRazorToPdf zu übergeben, um diese Razor-Seite in ein PDF-Dokument zu konvertieren.

Sie haben vollen Zugriff auf die in RenderingOptions verfügbaren Funktionen. Zu diesen Funktionen gehören die Möglichkeit, Seitenzahlen auf das erzeugte PDF anzuwenden, angepasste Ränder einzustellen und benutzerdefinierten Text sowie HTML-Kopf- und -Fußzeilen hinzuzufügen. Sie können auch Metadaten für Ihre PDFs konfigurieren, um die richtige Identifizierung und Durchsuchbarkeit der Dokumente zu gewährleisten.

• Öffnen Sie das Dropdown für die "persons.cshtml"-Datei, um die "persons.cshtml.cs"-Datei zu sehen.
• Bearbeiten Sie die "persons.cshtml.cs" mit dem unten stehenden Code.

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

Die Methode RenderRazorToPdf gibt ein PdfDocument- Objekt zurück, das einer weiteren Verarbeitung und Bearbeitung unterzogen werden kann. Sie können die PDF-Datei als PDFA oder PDFUA exportieren, eine digitale Signatur auf das gerenderte PDF-Dokument anwenden oder PDF-Dokumente zusammenführen und aufteilen. Mit dieser Methode können Sie auch Seiten drehen, Anmerkungen oder Lesezeichen hinzufügen und benutzerdefinierte Wasserzeichen in Ihre PDF-Datei stempeln.

Für ein besseres Dokumentenmanagement können Sie PDFs auch komprimieren, um die Dateigröße zu verringern, ohne die Qualität zu beeinträchtigen. Dies ist besonders nützlich, wenn es um große Berichte geht oder wenn die Bandbreite ein Problem darstellt. Darüber hinaus werden die umfangreichen Bearbeitungsmöglichkeiten von IronPDF in unserem umfassenden PDF-Bearbeitungs-Tutorial dokumentiert.

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

Was passiert, wenn ich die PDF-Generierung ausführe?

Hier erfahren Sie, wie Sie das Projekt ausführen und ein PDF-Dokument erstellen. Wenn Sie auf den Navigationslink "Person" klicken, werden die Daten in einem Tabellenformat angezeigt. Durch Klicken auf die Schaltfläche "Drucken" wird der PDF-Erzeugungsprozess ausgelöst und die aktuelle Razor Page-Ansicht in ein herunterladbares PDF-Dokument umgewandelt.

Die generierte PDF-Datei behält das gesamte Styling und die Formatierung Ihrer Razor-Seite bei, so dass ein einheitliches Erscheinungsbild zwischen Ihrer Webansicht und der PDF-Ausgabe gewährleistet ist. Dieser Ansatz ist besonders nützlich für die Erstellung von Berichten, Rechnungen oder anderen Dokumenten, die Daten aus der Datenbank oder Geschäftslogik Ihrer Anwendung benötigen.

Wo kann ich ein komplettes ASP.NET Core Web App Beispiel herunterladen?

Sie können den vollständigen Code für diese Anleitung als gezippte Datei herunterladen, die Sie in Visual Studio als ASP.NET Core Web App-Projekt öffnen können.

Laden Sie das RazorPageSample.zip ASP.NET Core Web App Projekt herunter