Dużo organizacji wciąż prowadzi ASP.NET Web Forms za portalami bankowymi, systemami księgowymi oraz wewnętrznymi pulpitami. Aplikacje są stabilne, ale rzadko oferują czysty sposób na przekazanie użytkownikowi dokumentu do pobrania. Dodanie eksportu PDF często jest pretekstem do przeniesienia na MVC lub Blazor, co jest kosztownym krokiem dla oprogramowania, które działa dobrze. IronPDF wybiera tańszą drogę: przekształca stronę ASPX, którą użytkownik już ogląda, w PDF przy użyciu jednej linii kodu.

Gdzie pojawia się luka

Strona Web Forms zwykle renderuje swoją fakturę, raport lub sprawozdanie jako już stylizowany HTML. Personel i klienci chcą następnie, żeby ten sam widok był dostępny jako plik przenośny, który mogą zapisać, wysłać mailem lub wydrukować. Oddzielny szablon PDF oznacza drugi układ, który odbiega od pierwszego. Okno dialogowe drukowania przeglądarki przynosi inne wyniki na każdym urządzeniu. Tym, czego zespoły potrzebują, jest serwerowy PDF, który odzwierciedla stronę na ekranie.

Renderowanie strony na miejscu

IronPDF konwertuje aktywną stronę ASPX z wnętrza zdarzenia Page_Load. Metoda AspxToPdf.RenderThisPageAsPdf ponownie wykorzystuje stronę już zbudowaną dla widoku web, dzięki czemu style, linki i pola formularza są przenoszone.

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 wyzwala pobieranie z wybraną nazwą pliku. FileBehavior.InBrowser wyświetla dokument inline zamiast tego.

Kontrolowanie wyjścia

Opcje renderowania obejmują szczegóły, które sprawiają, że wyjście nadaje się do dystrybucji: nagłówki, stopki, numeracja stron oraz styl wydruku, który usuwa tylko-nawigacje ekranowe.

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)

Ustawienia, które decydują o czystej konwersji

Kilka wyborów decyduje, czy konwersja wytrzyma pod obciążeniem:

• Dynamiczna zawartość: Strony używające Ajax lub wykresów po stronie klienta potrzebują EnableJavaScript razem z regułą WaitFor, aby renderowanie uchwyciło ukończoną stronę. Zobacz przewodnik po WaitFor.
• Stylizacja do druku: Ustawienie CssMediaType na Print stosuje dedykowany arkusz stylów, który usuwa przyciski i menu z dokumentu.
• Przepustowość: Renderowanie Chromium jest zasobochłonne, więc przetwarzanie asynchroniczne utrzymuje responsywność punktów końcowych o dużym ruchu.

Jedna linia, bez przepisywania

To jedno wywołanie wewnątrz istniejącej strony daje aplikacji Web Forms pobrania faktur, dokumenty do druku i eksportowane raporty, bez potrzeby migracji. Pełna dokumentacja metody i opcje konfiguracji znajdują się w przewodniku ASPX do PDF.