Cómo Convertir CSHTML a PDF en C#

Convertidor de PDF

Un convertidor PDF es una herramienta que convierte cualquier documento imprimible o página web en un documento PDF. Se puede usar para generar archivos PDF a partir de HTML, Word, Excel o cualquier otro documento imprimible. Los convertidores PDF vienen en varias formas, incluyendo herramientas en línea, software de escritorio y bibliotecas.

Vista de navaja

Una vista Razor es un motor de vistas que se usa en ASP.NET Core para generar páginas HTML dinámicamente. Es una sintaxis de marcado que combina código HTML con código C#.

Vista Razor

La vista Razor facilita a los desarrolladores la creación de páginas web dinámicas al separar la lógica de presentación de la lógica de negocio.

Clase controladora

Una clase controladora es una clase C# que maneja solicitudes HTTP entrantes en una aplicación ASP.NET Core. Contiene métodos que corresponden a verbos HTTP específicos (p. ej., GET, POST, PUT, DELETE) y devuelve una respuesta HTTP.

Administrador de paquetes NuGet

El Administrador de Paquetes NuGet es una herramienta que se usa en Visual Studio para gestionar paquetes en proyectos .NET. Facilita a los desarrolladores instalar, actualizar y desinstalar paquetes en sus proyectos. Los paquetes NuGet son bibliotecas que contienen código reutilizable y se distribuyen a través del Administrador de Paquetes NuGet.

Inyección de dependencia

Inyección de dependencia es un patrón de diseño que permite a los desarrolladores desacoplar sus componentes de aplicación inyectando dependencias en sus clases. Facilita la prueba y mantenimiento de aplicaciones al reducir dependencias y haciendo el código más modular.

Ahora que hemos cubierto los conceptos importantes, profundicemos en el proceso de convertir CSHTML a PDF usando IronPDF.

Paso 1 Instalar IronPDF

El primer paso es instalar IronPDF desde el Administrador de Paquetes NuGet en tu proyecto C#. Puedes instalar IronPDF descargando el archivo IronPDF.dll y agregándolo a las referencias de tu proyecto. Para instalar IronPDF usando el Administrador de Paquetes NuGet, abre la Consola del Administrador de Paquetes y ejecuta el siguiente comando:

Paso 2: Crear un archivo CSHTML

A continuación, crea un archivo CSHTML que contenga el contenido que deseas convertir a PDF. En este ejemplo, crearemos un archivo de tutorial CSHTML sencillo que muestra el texto "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!

Guarda este archivo como "Hello.cshtml" en el directorio de tu proyecto.

Archivos PDF en C#

Paso 3 Convertir CSHTML a documento PDF

Para convertir el archivo CSHTML a PDF, usaremos la biblioteca IronPDF en C#. Aquí está el código para convertir "Hello.cshtml" a 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

Vamos a analizar este código paso a paso:

• Primero importamos los espacios de nombres necesarios, incluyendo el espacio de nombres IronPDF, que contiene la funcionalidad de conversión de HTML a PDF.
• Luego definimos el método Index, que simplemente devuelve una lista de ítems a una vista Razor.
• Definimos el método DownloadPDF, que es responsable de generar el documento PDF.
• Comenzamos creando un renderizador ChromePdfRenderer.
• Luego usamos el método de extensión RenderRazorViewToPdf para generar una vista Razor con datos en un archivo PDF.
• A continuación configuramos los encabezados Content-Disposition para forzar que el PDF se descargue en lugar de mostrarse en el navegador.
• Finalmente, retornamos el documento PDF como un archivo usando el método File.

Este es el código básico para convertir CSHTML a PDF con IronPDF en C#. Sin embargo, hay muchas opciones y configuraciones que se pueden usar para personalizar la salida PDF. Veamos algunas de estas opciones.

Probar la aplicación

Con todo el código necesario en su lugar, ahora podemos probar la aplicación. Siga estos pasos:

• Ejecuta la aplicación presionando F5 o haciendo clic en el botón verde "Play" en Visual Studio.
• En tu navegador web, navega a http://localhost:/Home/Index, donde es el número de puerto asignado por Visual Studio.
• Verifica que la lista de ítems se muestre correctamente.
• Haz clic en el enlace "Descargar PDF" para generar y descargar el documento PDF.

Si todo funciona correctamente, deberías ver un documento PDF que contiene la lista de ítems que definiste anteriormente.

Paso 1 Crear una nueva aplicación de consola

Abre Visual Studio y crea una nueva Aplicación de Consola seleccionando "Archivo > Nuevo > Proyecto" del menú, luego seleccionando "Aplicación de Consola (.NET Framework)" o "Aplicación de Consola (.NET Core)" de la lista de plantillas de proyecto.

Paso 2: Instalar el paquete NuGet de IronPDF

A continuación, necesitamos instalar el paquete NuGet de IronPDF en nuestra Aplicación de Consola. Para hacer esto, haz clic derecho en el proyecto en el Explorador de Soluciones y selecciona "Gestionar Paquetes NuGet" del menú contextual.

En el Administrador de Paquetes NuGet, busca "IronPDF" y selecciona el paquete "IronPDF" de los resultados de búsqueda. Haz clic en el botón "Instalar" para instalar el paquete y sus dependencias.

Paso 3 Agregar archivos PDF y CSHTML al proyecto

Para este ejemplo, usaremos un archivo PDF de ejemplo que queremos convertir a un archivo CSHTML. Puedes usar cualquier archivo PDF que desees para este paso.

Agrega el archivo PDF al proyecto haciendo clic derecho en el proyecto en el Explorador de Soluciones y seleccionando "Agregar > Elemento Existente" del menú contextual.

También necesitamos crear un archivo CSHTML vacío que usaremos para almacenar la cadena HTML convertida. Para hacer esto, haz clic derecho en el proyecto en el Explorador de Soluciones y selecciona "Agregar > Nuevo Elemento" del menú contextual. Selecciona "Página HTML" de la lista de plantillas, luego da un nombre al archivo (por ejemplo, "convertido.cshtml") y haz clic en "Agregar".

Paso 4 Convierte el PDF a un archivo CSHTML

Con los archivos necesarios en su lugar, ahora podemos escribir el código para convertir el PDF a un archivo CSHTML usando IronPDF. Agrega el siguiente código al método Main de tu Aplicación de Consola:

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