Cómo ver archivos PDF en ASP.NET usando C# e IronPDF

Configuración de la biblioteca IronPDF

Hay dos maneras de instalar la biblioteca;

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

Crear un archivo PDF a partir de una cadena HTML en .NET C#

Crear un archivo PDF desde una cadena HTML en C# es un método eficiente y gratificante para crear un nuevo archivo PDF en C#.

La función RenderHtmlAsPdf de un ChromePdfRenderer proporciona una manera fácil de convertir cualquier cadena HTML (HTML5) en un documento PDF, gracias a la versión integrada del motor Google Chromium en el DLL de IronPDF.

// Create a renderer to convert HTML to PDF
var renderer = new ChromePdfRenderer();

// Convert an HTML string to a PDF
using var renderedPdf = renderer.RenderHtmlAsPdf("<h1>My First HTML to Pdf</h1>");

// Define the output path for the PDF
var outputPath = "My_First_Html.pdf";

// Save the rendered PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Automatically open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

// Create a renderer to convert HTML to PDF
var renderer = new ChromePdfRenderer();

// Convert an HTML string to a PDF
using var renderedPdf = renderer.RenderHtmlAsPdf("<h1>My First HTML to Pdf</h1>");

// Define the output path for the PDF
var outputPath = "My_First_Html.pdf";

// Save the rendered PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Automatically open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

' Create a renderer to convert HTML to PDF
Dim renderer = New ChromePdfRenderer()

' Convert an HTML string to a PDF
Dim renderedPdf = renderer.RenderHtmlAsPdf("<h1>My First HTML to Pdf</h1>")

' Define the output path for the PDF
Dim outputPath = "My_First_Html.pdf"

' Save the rendered PDF to the specified path
renderedPdf.SaveAs(outputPath)

' Automatically open the newly created PDF
System.Diagnostics.Process.Start(outputPath)

RenderHtmlAsPdf es una herramienta poderosa que admite en total CSS, JavaScript e imágenes. Puede ser necesario configurar el segundo argumento de RenderHtmlAsPdf si estos materiales están almacenados en un disco duro.

El siguiente código generará un archivo PDF:

// Render HTML to PDF with a base path for local assets
var renderPdf = renderer.RenderHtmlAsPdf("<img src='image_1.png'/>", @"C:\Newproject");

// Render HTML to PDF with a base path for local assets
var renderPdf = renderer.RenderHtmlAsPdf("<img src='image_1.png'/>", @"C:\Newproject");

' Render HTML to PDF with a base path for local assets
Dim renderPdf = renderer.RenderHtmlAsPdf("<img src='image_1.png'/>", "C:\Newproject")

Todas las hojas de estilo CSS, imágenes y archivos JavaScript referenciados serán relativos al BaseUrlPath, lo que permite mantener una estructura más organizada y lógica. Por supuesto, puedes hacer uso de imágenes, hojas de estilo y activos disponibles en internet, como Web Fonts, Google Fonts e incluso jQuery, si lo deseas.

Crear un documento PDF utilizando una URL HTML existente

Las URLs existentes pueden ser representadas en PDFs de manera eficiente con C#; esto también permite a los equipos dividir el trabajo de diseño de PDF y representación de PDF en el back-end a través de varias secciones, lo cual es beneficioso.

El código a continuación demuestra cómo representar la página endeavorcreative.com desde su URL:

// Create a renderer for converting URLs to PDF
var renderer = new ChromePdfRenderer();

// Convert the specified URL to a PDF
using var renderedPdf = renderer.RenderUrlAsPdf("https://endeavorcreative.com/setting-up-wordpress-website-from-scratch/");

// Specify the output path for the PDF
var outputPath = "Url_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

// Create a renderer for converting URLs to PDF
var renderer = new ChromePdfRenderer();

// Convert the specified URL to a PDF
using var renderedPdf = renderer.RenderUrlAsPdf("https://endeavorcreative.com/setting-up-wordpress-website-from-scratch/");

// Specify the output path for the PDF
var outputPath = "Url_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

' Create a renderer for converting URLs to PDF
Dim renderer = New ChromePdfRenderer()

' Convert the specified URL to a PDF
Dim renderedPdf = renderer.RenderUrlAsPdf("https://endeavorcreative.com/setting-up-wordpress-website-from-scratch/")

' Specify the output path for the PDF
Dim outputPath = "Url_pdf.pdf"

' Save the PDF to the specified path
renderedPdf.SaveAs(outputPath)

' Open the newly created PDF
System.Diagnostics.Process.Start(outputPath)

