De nombreuses organisations utilisent encore ASP.NET Web Forms derrière des portails bancaires, des systèmes comptables, et des tableaux de bord internes. Les applications sont stables, mais elles offrent rarement un moyen propre de fournir un document téléchargeable à un utilisateur. L'ajout de l'exportation de PDF est présenté comme une raison de se déplacer sur MVC ou Blazor, un geste coûteux pour un logiciel qui sinon fonctionne bien. IronPDF prend la voie moins chère : il convertit la page ASPX que l'utilisateur est déjà en train de visionner en PDF avec une seule ligne de code.

Où l'Écart se Manifeste

Une page Web Forms rend habituellement sa facture, état ou rapport en HTML stylé. Le personnel et les clients souhaitent ensuite avoir cette même vue comme un fichier portable qu'ils peuvent enregistrer, envoyer par email ou imprimer. Un modèle PDF séparé signifie une deuxième mise en page qui dérive de la première. La boîte de dialogue d'impression du navigateur donne des résultats différents sur chaque machine. Ce dont les équipes ont besoin est d'un PDF côté serveur qui reflète la page à l'écran.

Rendu de la Page en Place

IronPDF convertit la page ASPX en direct depuis l'intérieur de l'événement Page_Load. La méthode AspxToPdf.RenderThisPageAsPdf réutilise la page déjà construite pour la vue web, de sorte que les styles, liens et champs de formulaire sont conservés.

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 déclenche un téléchargement avec un nom de fichier choisi. FileBehavior.InBrowser affiche le document en ligne à la place.

Contrôler la Sortie

Les options de rendu couvrent les détails qui rendent la sortie adaptée à la distribution : en-têtes, pieds de page, numérotations des pages, et une feuille de style d'impression qui supprime la navigation uniquement à l'écran.

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)

Paramètres Qui Assurent une Conversion Propre

Quelques choix déterminent si la conversion tient sous charge :

• Contenu dynamique : Les pages utilisant Ajax ou des graphiques côté client ont besoin de EnableJavaScript avec une règle WaitFor pour que le rendu capture la page terminée. Voir le guide WaitFor.
• Style d'impression : Régler CssMediaType sur Print applique une feuille de style dédiée, ce qui exclut les boutons et menus du document.
• Débit : Le rendu Chromium est gourmand en ressources, donc le traitement asynchrone garde les points de terminaison à fort trafic réactifs.

Une seule ligne, pas de réécriture

Cet appel unique dans une page existante offre à une application Web Forms des téléchargements de factures, des relevés imprimables et des rapports exportables, sans migration requise. La référence complète de la méthode et les options de configuration se trouvent dans le guide ASPX vers PDF.