Cómo convertir Razor Pages a PDF en ASP.NET Core C# App

Introducción

Razor Pages ofrece una forma potente e intuitiva de crear contenido web dinámico en aplicaciones ASP.NET Core. Cuando se combinan con las capacidades de renderizado de IronPDF, los desarrolladores pueden crear documentos PDF profesionales directamente a partir de su contenido web. Este enfoque elimina la compleja lógica de generación de PDF y le permite utilizar sus conocimientos existentes de HTML y CSS.

La integración entre IronPDF y Razor Pages es especialmente valiosa para generar informes, facturas, certificados y cualquier otro documento que requiera una presentación dinámica de los datos. Al utilizar la misma sintaxis de Razor con la que ya está familiarizado, puede mantener la coherencia entre las vistas web y las salidas PDF.

En España, los ISVs que desarrollan soluciones de facturación electrónica conforme a VeriFactu o portales de envío a FACe adoptan habitualmente ASP.NET Core con Razor Pages como capa de presentación. IronPDF permite generar el PDF de cortesía adjunto al XML Facturae directamente desde plantillas Razor, integrando los campos obligatorios exigidos por la AEAT (NIF, CIF, base imponible, tipo IVA, número de serie) sin modificar la lógica de negocio existente.

¿Qué paquetes NuGet necesito para la conversión de Razor a PDF?

El paquete IronPdf.Extensions.Razor es una extensión del paquete principal IronPdf. Tanto los paquetes IronPdf.Extensions.Razor como IronPdf son necesarios para renderizar Razor Pages a documentos PDF en una aplicación web ASP.NET Core. Para obtener instrucciones de instalación detalladas, visita nuestra guía de visión general de instalación.

# 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

Instalar con NuGet

Install-Package IronPdf.Extensions.Razor

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

¿Cómo convierto páginas Razor a PDF en ASP.NET Core?

Necesitará un proyecto de aplicación web ASP.NET Core para convertir Razor Pages en archivos PDF. El proceso implica crear un modelo para tus datos, configurar una Razor Page para mostrar esos datos y luego usar el método RenderRazorToPdf de IronPDF para generar la salida 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>

Renderizar páginas Razor a PDF

A continuación, el código a continuación primero instancia la clase ChromePdfRenderer. Pasar this al método RenderRazorToPdf es suficiente para convertir esta Razor Page en un documento PDF.

Tiene acceso completo a las funciones disponibles en RenderingOptions. Estas funciones incluyen la capacidad de aplicar números de página al PDF generado, establecer margenes personalizados y añadir texto personalizado, así como encabezados y pies de página HTML. También puede configurar metadatos para sus PDF con el fin de garantizar la correcta identificación y búsqueda de documentos.

• Abre el desplegable para el archivo Persons.cshtml para ver el archivo Persons.cshtml.cs.
• Modifica el Persons.cshtml.cs con el código a continuación.

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

El método RenderRazorToPdf devuelve un objeto PdfDocument que puede someterse a procesamiento y edición adicionales. Puedes exportar el PDF como PDFA o PDFUA, aplicar una firma digital al documento PDF renderizado, o fusionar y dividir documentos PDF. El método también permite rotar páginas, añadir anotaciones o marcadores y estampar marcas de agua personalizadas en el PDF.

Para mejorar la gestión de documentos, también puede comprimir los PDF para reducir el tamaño del archivo sin comprometer la calidad. Esto es especialmente útil cuando se trata de informes de gran tamaño o cuando el ancho de banda es un problema. Además, las amplias capacidades de edición que ofrece IronPDF están documentadas en nuestro completo tutorial de edición de 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>

¿Qué ocurre cuando ejecuto la generación de PDF?

Aquí se muestra cómo ejecutar el proyecto y generar un documento PDF. Cuando haga clic en el enlace de navegación "Persona", verá los datos mostrados en formato de tabla. Al hacer clic en el botón "Imprimir" se activa el proceso de generación de PDF, convirtiendo la vista actual de Razor Page en un documento PDF descargable.

El PDF generado mantiene todo el estilo y el formato de su página Razor, lo que garantiza un aspecto coherente entre la vista web y la salida PDF. Este enfoque es especialmente útil para generar informes, facturas o cualquier documento que requiera datos de la base de datos o de la lógica empresarial de su aplicación.

¿Dónde puedo descargar un ejemplo completo de aplicación web ASP.NET Core?

Puedes descargar el código completo para esta guía como un archivo comprimido, que puedes abrir en Visual Studio como un proyecto de Aplicación Web ASP.NET Core.

Razor Pages e IronPDF en el ecosistema de facturación electrónica española

ASP.NET Core con Razor Pages es el stack tecnológico preferido por los ISVs españoles que desarrollan nuevas soluciones de facturación electrónica, dado que combina la productividad del ecosistema Microsoft con la modernidad de .NET Core. IronPDF se integra de forma nativa en este entorno para cubrir los requisitos de generación de PDF exigidos por la normativa española.