Jak tworzyć pliki PDF w .NET Core za pomocą IronPDF

Problem z eksportowaniem pulpitow nawigacyjnych

Wewnetrzne pulpity nawigacyjne sa tworzone do przeglądania w przeglądarce internetowej. W momencie, gdy ktos potrzebuje udostepnic jeden na zewnatrz: prezentacja na posiedzenie zarzadu, cotygodniowy zrzut KPI dla zespolu zarządzającego lub raport z audytu zgodności, rzeczy szybko sie psuja.

Pierwsza rzecza, która ludzie probuja, a która nie działa, jest drukowanie z przeglądarki do formatu PDF. Strony lamia sie i przecinaja wykresy, paski nawigacji wposty przesiakaja do ukladu, a wynikowy PDF w niczym nie przypomina prawdziwego pulpitu nawigacyjnego. Zrzuty ekranu sa gorsze: rozdzielczosc pogarsza sie po przeskalowaniu do A4, tekst nie jest przeszukiwalny, a widok KPI z wieloma sekcjami rzadko miesci sie w jednym obrazie bez utraty polowy danych.

Glebszym problemem sa wykresy renderowane za pomoca JavaScript. Poniewaz Chart.js, ApexCharts i Highcharts rysuja asynchronicznie do elementu HTML , natywne migawki HTML do PDF czesto uchwycaja pustego kanfu. Zawartosc HTML jest obecna w DOM, ale wizualizacja nie. Tutaj może pomoc IronPDF.

Efektem jest, ze programista otrzymuje ikonke wiadomosci co poniedzialek, proszaca o reczne pobranie i formatowanie raportu. To nie jest skalowalny proces pracy. Dzisiaj spojrzymy na przykład IronPDF, aby zobaczyć, jak może utworzyć dokumenty PDF z zawartości HTML.

Rozwiazanie: renderowanie pulpitow nawigacyjnych po stronie serwera z wykorzystaniem IronPDF

IronPDF renderuje ta sama HTML, która napedza twoj pulpit nawigacyjny, do dokumentu PDF zgodnego z oryginalem. Uzytkownik klika przycisk 'Eksportuj do PDF' (może oznaczony kluczem w niebieskim kole lub niebieskim kluczem w kolo), punkt koncowy API obsługuje logike konwersji HTML, a przeglądarka pobiera zawartość PDF.

Nie ma potrzeby wdrazania Puppeteer sidecar, nie ma binarnego wkhtmltopdf do zarządzania i nie ma platnych interfejsow API eksportu zewnatrz, ktore trzeba monitorowac. IronPDF działa wewnątrz twojej istniejącej aplikacji ASP.NET jako biblioteka NuGet w C# do zadań PDF. Wbudowuje silnik Chromium, ktory wykonuje JavaScript dokladnie tak, jak robi to prawdziwa przeglądarka, co oznacza, ze Chart.js i ApexCharts renderuja sie poprawnie, poniewaz uruchamiaja sie przed przechwyceniem strony.

Przycisk eksportu staje sie funkcja samoobslugowa, która kazdy użytkownik biznesowy może obsługiwac, nie angażujac programisty w proces.

Jak to działa w praktyce

document.getElementById('export-btn').addEventListener('click', async () => {
    const params = new URLSearchParams({ from: dateFrom, to: dateTo, region: selectedRegion });
    const response = await fetch(`/api/reports/export?${params}`);
    const blob = await response.blob();
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'dashboard-report.pdf';
    a.click();
});

document.getElementById('export-btn').addEventListener('click', async () => {
    const params = new URLSearchParams({ from: dateFrom, to: dateTo, region: selectedRegion });
    const response = await fetch(`/api/reports/export?${params}`);
    const blob = await response.blob();
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'dashboard-report.pdf';
    a.click();
});

using IronPdf;
using IronPdf.Rendering;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.EnableJavaScript = true;

renderer.RenderingOptions.WaitFor.NetworkIdle0();

renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

renderer.RenderingOptions.MarginTop = 15;

renderer.RenderingOptions.MarginBottom = 15;

var pdf = renderer.RenderHtmlAsPdf(dashboardHtml);

using IronPdf;
using IronPdf.Rendering;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.EnableJavaScript = true;

renderer.RenderingOptions.WaitFor.NetworkIdle0();

renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

renderer.RenderingOptions.MarginTop = 15;

renderer.RenderingOptions.MarginBottom = 15;

var pdf = renderer.RenderHtmlAsPdf(dashboardHtml);

Imports IronPdf
Imports IronPdf.Rendering

Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.EnableJavaScript = True

renderer.RenderingOptions.WaitFor.NetworkIdle0()

renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print