Como resultado, todos los hipervínculos (enlaces HTML) e incluso formularios HTML se mantienen en el PDF generado.

Crear un documento PDF a partir de un documento HTML existente

Esta sección muestra cómo representar cualquier archivo HTML local. Parecerá que el archivo se ha abierto utilizando el protocolo file:/ para todos los activos relativos, como CSS, imágenes y JavaScript, entre otros.

// Create a renderer for existing HTML files
var renderer = new ChromePdfRenderer();

// Render an HTML file to PDF
using var renderedPdf = renderer.RenderHtmlFileAsPdf("Assets/test1.html");

// Specify the output path for the PDF
var outputPath = "test1_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

// Create a renderer for existing HTML files
var renderer = new ChromePdfRenderer();

// Render an HTML file to PDF
using var renderedPdf = renderer.RenderHtmlFileAsPdf("Assets/test1.html");

// Specify the output path for the PDF
var outputPath = "test1_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

' Create a renderer for existing HTML files
Dim renderer = New ChromePdfRenderer()

' Render an HTML file to PDF
Dim renderedPdf = renderer.RenderHtmlFileAsPdf("Assets/test1.html")

' Specify the output path for the PDF
Dim outputPath = "test1_pdf.pdf"

' Save the PDF to the specified path
renderedPdf.SaveAs(outputPath)

' Open the newly created PDF
System.Diagnostics.Process.Start(outputPath)

La ventaja de esta estrategia es que permite a los desarrolladores probar contenido HTML en un navegador mientras lo crean. El motor de representación de IronPDF está construido sobre el navegador web Chrome. Por lo tanto, se recomienda utilizar Conversión de XML a PDF ya que imprimir contenido XML en PDF se puede realizar usando plantillas XSLT.

Convertir formularios web ASP.NET en un archivo PDF

Con una sola línea de código, puedes convertir formularios en línea de ASP.NET a formato PDF en lugar de HTML. Coloca la línea de código en el método Page_Load del archivo de código subyacente de la página para que aparezca en la página.

Las Aplicaciones Web de Formularios ASP.NET pueden ser creadas desde cero o abiertas desde una versión anterior.

Instala el paquete NuGet si aún no está instalado.

La palabra clave using debe usarse para importar el espacio de nombres IronPdf.

Navega al código detrás de la página que te gustaría convertir a PDF. Por ejemplo, el archivo Default.aspx.cs usando ASP.NET.

RenderThisPageAsPdf es un método en la clase AspxToPdf.

using IronPdf;
using System;
using System.Web.UI;

namespace WebApplication7
{
    public partial class _Default : Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            // Render the current page as a PDF in the browser
            AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
        }
    }
}

using IronPdf;
using System;
using System.Web.UI;

namespace WebApplication7
{
    public partial class _Default : Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            // Render the current page as a PDF in the browser
            AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
        }
    }
}

Imports IronPdf
Imports System
Imports System.Web.UI

Namespace WebApplication7
	Partial Public Class _Default
		Inherits Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			' Render the current page as a PDF in the browser
			AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)
		End Sub
	End Class
End Namespace

Esto requiere que se instale el Paquete NuGet IronPDF.Extensions.ASPX. No está disponible en .NET Core porque ASPX ha sido reemplazado por el modelo MVC.

Aplicar plantillas HTML

Para los desarrolladores de Intranet y sitios web, la capacidad de diseñar o "producir en lote" PDFs es una necesidad estándar.

En lugar de crear una plantilla para un documento PDF, la Biblioteca IronPDF ofrece una manera de generar una plantilla para HTML aprovechando la tecnología existente y bien probada.

Un archivo PDF generado dinámicamente se crea cuando la plantilla HTML se complementa con datos de una cadena de consulta o una base de datos, como se muestra a continuación.

Como ejemplo, considera la clase String de C# y sus propiedades. El método Format funciona bien para operaciones básicas de "fusión de correo".

// Basic HTML String Formatting
string formattedString = String.Format("<h1>Hello {0}!</h1>", "World");

// Basic HTML String Formatting
string formattedString = String.Format("<h1>Hello {0}!</h1>", "World");

' Basic HTML String Formatting
Dim formattedString As String = String.Format("<h1>Hello {0}!</h1>", "World")

Debido a que los archivos HTML pueden ser bastante extensos, es común utilizar marcadores de posición arbitrarios, como [[NAME]], y luego reemplazarlos con los datos reales.

El siguiente ejemplo generará tres documentos PDF, cada uno de los cuales estará personalizado para un usuario diferente.

