Convertir páginas ASPX a PDF en C# ASP.NET

¿Cuándo debo instalar a través de DLL en lugar de NuGet?

Como alternativa, descargue la DLL IronPDF e instálela manualmente en el proyecto o GAC desde Descargar el paquete IronPDF. Para instalaciones específicas de Windows, consulte nuestra Guía de instalación de Windows.

Recuerde añadir esta declaración en la parte superior de cualquier archivo de clase `` utilizando IronPDF:

using IronPdf;

using IronPdf;

Imports IronPdf

¿Cómo puedo controlar el comportamiento de visualización de un PDF?

El comportamiento de archivo "``" intenta mostrar el PDF directamente en el navegador del usuario. Se trata de una característica común de los navegadores modernos que cumplen con los estándares.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser)

El comportamiento de archivo "``" causa que el PDF sea descargado.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment)

¿Cómo personalizo el nombre del archivo PDF?

Establezca el nombre de archivo del documento PDF añadiendo un parámetro adicional. Esto controla el nombre del archivo cuando los usuarios lo descargan o guardan.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf")

¿Qué opciones de impresión de PDF puedo configurar?

Controle la salida del PDF agregando una instancia de la Clase ``. Referencia de API ChromePdfRenderer

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-3.cs

var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
{
    EnableJavaScript = false,
    //.. many more options available
};
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);

Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {.EnableJavaScript = False}
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions)

Las opciones de renderización de PDF disponibles incluyen:

• ``: Convierte formularios ASPX en formularios PDF editables. Véase crear formularios PDF.
• : Estilos CSS de o ``. Véase imágenes de comparación.
• ``: Aplica CSS personalizado al HTML antes de renderizar. Ruta de archivo local o URL remota.
• ``: Habilitar/deshabilitar la renderización de elementos LaTeX.
• ``: Ejecuta JavaScript antes de renderizar. Ideal para aplicaciones Ajax/Angular. Véase Guía WaitFor.
• ``: JavaScript personalizado para ejecutar después de que el HTML se cargue pero antes de renderizar.
• ``: Devolución de llamada para mensajes de la consola de JavaScript del navegador.
• ``: Número de página inicial para encabezados/pies de página. El valor predeterminado es 1.
• ``: Generar TOC en el elemento con id "IronPDF-toc". Véase Guía de contenidos.
• ``: Establecer contenido del encabezado como texto. Admite la fusión de correos y la vinculación automática de URL.
• ``: Establecer contenido del pie de página como texto. Admite la fusión de correos y la vinculación automática de URL.
• ``: Establecer contenido del encabezado usando HTML.
• ``: Establecer contenido del pie de página usando HTML.
• ``: Margen inferior en milímetros. Cero para borderless.
• ``: Margen izquierdo en milímetros. Cero para borderless.
• ``: Margen derecho en milímetros. Cero para borderless.
• ``: Margen superior en milímetros. Cero para borderless.
• ``: Usar márgenes del documento principal para encabezados/pies de página.
• ``: Administrador de diseño de papel virtual. Incluye opciones para el comportamiento de Chrome, zoom, CSS3 responsivo, escalado a página y alimentación continua. Véase guía de viewport.
• ``: Orientación del PDF - Horizontal o Vertical.
• ``: Rotar páginas de un documento existente. Consulte ejemplos de orientación.
• ``: Tamaño de papel de salida usando System.Drawing.Printing.PaperKind.
• ``: Establecer tamaño de papel en centímetros.
• ``: Establecer tamaño de papel en pulgadas.
• ``: Establecer tamaño de papel en milímetros.
• ``: Establecer tamaño de papel en píxeles o puntos.
• ``: Forzar el tamaño exacto del papel redimensionando después de la generación.
• ``: Imprimir fondos de imagen HTML.
• ``: Salida en PDF en escala de grises. Véase conversión a escala de grises.
• ``: Configuración para mecanismos de espera:
  • ``: Representación por defecto sin espera.
  • ``: Tiempo de espera arbitrario.
  • ``: Esperar a que las fuentes se carguen.
  • ``: Iniciar renderizado con función de JavaScript.
  • HTML elements: Esperar a elementos específicos por ID, nombre, etiqueta o selector.
  • ``: Esperar a que la red esté inactiva (0, 2 o personalizado).
• ``: Metadatos del título del documento PDF. Véase guía de metadatos.
• ``: Codificación de caracteres. UTF-8 por defecto. Véase Guía UTF-8.
• ``: Contexto de la solicitud para renderizar.
• ``: Tiempo de espera de renderización en segundos.

¿Cómo implementar encabezados y pies de página?

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-4.cs

