Muchas organizaciones todavía ejecutan ASP.NET Web Forms detrás de portales bancarios, sistemas contables y tableros internos. Las aplicaciones son estables, pero rara vez ofrecen una forma limpia de entregar al usuario un documento descargable. Agregar exportación de PDF se enmarca como motivo para re-plataforma a MVC o Blazor, un movimiento costoso para un software que de otro modo funciona bien. IronPDF toma la ruta más económica: convierte la página ASPX que el usuario ya está viendo en un PDF con una línea de código.

Donde Muestra el Vacío

Una página de Web Forms generalmente renderiza su factura, estado de cuenta o informe como HTML estilizado ya. El personal y los clientes entonces quieren esa misma vista como un archivo portable que puedan guardar, enviar por correo electrónico o imprimir. Una plantilla de PDF separada significa un segundo diseño que se desvía del primero. El cuadro de diálogo de impresión del navegador produce resultados diferentes en cada máquina. Lo que los equipos necesitan es un PDF del lado del servidor que refleje la página en pantalla.

Renderizando la Página en su Sitio

IronPDF convierte la página ASPX en vivo desde dentro del evento Page_Load. El método AspxToPdf.RenderThisPageAsPdf reutiliza la página ya construida para la vista web, por lo que el estilo, los enlaces y los campos de formulario se mantienen.

using IronPdf;

public partial class Invoice : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");
    }
}

using IronPdf;

public partial class Invoice : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");
    }
}

Imports IronPdf

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

    Protected Sub Page_Load(sender As Object, e As EventArgs)
        AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf")
    End Sub
End Class

Imports IronPdf

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

    Protected Sub Page_Load(sender As Object, e As EventArgs)
        AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf")
    End Sub
End Class

FileBehavior.Attachment desencadena una descarga con un nombre de archivo seleccionado. FileBehavior.InBrowser muestra el documento en línea en su lugar.

Controlando la Salida

Las opciones de renderizado cubren los detalles que hacen que la salida sea adecuada para su distribución: encabezados, pies de página, numeración de páginas y una hoja de estilo de impresión que elimina la navegación solo de pantalla.

var options = new ChromePdfRenderOptions
{
    CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print,
    TextFooter = new TextHeaderFooter
    {
        LeftText = "{date} - {time}",
        RightText = "Page {page} of {total-pages}"
    }
};
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", options);

var options = new ChromePdfRenderOptions
{
    CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print,
    TextFooter = new TextHeaderFooter
    {
        LeftText = "{date} - {time}",
        RightText = "Page {page} of {total-pages}"
    }
};
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", options);

Imports IronPdf.Rendering

Dim options As New ChromePdfRenderOptions With {
    .CssMediaType = PdfCssMediaType.Print,
    .TextFooter = New TextHeaderFooter With {
        .LeftText = "{date} - {time}",
        .RightText = "Page {page} of {total-pages}"
    }
}
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", options)

Imports IronPdf.Rendering

Dim options As New ChromePdfRenderOptions With {
    .CssMediaType = PdfCssMediaType.Print,
    .TextFooter = New TextHeaderFooter With {
        .LeftText = "{date} - {time}",
        .RightText = "Page {page} of {total-pages}"
    }
}
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", options)

Configuraciones que Deciden una Conversión Limpia

Un puñado de elecciones determinan si la conversión se mantiene bajo carga:

• Contenido dinámico: Las páginas que usan Ajax o gráficos del lado del cliente necesitan EnableJavaScript junto con una regla WaitFor para que el renderizado capture la página finalizada. Vea la guía de WaitFor.
• Estilo de impresión: Configurar CssMediaType para Imprimir aplica una hoja de estilo dedicada, que mantiene los botones y menús fuera del documento.
• Rendimiento: El renderizado en Chromium requiere muchos recursos, por lo que el procesamiento asíncrono mantiene los puntos finales de alto tráfico receptivos.

Una línea, sin reescritura

Esa única llamada dentro de una página existente le da a una aplicación de Web Forms descargas de facturas, estados de cuenta imprimibles y informes exportables, sin migración requerida. La referencia completa del método y las opciones de configuración están en la guía de ASPX a PDF.