// Define an HTML template with a placeholder
var htmlTemplate = "<p>[[NAME]]</p>";

// Sample data to replace placeholders
var names = new[] { "John", "James", "Jenny" };

// Create a new PDF for each name
foreach (var name in names)
{
    // Replace placeholder with actual name
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Create a renderer and render the HTML as PDF
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save the PDF with the name in the filename
    pdf.SaveAs($"{name}.pdf");
}

// Define an HTML template with a placeholder
var htmlTemplate = "<p>[[NAME]]</p>";

// Sample data to replace placeholders
var names = new[] { "John", "James", "Jenny" };

// Create a new PDF for each name
foreach (var name in names)
{
    // Replace placeholder with actual name
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Create a renderer and render the HTML as PDF
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save the PDF with the name in the filename
    pdf.SaveAs($"{name}.pdf");
}

' Define an HTML template with a placeholder
Dim htmlTemplate = "<p>[[NAME]]</p>"

' Sample data to replace placeholders
Dim names = { "John", "James", "Jenny" }

' Create a new PDF for each name
For Each name In names
	' Replace placeholder with actual name
	Dim htmlInstance = htmlTemplate.Replace("[[NAME]]", name)

	' Create a renderer and render the HTML as PDF
	Dim renderer = New ChromePdfRenderer()
	Dim pdf = renderer.RenderHtmlAsPdf(htmlInstance)

	' Save the PDF with the name in the filename
	pdf.SaveAs($"{name}.pdf")
Next name

Enrutamiento de ASP.NET MVC: Descargar la versión PDF de esta página

Con el marco ASP.NET MVC, puedes dirigir al usuario a un archivo PDF.

Al crear una nueva Aplicación MVC de ASP.NET o agregar un controlador MVC existente a una aplicación existente, selecciona esta opción. Inicia el asistente de nuevo proyecto de Visual Studio seleccionando Aplicación Web de ASP.NET (.NET Framework) > MVC del menú desplegable. Alternativamente, puedes abrir un proyecto MVC existente. Reemplaza el método Index en el archivo HomeController en la carpeta Controllers, o crea un nuevo controlador en la carpeta Controllers.

A continuación se muestra un ejemplo de cómo debe escribirse el código:

using IronPdf;
using System;
using System.Web.Mvc;

namespace WebApplication8.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            // Render a URL as PDF and return it in the response
            using var pdf = HtmlToPdf.StaticRenderUrlAsPdf(new Uri("https://en.wikipedia.org"));
            return File(pdf.BinaryData, "application/pdf", "Wiki.Pdf");
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";
            return View();
        }
    }
}

using IronPdf;
using System;
using System.Web.Mvc;

namespace WebApplication8.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            // Render a URL as PDF and return it in the response
            using var pdf = HtmlToPdf.StaticRenderUrlAsPdf(new Uri("https://en.wikipedia.org"));
            return File(pdf.BinaryData, "application/pdf", "Wiki.Pdf");
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";
            return View();
        }
    }
}

Imports IronPdf
Imports System
Imports System.Web.Mvc

Namespace WebApplication8.Controllers
	Public Class HomeController
		Inherits Controller

		Public Function Index() As ActionResult
			' Render a URL as PDF and return it in the response
			Dim pdf = HtmlToPdf.StaticRenderUrlAsPdf(New Uri("https://en.wikipedia.org"))
			Return File(pdf.BinaryData, "application/pdf", "Wiki.Pdf")
		End Function

		Public Function About() As ActionResult
			ViewBag.Message = "Your application description page."
			Return View()
		End Function

		Public Function Contact() As ActionResult
			ViewBag.Message = "Your contact page."
			Return View()
		End Function
	End Class
End Namespace

Añadir una portada a un documento PDF

Agregar una Página de Portada a un documento PDF

IronPDF simplifica el proceso de combinar documentos PDF. La aplicación más común de esta técnica es agregar una página de portada o página posterior a un documento PDF ya renderizado que ha sido renderizado.

Para lograr esto, prepara una página de portada y luego usa las capacidades de PdfDocument.

Para combinar los dos documentos, usa el Método de Combinación de Documentos PDF.

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/");

// Merge the cover page with the rendered PDF
using var merged = PdfDocument.Merge(new PdfDocument("CoverPage.pdf"), pdf);

// Save the merged document
merged.SaveAs("Combined.Pdf");

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/");

// Merge the cover page with the rendered PDF
using var merged = PdfDocument.Merge(new PdfDocument("CoverPage.pdf"), pdf);