renderer.RenderingOptions.MarginTop = 15

renderer.RenderingOptions.MarginBottom = 15

Dim pdf = renderer.RenderHtmlAsPdf(dashboardHtml)

[HttpGet("api/reports/export")]

public IActionResult ExportDashboard([FromQuery] ReportFilters filters)

{

    var dashboardHtml = _reportService.BuildDashboardHtml(filters);

    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.EnableJavaScript = true;

    renderer.RenderingOptions.WaitFor.NetworkIdle0();

    renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

    PdfDocument report = renderer.RenderHtmlAsPdf(dashboardHtml);

    return File(

        report.BinaryData,

        "application/pdf",

        $"KPI-Report-{filters.From:yyyyMMdd}.pdf"

    );

}

[HttpGet("api/reports/export")]

public IActionResult ExportDashboard([FromQuery] ReportFilters filters)

{

    var dashboardHtml = _reportService.BuildDashboardHtml(filters);

    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.EnableJavaScript = true;

    renderer.RenderingOptions.WaitFor.NetworkIdle0();

    renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

    PdfDocument report = renderer.RenderHtmlAsPdf(dashboardHtml);

    return File(

        report.BinaryData,

        "application/pdf",

        $"KPI-Report-{filters.From:yyyyMMdd}.pdf"

    );

}

Imports Microsoft.AspNetCore.Mvc
Imports IronPdf

<HttpGet("api/reports/export")>
Public Function ExportDashboard(<FromQuery> filters As ReportFilters) As IActionResult

    Dim dashboardHtml = _reportService.BuildDashboardHtml(filters)

    Dim renderer = New ChromePdfRenderer()

    renderer.RenderingOptions.EnableJavaScript = True

    renderer.RenderingOptions.WaitFor.NetworkIdle0()

    renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

    Dim report As PdfDocument = renderer.RenderHtmlAsPdf(dashboardHtml)

    Return File(report.BinaryData, "application/pdf", $"KPI-Report-{filters.From:yyyyMMdd}.pdf")

End Function

Korzyści w praktyce

Samoobsługa dla użytkowników biznesowych. Gdy przycisk eksportu jest aktywny, wiadomosci "czy możesz pobrac dla mnie raport?" na Slacku przestaja przychodzic. Kazdy użytkownik z dostepem do pulpitu nawigacyjnego może pobrac swoj PDF bez skladania wniosku.

Wiernosc wykresow. Poniewaz Chromium wykonuje JavaScript wewnątrz IronPDF, wykresy Chart.js, ApexCharts i Highcharts renderuja sie w PDF dokladnie tak, jak na ekranie - włączajac kolory, podpowiedzi renderowane jako statyczne etykiety i responsywne rozmiary.

Spójnosc marki. Kazdy eksportowany raport zawiera logo firmy, palete kolorow i typografie zdefiniowane w arkuszu stylow pulpitu nawigacyjnego. Nie ma potrzeby przestawiania formatowania miedzy eksportem a dystrybucja.

Planowana generacja. Polacz wywolanie renderowania z zadaniem w tle, aby automatycznie wyslac PDF-y do interesariuszy co tydzien lub miesiecznie. Zarzad otrzymuje dopracowany raport bez zadnych czynnosci recznych.

Brak zewnętrznych zależności. IronPDF działa w procesie. Nie ma potrzeby utrzymywania przy zyciu procesu Puppeteer Node.js, nie ma plików binarnych wkhtmltopdf do dołączenia dla kazdej platformy i nie ma API eksportu SaaS z ograniczeniami lub opłatami za dokument.

Uklad zoptymalizowany pod druk. CssMediaType.Print zastosowuje zasady @media print w czasie renderowania, pozwalając zdefiniowac czysty, eksporto-specyficzny uklad w CSS bez potrzeby utrzymania odrebnego szablonu HTML.

Zakończenie

Dodanie przycisku "Eksportuj do PDF" do pulpitu administratora brzmi jak mala funkcja. W praktyce eliminuje ona powtarzalne reczne zadanie, daje użytkownikom nietechnicznym możliwość, z ktorej mogli korzystać od lat, i produkuje dokument, ktory odzwierciedla, jak dane faktycznie wyglądaja, a nie przyblizona kopie z dialogu drukowania.

IronPDF obsługuje zlozonosc renderowania - wykonanie JavaScript, typy mediów CSS, przechwytywanie wykresow - wiec implementacja po twojej stronie to akcja kontrolera i szablon HTML. Jeśli chcesz przetestowac go na swoim własnym pulpicie nawigacyjnym, 30-dniowy okres próbny z pełnymi funkcjami i bez znaku wodnego jest dostępny na ironpdf.com.