using IronSoftware.Drawing;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                TextHeader = new IronPdf.TextHeaderFooter()
                {
                    CenterText = "Invoice",
                    DrawDividerLine = false,
                    Font = FontTypes.Arial,
                    FontSize = 12
                },
                TextFooter = new IronPdf.TextHeaderFooter()
                {
                    LeftText = "{date} - {time}",
                    RightText = "Page {page} of {total-pages}",
                    Font = IronSoftware.Drawing.FontTypes.Arial,
                    FontSize = 12,
                },
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);
        }
    }
}

Imports IronSoftware.Drawing
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace AspxToPdfTutorial
	Partial Public Class Invoice
		Inherits System.Web.UI.Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {
				.TextHeader = New IronPdf.TextHeaderFooter() With {
					.CenterText = "Invoice",
					.DrawDividerLine = False,
					.Font = FontTypes.Arial,
					.FontSize = 12
				},
				.TextFooter = New IronPdf.TextHeaderFooter() With {
					.LeftText = "{date} - {time}",
					.RightText = "Page {page} of {total-pages}",
					.Font = IronSoftware.Drawing.FontTypes.Arial,
					.FontSize = 12
				}
			}
			IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions)
		End Sub
	End Class
End Namespace

Alternativamente, genere encabezados y pies de página HTML usando la clase ``, que soporta CSS, imágenes e hipervínculos.

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-5.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                MarginTop = 50, // make sufficiant space for an HTML header
                HtmlHeader = new IronPdf.HtmlHeaderFooter()
                {
                    HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"
                }
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace AspxToPdfTutorial
	Partial Public Class Invoice
		Inherits System.Web.UI.Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {
				.MarginTop = 50,
				.HtmlHeader = New IronPdf.HtmlHeaderFooter() With {.HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"}
			}
			IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions)
		End Sub
	End Class
End Namespace

Como se ve en nuestros ejemplos, fusione texto dinámico o HTML en encabezados/pies de página utilizando marcadores de posición:

• ``: Número de página actual.
• ``: Número total de páginas.
• ``: URL web desde la cual se renderizó el PDF.
• ``: Fecha de hoy en formato del sistema.
• ``: Hora en formato de 24 horas.
• ``: Título de la etiqueta head de ASPX.
• ``: Nombre del archivo del documento.

Los portales de gestión documental y facturación electrónica basados en ASP.NET WebForms o ASP.NET MVC son habituales en empresas españolas que gestionan sus obligaciones tributarias digitalmente. IronPDF encaja en estos flujos de los siguientes modos:

• Software de facturación VeriFactu en ASP.NET: Los ISVs españoles que desarrollan software de facturación bajo la normativa VeriFactu —cuyo incumplimiento puede acarrear sanciones de hasta 150.000 €/año— utilizan la conversión ASPX-a-PDF para generar los PDFs de facturas desde las páginas de previsualización de la aplicación web.
• Portales de envío Facturae a FACe: Las aplicaciones ASP.NET que gestionan el envío de facturas electrónicas en formato Facturae a la plataforma FACe del Gobierno de España generan PDFs de confirmación de envío mediante conversión desde ASPX.
• Certificados FNMT y firma digital: Los portales que requieren autenticación con certificado FNMT (el principal emisor español de certificados digitales para personas físicas y jurídicas) o con Cl@ve generan PDFs firmados PAdES a partir de las páginas de confirmación, integrando las capacidades de firma digital y PDF/A de IronPDF.
• Archivado AEAT: Los PDFs generados desde ASPX para documentación fiscal se guardan en formato PDF/A-3 para cumplir los plazos de retención de la AEAT y las auditorías tributarias.

Tutorial de acceso rápido

Explora este tutorial en GitHub

El código de este proyecto ASPX-To-PDF en C# está disponible en C# y VB.NET en GitHub como proyecto de sitio web ASP.NET. Por favor, siga adelante y bifurcarnos en GitHub para obtener más ayuda usando IronPDF. Siéntase libre de compartir esto con cualquier persona que podría estar preguntando, "¿Cómo puedo convertir ASPX a PDF?

Proyecto de sitio web ASPX a PDF en C# Ejemplos avanzados de ASP.NET Page to PDF en C# para crear archivos PDF ASP.NET PDF Ejemplos en VB.NET para crear PDFs

Descargar la guía de inicio rápido de C# en PDF

Para facilitar el desarrollo de archivos PDF en sus aplicaciones .NET, hemos recopilado una guía rápida en un documento PDF. Esta "Cheat-Sheet" proporciona acceso rápido a funciones y ejemplos comunes para generar y editar PDFs en C# y VB.NET, y le ayudará a ahorrar tiempo al empezar a utilizar IronPDF en su proyecto .NET.

Descargar

Ver la referencia de la API

Explore la Referencia de API para IronPDF, que describe los detalles de todas las características, espacios de nombres, clases, métodos, campos y enums de IronPDF.

Ver la referencia de la API de IronPDF