// Save the merged document
merged.SaveAs("Combined.Pdf");

' Create a renderer and render a PDF from a URL
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/")

' Merge the cover page with the rendered PDF
Dim merged = PdfDocument.Merge(New PdfDocument("CoverPage.pdf"), pdf)

' Save the merged document
merged.SaveAs("Combined.Pdf")

Añada una marca de agua a su documento

Por último, pero no menos importante, agregar una marca de agua a los documentos PDF se puede lograr usando código C#; esto se puede usar para agregar un descargo de responsabilidad a cada página de un documento que indique que es "confidencial" o "una muestra".

// Prepare a stamper with HTML content for the watermark
HtmlStamper stamper = new HtmlStamper("<h2 style='color:red'>SAMPLE</h2>")
{
    HorizontalOffset = new Length(-3, MeasurementUnit.Inch),
    VerticalAlignment = VerticalAlignment.Bottom
};

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");

// Apply the watermark to the PDF
pdf.ApplyStamp(stamper);

// Save the watermarked PDF
pdf.SaveAs(@"C:\PathToWatermarked.pdf");

// Prepare a stamper with HTML content for the watermark
HtmlStamper stamper = new HtmlStamper("<h2 style='color:red'>SAMPLE</h2>")
{
    HorizontalOffset = new Length(-3, MeasurementUnit.Inch),
    VerticalAlignment = VerticalAlignment.Bottom
};

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");

// Apply the watermark to the PDF
pdf.ApplyStamp(stamper);

// Save the watermarked PDF
pdf.SaveAs(@"C:\PathToWatermarked.pdf");

' Prepare a stamper with HTML content for the watermark
Dim stamper As New HtmlStamper("<h2 style='color:red'>SAMPLE</h2>") With {
	.HorizontalOffset = New Length(-3, MeasurementUnit.Inch),
	.VerticalAlignment = VerticalAlignment.Bottom
}

' Create a renderer and render a PDF from a URL
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf")

' Apply the watermark to the PDF
pdf.ApplyStamp(stamper)

' Save the watermarked PDF
pdf.SaveAs("C:\PathToWatermarked.pdf")

Su archivo PDF puede protegerse con una contraseña

Cuando estableces la propiedad de contraseña de un documento PDF, se cifrará y el usuario deberá proporcionar la contraseña correcta para leer el documento. Este ejemplo se puede usar en una Aplicación de Consola de .NET Core.

using IronPdf;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a renderer and render a PDF from HTML
            var renderer = new ChromePdfRenderer();
            using var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

            // Set password to protect the PDF
            pdfDocument.Password = "strong!@#pass&^%word";

            // Save the secured PDF
            pdfDocument.SaveAs("secured.pdf");
        }
    }
}

using IronPdf;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a renderer and render a PDF from HTML
            var renderer = new ChromePdfRenderer();
            using var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

            // Set password to protect the PDF
            pdfDocument.Password = "strong!@#pass&^%word";

            // Save the secured PDF
            pdfDocument.SaveAs("secured.pdf");
        }
    }
}

Imports IronPdf

Namespace ConsoleApp
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a renderer and render a PDF from HTML
			Dim renderer = New ChromePdfRenderer()
			Dim pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

			' Set password to protect the PDF
			pdfDocument.Password = "strong!@#pass&^%word"

			' Save the secured PDF
			pdfDocument.SaveAs("secured.pdf")
		End Sub
	End Class
End Namespace

Sin las ventajas mencionadas anteriormente, con IronPDF, también puedes:

• Extraer imágenes y texto de PDFs
• Editar el contenido HTML de PDFs
• Mejorar imágenes de fondo y primer plano
• Agregar firma digital a PDFs
• Completa automáticamente tus formularios PDF rápida y fácilmente

Crear PDFs es una tarea tan desafiante; algunas personas pueden no haber encontrado nunca las nociones fundamentales que deberían emplear para producir los documentos más destacados. Como resultado, IronPDF es extremadamente útil, ya que simplifica la creación de PDFs y, como resultado, mejora la presentación original de documentos creados a partir de PDFs y HTML.

Basado en la información proporcionada en la documentación y el análisis de competidores: IronPDF es la herramienta más efectiva para usar al crear PDFs, haciéndolo simple para cualquiera, incluidos aquellos que trabajan en oficinas o escuelas, para completar sus tareas eficientemente.

Cómo ver archivos PDF en ASP.NET usando C# e IronPDF

IronPDF es una biblioteca de .NET imprescindible. Obtén el tuyo ahora y pruébalo con el paquete NuGet de IronPDF.