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.

Recuerda añadir esta declaración en la parte superior de cualquier archivo de clase cs usando IronPDF:

using IronPdf;

using IronPdf;

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

El comportamiento de archivo "InBrowser" 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);

El comportamiento de archivo "Attachment" hace que el PDF se descargue.

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");

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

Controle la salida PDF añadiendo una instancia de la clase IronPdf.ChromePdfRenderer. 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);

Las opciones de renderización de PDF disponibles incluyen:

• CreatePdfFormsFromHtml: Convierte formularios ASPX en formularios PDF editables. Véase crear formularios PDF.
• CssMediaType: estilos CSS Pantalla o Imprimir. Véase imágenes de comparación.
• CustomCssUrl: Aplica CSS personalizado al HTML antes de renderizarlo. Ruta de archivo local o URL remota.
• EnableMathematicalLaTex: activar/desactivar la representación de elementos LaTeX.
• EnableJavaScript: Ejecuta JavaScript antes de la renderización. Ideal para aplicaciones Ajax/Angular. Véase Guía WaitFor.
• Javascript: JavaScript personalizado que se ejecuta después de cargar el HTML pero antes de renderizarlo.
• JavascriptMessageListener: Llamada de retorno para mensajes de consola JavaScript del navegador.
• FirstPageNumber: número de página inicial para encabezados/pies de página. El valor predeterminado es 1.
• TableOfContents: Generar TOC en elemento con id "ironpdf-toc". Véase Guía de contenidos.
• TextHeader: Establece el contenido de la cabecera como texto. Admite la fusión de correos y la vinculación automática de URL.
• TextFooter: Establece el contenido del pie de página como texto. Admite la fusión de correos y la vinculación automática de URL.
• HtmlHeader: Establece el contenido de la cabecera utilizando HTML.
• HtmlFooter: Establece el contenido del pie de página utilizando HTML.
• MarginBottom: margen inferior en milímetros. Cero para borderless.
• MargenIzquierdo: Margen izquierdo en milímetros. Cero para borderless.
• MarginRight: Margen derecho en milímetros. Cero para borderless.
• MarginTop: Margen superior en milímetros. Cero para borderless.
• UseMarginsOnHeaderAndFooter: Utiliza los márgenes del documento principal para encabezados/pies de página.
• PaperFit: Gestor virtual de maquetación de papel. 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 papel: Orientación del PDF: horizontal o vertical.
• PageRotation: Rota las páginas de un documento existente. Consulte ejemplos de orientación.
• TamañoDePapel: Tamaño del papel de salida utilizando System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeinCentimeters: Establece el tamaño del papel en centímetros.
• SetCustomPaperSizeInInches: Establece el tamaño del papel en pulgadas.
• SetCustomPaperSizeinMilimeters: Establece el tamaño del papel en milímetros.
• SetCustomPaperSizeinPixelsOrPoints: Establece el tamaño del papel en píxeles o puntos.
• ForzarTamañoDePapel: Fuerza el tamaño exacto del papel redimensionando después de la generación.
• ImprimirFondosHtml: Imprime fondos de imagen HTML.
• Escala de grises: Imprimir PDF en escala de grises. Véase conversión a escala de grises.
• WaitFor: Configuración para mecanismos de espera:
  • PageLoad: Renderizado por defecto sin esperas.
  • RenderDelay: Tiempo de espera arbitrario.
  • Fuentes: Espera a que se carguen las fuentes.
  • JavaScript: Activar la renderización con una función JavaScript.
  • Elementos HTML: Busca elementos específicos por ID, nombre, etiqueta o selector.
  • NetworkIdle: Espera a que la red esté inactiva (0, 2, o personalizada).
• Título: Metadatos del título del documento PDF. Véase guía de metadatos.
• <código>InputEncoding</código>: Codificación de caracteres. UTF-8 por defecto. Véase Guía UTF-8.
• RequestContext: Contexto de solicitud para renderizar.
• Timeout: Tiempo de espera de renderizado 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);
        }
    }
}

También puede generar encabezados y pies de página HTML con la clase HtmlHeaderFooter, que admite 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);
        }
    }
}

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

• {page}: Número de página actual.
• {total-pages}: Número total de páginas.
• {url}: URL web desde la que se ha renderizado el PDF.
• {date}: Fecha de hoy en el formato del sistema.
• {time}: Hora en formato de 24 horas.
• {html-title}: Título de la etiqueta head de ASPX.
• {pdf-title}: Nombre de archivo del documento.