Jak scalać pliki PDF w .NET

Jak wygląda wygenerowany plik PDF?

Klasa ChromePdfRenderer obsługuje wszystkie złożone operacje renderowania, zapewniając prawidłowe wyświetlenie struktury HTML, stylów CSS, a nawet kodu JavaScript w końcowym pliku PDF. Zwracana wartosc to obiekt PdfDocument, ktorego wlasciwosc BinaryData moze byc przesylana bezposrednio do przegladarki jako pobranie pliku.

Jak konwertować dynamiczne ciągi znaków HTML?

Pracujac z dynamiczna zawartoscia, taka jak raporty oparte na bazach danych, uzyj RenderHtmlAsPdf, aby bezposrednio przeksztalcic ciagi HTML. Ta metoda akceptuje dowolny poprawny kod HTML i zwraca w pełni wyrenderowany plik PDF:

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = BuildDynamicHtml() ' your method to generate HTML
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("dynamic-report.pdf")

To podejście sprawdza się dobrze przy generowaniu dokumentów PDF z szablonów HTML wypełnionych danymi w czasie rzeczywistym, przesłanymi formularzami lub dowolną treścią generowaną dynamicznie. Silnik renderujący zachowuje wszystkie style CSS, w tym niestandardowe czcionki, kolory i formatowanie tabel. Gdy twoj HTML odnosi sie do zewnetrznych arkuszy stylow lub obrazow uzywajac sciezek wzglednych, przekaż baseUrl jako drugi argument, aby renderer mógl poprawnie rozwiazac te zasoby.

Jak konwertować statyczne pliki HTML z dysku?

Dla szablonow HTML przechowywanych jako pliki fizyczne, uzyj RenderHtmlFileAsPdf, aby przeksztalcic je bez ladowania do pamieci. Jest to wydajne dla duzych szablonow i unika laczenia ciagow:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html")
pdf.SaveAs("report.pdf")

Ta metoda automatycznie rozpoznaje ścieżki względne dla arkuszy stylów CSS, obrazów i innych zasobów zewnętrznych, do których odwołuje się plik. Działa to dobrze, gdy zespół projektantów przechowuje oddzielne pliki szablonów HTML poza kodem źródłowym aplikacji napisanym w języku C#. Metoda obsługuje zapytania o media drukarskie CSS oraz niestandardowe czcionki, dzięki czemu szablony stworzone dla środowisk drukarskich są wiernie renderowane bez dodatkowej konfiguracji.

Jak przekonwertować adres URL strony internetowej na plik PDF?

Aby uchwycic strone internetowa na zywo lub wyrenderowac strone dostepna przez URL jako PDF, uzyj RenderUrlAsPdf. Ta metoda uruchamia silnik Chrome, przechodzi do adresu URL, czeka na pełne załadowanie strony, a następnie przechwytuje wyrenderowany wynik:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(1000)
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
Dim pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")
pdf.SaveAs("webpage.pdf")

Opcja WaitFor.RenderDelay nakazuje rendererowi zatrzymanie sie po zaladowaniu strony przed przechwyceniem. Jest to przydatne w przypadku aplikacji jednostronicowych, które budują swój DOM za pomocą JavaScript po otrzymaniu początkowej odpowiedzi HTML. Ustawienie EnableJavaScript = true aktywuje pelny silnik JavaScript w Chrome, dzięki czemu wykresy, tabele danych i inne komponenty renderowane w JavaScript pojawiaja sie w PDF tak jak w przegladarce.

Jak wygląda interfejs formularza?

Jak dane formularza pojawiają się w wygenerowanym pliku PDF?

W przypadku bardziej zaawansowanych scenariuszy dokumentów można zintegrować formularze PDF lub edytować istniejące szablony PDF z wstępnie wypełnionymi polami. Biblioteka obsługuje również podpisy cyfrowe dla dokumentów prawnych i umów, umożliwiając dodawanie podpisów weryfikowalnych kryptograficznie do każdego wygenerowanego dokumentu.

Ważną kwestią przy osadzaniu danych użytkownika w ciągach HTML jest ich oczyszczanie. Zawsze należy stosować escape w ciągach znaków dostarczonych przez użytkownika przed wstawieniem ich do kodu HTML, aby zapobiec problemom związanym z wstrzyknięciem kodu. Proste wywolanie System.Web.HttpUtility.HtmlEncode(model.CustomerName) na kazdym polu zachowuje bezpieczenstwo szablonu przed przekazaniem go do renderer'a.

Jak skonfigurować nagłówki, stopki i znaki wodne?

Profesjonalne dokumenty PDF często wymagają nagłówków i stopek na każdej stronie, a także znaków wodnych w przypadku dokumentów roboczych lub poufnych. IronPDF obsluguje oba przypadki za posrednictwem wlasciwosci obiektu RenderingOptions oraz metody ApplyWatermark na wynikowym PdfDocument:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .MaxHeight = 20,
    .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
}
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>", 30, VerticalAlignment.Middle, HorizontalAlignment.Center)
pdf.SaveAs("report-with-watermark.pdf")

Zastepcze miejsca {page} i {total-pages} w stopce HTML sa automatycznie zastapiane podczas renderowania, wiec otrzymujesz poprawne numery stron bez zadnej dalszej obrobki. Można również dodać numery stron, obrazy tła lub nakładki na pierwszym planie oraz niestandardowe tekstowe lub graficzne stemple.

Jak korzystać z CSS Print Media do sterowania układem plików PDF?

Aby upewnic sie, ze twoj PDF odpowiada oczekiwaniom, uzyj reguly CSS @media print oraz ustawienia PdfCssMediaType.Print. IronPDF w pełni obsługuje kontrolę podziału stron i niestandardowe rozmiary papieru:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
renderer.RenderingOptions.ViewPortWidth = 1024
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10
renderer.RenderingOptions.MarginLeft = 10
renderer.RenderingOptions.MarginRight = 10

Dim html As String = "
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)

Zastosowanie CSS do drukowania gwarantuje, że dokumenty PDF zachowają profesjonalne formatowanie, jednocześnie ukrywając zbędne elementy stron internetowych, takie jak menu nawigacyjne czy interaktywne przyciski. Ustawienie CssMediaType = PdfCssMediaType.Print instruuje renderer do zastosowania twoich reguł @media print zamiast ekranowych stylow, co zazwyczaj usuwa dekoracje tla i dostosowuje typografie dla wydruku. Można również skonfigurować niestandardowe marginesy dla każdej strony oraz kontrolować orientację i obrót strony w przypadku raportów w formacie szerokim lub obróconych.

Specyfikacja W3C CSS Paged Media definiuje jak wlasciwosci takie jak @page, page-break-before i widows powinny zachowywac sie w wyjsciu stronowym. Silnik IronPDF dla przeglądarki Chrome ściśle przestrzega tej specyfikacji, dzięki czemu style napisane zgodnie ze standardem CSS są dokładnie przekładane do pliku PDF bez konieczności ręcznych poprawek.