PDF API dla .NET: Twórz, edytuj i zabezpieczaj dokumenty za pomocą IronPDF

Wynik

Zrozumienie architektury ChromePdfRenderer pomoże Ci w pełni wykorzystać możliwości tego interfejsu API PDF. Renderer utrzymuje własną instancję Chromium, zapewniając spójne renderowanie niezależnie od konfiguracji przeglądarki systemu hosta. Ta izolacja zapewnia przewidywalne wyniki w różnych środowiskach wdrożeniowych, jednocześnie obsługując najnowsze standardy internetowe, w tym HTML5, CSS3 i nowoczesny JavaScript.

Konwersja ciągów znaków HTML do formatu PDF

Bezpośrednia konwersja ciągów znaków HTML jest przydatna podczas generowania dokumentów dynamicznych na podstawie szablonów lub programowego tworzenia plików PDF. Przekazujesz dowolny ciąg HTML do RenderHtmlAsPdf, a renderer stosuje wbudowane CSS, obsługuje elementy zagnieżdżone i zachowuje złożone struktury, takie jak tabele i treści multimedialne. Silniki szablonów mogą dynamicznie generować kod HTML, włączając dane z baz danych lub interfejsów API przed konwersją. Takie podejście zapewnia pełną kontrolę nad strukturą i stylem bez konieczności stosowania plików pośrednich.

Tworzenie plików PDF z adresów URL

Konwersja stron internetowych do formatu PDF umożliwia przechwytywanie istniejących treści internetowych lub generowanie dokumentów z aplikacji internetowych. Użyj RenderUrlAsPdf, aby załadować całą stronę internetową — renderer wykonuje kod JavaScript, czeka na wyrenderowanie treści i uwzględnia zapytania o media CSS, dzięki czemu układy zoptymalizowane pod kątem druku są stosowane automatycznie. Jest to przydatne do konwersji istniejących raportów internetowych do formatu PDF, przechwytywania stanów pulpitów nawigacyjnych lub archiwizacji treści internetowych. Więcej szczegółów można znaleźć w przewodniku "URL to PDF".

Wynik

Praca z plikami HTML

Konwersja oparta na plikach upraszcza przepływ pracy w sytuacjach, gdy szablony HTML znajdują się w systemie plików. Użyj RenderHtmlFileAsPdf, aby załadować plik HTML wraz z odwołanymi zasobami — plikami CSS, obrazami i skryptami. Ścieżki względne w HTML są rozpoznawane poprawnie, zachowując relacje struktury plików. Organizacje często stosują to podejście w przypadku szablonów HTML podlegających kontroli wersji, oddzielając projekt dokumentu od logiki aplikacji. Szczegółowe wytyczne można znaleźć w dokumentacji dotyczącej konwersji plików HTML do formatu PDF.

Ustawienia strony i marginesy

Kontrola układu strony gwarantuje, że dokumenty spełniają określone wymagania dotyczące formatowania. Właściwość PaperSize obsługuje standardowe formaty, takie jak A4, Letter i Legal, a także niestandardowe wymiary dostosowane do specjalistycznych wymagań. PaperOrientation przełącza między trybem pionowym a poziomym. Ustawienia marginesów ze wszystkich czterech stron zapewniają spójne odstępy wokół treści, co jest niezbędne dla profesjonalnego wyglądu. Dostęp do nich można uzyskać poprzez renderer.RenderingOptions.PaperSize, renderer.RenderingOptions.PaperOrientation oraz renderer.RenderingOptions.MarginTop/Bottom/Left/Right.

Wynik

Nagłówki i stopki

Profesjonalne dokumenty często wymagają spójnych nagłówków i stopek na wszystkich stronach:

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Confidential Report",
    RightText = "{date}",
    DrawDividerLine = true
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "© 2025 Company Name",
    CenterText = "Page {page} of {total-pages}"
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Headers</h1>");
pdf.SaveAs("headed-document.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Confidential Report",
    RightText = "{date}",
    DrawDividerLine = true
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "© 2025 Company Name",
    CenterText = "Page {page} of {total-pages}"
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Headers</h1>");
pdf.SaveAs("headed-document.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "Confidential Report",
    .RightText = "{date}",
    .DrawDividerLine = True
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .LeftText = "© 2025 Company Name",
    .CenterText = "Page {page} of {total-pages}"
}
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Document with Headers</h1>")
pdf.SaveAs("headed-document.pdf")

Nagłówki i stopki obsługują zarówno zwykły tekst, jak i zawartość HTML z polami scalania dla wartości dynamicznych. Tokeny {page} i {total-pages} są automatycznie wypełniane numerami stron, natomiast {date} wstawia bieżącą datę. Linie oddzielające zapewniają wizualne oddzielenie nagłówków od głównej treści. Elementy te zapewniają spójne pozycjonowanie na wszystkich stronach. Więcej informacji znajdziesz w przewodniku dotyczącym nagłówków i stopek w plikach PDF.

Typy mediów CSS i obsługa JavaScript

Nowoczesne aplikacje internetowe często wymagają wykonywania kodu JavaScript i prawidłowej obsługi mediów CSS podczas konwersji:

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500);
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
pdf.SaveAs("dynamic.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500);
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
pdf.SaveAs("dynamic.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(500)
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/")
pdf.SaveAs("dynamic.pdf")

Ustawienie CssMediaType określa, które reguły CSS mają zastosowanie podczas renderowania. Typ mediów ekranowych zachowuje wygląd strony internetowej, natomiast typ mediów PRINT stosuje style specyficzne dla druku. Obsługa JavaScript umożliwia dynamiczne generowanie treści, co ma kluczowe znaczenie dla nowoczesnych aplikacji jednostronicowych. Opóźnienie renderowania zapewnia, że treści asynchroniczne zostaną całkowicie załadowane przed rozpoczęciem generowania. Opcje te wypełniają lukę między interaktywnymi aplikacjami internetowymi a statycznymi plikami PDF.

Wynik

Tworzenie i edycja formularzy

IronPDF automatycznie konwertuje elementy formularzy HTML na interaktywne formularze PDF. Ta funkcja upraszcza przepływ pracy z dokumentami, tworząc pliki PDF z możliwością wypełniania bezpośrednio z HTML. Pola formularza umożliwiają gromadzenie danych bez konieczności drukowania:

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
string formHtml = @"
    <form>
        <label>Name: <input type='text' name='name' /></label><br/>
        <label>Email: <input type='email' name='email' /></label><br/>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br/>
        <button type='submit'>Submit</button>
    </form>";
var pdf = renderer.RenderHtmlAsPdf(formHtml);
pdf.SaveAs("interactive-form.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
string formHtml = @"
    <form>
        <label>Name: <input type='text' name='name' /></label><br/>
        <label>Email: <input type='email' name='email' /></label><br/>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br/>
        <button type='submit'>Submit</button>
    </form>";
var pdf = renderer.RenderHtmlAsPdf(formHtml);
pdf.SaveAs("interactive-form.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CreatePdfFormsFromHtml = True
Dim formHtml As String = "
    <form>
        <label>Name: <input type='text' name='name' /></label><br/>
        <label>Email: <input type='email' name='email' /></label><br/>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br/>
        <button type='submit'>Submit</button>
    </form>"
Dim pdf = renderer.RenderHtmlAsPdf(formHtml)
pdf.SaveAs("interactive-form.pdf")

Ta funkcja zachowuje funkcjonalność formularzy w plikach PDF, umożliwiając użytkownikom wypełnianie pól formularzy bezpośrednio w czytnikach PDF. Pola tekstowe, pola wyboru, przyciski opcji i menu rozwijane są konwertowane na odpowiedniki w formularzu PDF. Powstałe formularze działają w standardowych czytnikach PDF, umożliwiając gromadzenie danych bez konieczności drukowania i skanowania dokumentów przez użytkowników. Można również eksportować dane z formularzy lub programowo wyodrębniać tekst z formularzy w celu dalszego przetwarzania.

Bezpieczeństwo i szyfrowanie

Ochrona poufnych dokumentów wymaga silnych zabezpieczeń. IronPDF zapewnia kompleksowe opcje bezpieczeństwa umożliwiające ograniczenie dostępu do dokumentów i uprawnień:

using IronPdf;

var pdf = new PdfDocument("document.pdf");
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserFormData = true;
pdf.SaveAs("secured-document.pdf");

using IronPdf;

var pdf = new PdfDocument("document.pdf");
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserFormData = true;
pdf.SaveAs("secured-document.pdf");

Imports IronPdf

Dim pdf As New PdfDocument("document.pdf")
pdf.SecuritySettings.UserPassword = "user123"
pdf.SecuritySettings.OwnerPassword = "owner456"
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserFormData = True
pdf.SaveAs("secured-document.pdf")

Hasła użytkowników kontrolują otwieranie dokumentów, natomiast hasła właścicieli zarządzają zmianami uprawnień. Szczegółowe uprawnienia kontrolują możliwości drukowania, kopiowania, edycji i wypełniania formularzy. Funkcje te zapewniają zgodność z wymogami dotyczącymi ochrony danych i zapobiegają nieuprawnionym manipulacjom. Szyfrowanie wykorzystuje algorytmy zgodne ze standardami branżowymi, zapewniając silną ochronę wrażliwych treści. Więcej opcji znajdziesz w dokumentacji dotyczącej zabezpieczeń w formacie PDF.

Wynik

Edycja i scalanie dokumentów

IronPDF umożliwia edycję istniejących dokumentów PDF w projektach .NET:

using IronPdf;

var pdf1 = PdfDocument.FromFile("report1.pdf");
var pdf2 = PdfDocument.FromFile("report2.pdf");
// Merge PDF documents
pdf1.AppendPdf(pdf2);
// Add watermark
pdf1.ApplyWatermark("<h2>CONFIDENTIAL</h2>", rotation: 45, opacity: 50);
// Extract pages
var extracted = pdf1.CopyPages(0, 2);
extracted.SaveAs("first-three-pages.pdf");
pdf1.SaveAs("combined-report.pdf");

using IronPdf;

var pdf1 = PdfDocument.FromFile("report1.pdf");
var pdf2 = PdfDocument.FromFile("report2.pdf");
// Merge PDF documents
pdf1.AppendPdf(pdf2);
// Add watermark
pdf1.ApplyWatermark("<h2>CONFIDENTIAL</h2>", rotation: 45, opacity: 50);
// Extract pages
var extracted = pdf1.CopyPages(0, 2);
extracted.SaveAs("first-three-pages.pdf");
pdf1.SaveAs("combined-report.pdf");

Imports IronPdf

Dim pdf1 = PdfDocument.FromFile("report1.pdf")
Dim pdf2 = PdfDocument.FromFile("report2.pdf")
' Merge PDF documents
pdf1.AppendPdf(pdf2)
' Add watermark
pdf1.ApplyWatermark("<h2>CONFIDENTIAL</h2>", rotation:=45, opacity:=50)
' Extract pages
Dim extracted = pdf1.CopyPages(0, 2)
extracted.SaveAs("first-three-pages.pdf")
pdf1.SaveAs("combined-report.pdf")

Funkcje manipulacji dokumentami umożliwiają realizację złożonych procesów bez konieczności korzystania z narzędzi zewnętrznych. Funkcja scalania łączy wiele plików w jeden dokument, co jest przydatne przy tworzeniu raportów lub pakietów dokumentów. Znak wodny dodaje nakładki tekstowe lub graficzne w celach brandingowych lub bezpieczeństwa, z możliwością kontroli przezroczystości i obrotu. Funkcja wyodrębniania stron tworzy nowe dokumenty na podstawie istniejących zakresów stron, ułatwiając dzielenie dokumentów lub selektywne udostępnianie. Operacje te pozwalają zachować jakość dokumentu podczas całego procesu przetwarzania. Więcej informacji znajdziesz w przewodniku po scalaniu plików PDF.

Jak zoptymalizować kod HTML pod kątem generowania plików PDF?

Dobrze skonstruowany kod HTML zapewnia lepsze wyniki w formacie PDF. Należy używać semantycznych elementów HTML w celu stworzenia logicznej struktury dokumentu. W tabelach należy stosować odpowiednie elementy thead, tbody i tfoot, aby zapewnić spójne wyświetlanie na wszystkich stronach. W miarę możliwości należy unikać pozycjonowania absolutnego, ponieważ układy względne lepiej dostosowują się do granic strony. Należy uwzględnić reguły CSS specyficzne dla wydruku w celu optymalizacji wyglądu:

using IronPdf;

string optimizedHtml = @"
    <style>
        @media print {
            .no-print { display: none; }
            .page-break { page-break-after: always; }
        }
        table { border-collapse: collapse; width: 100%; }
        th, td { border: 1px solid #ddd; padding: 8px; }
    </style>
    <div class='content'>
        <h1>Optimized Report</h1>
        <table>
            <thead><tr><th>Item</th><th>Value</th></tr></thead>
            <tbody><tr><td>Sales</td><td>$1,000</td></tr></tbody>
        </table>
        <div class='page-break'></div>
        <h2>Next Section</h2>
    </div>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(optimizedHtml);
pdf.SaveAs("optimized-report.pdf");

using IronPdf;

string optimizedHtml = @"
    <style>
        @media print {
            .no-print { display: none; }
            .page-break { page-break-after: always; }
        }
        table { border-collapse: collapse; width: 100%; }
        th, td { border: 1px solid #ddd; padding: 8px; }
    </style>
    <div class='content'>
        <h1>Optimized Report</h1>
        <table>
            <thead><tr><th>Item</th><th>Value</th></tr></thead>
            <tbody><tr><td>Sales</td><td>$1,000</td></tr></tbody>
        </table>
        <div class='page-break'></div>
        <h2>Next Section</h2>
    </div>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(optimizedHtml);
pdf.SaveAs("optimized-report.pdf");

Imports IronPdf

Dim optimizedHtml As String = "
    <style>
        @media print {
            .no-print { display: none; }
            .page-break { page-break-after: always; }
        }
        table { border-collapse: collapse; width: 100%; }
        th, td { border: 1px solid #ddd; padding: 8px; }
    </style>
    <div class='content'>
        <h1>Optimized Report</h1>
        <table>
            <thead><tr><th>Item</th><th>Value</th></tr></thead>
            <tbody><tr><td>Sales</td><td>$1,000</td></tr></tbody>
        </table>
        <div class='page-break'></div>
        <h2>Next Section</h2>
    </div>"

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(optimizedHtml)
pdf.SaveAs("optimized-report.pdf")

Ta struktura HTML zawiera zapytania o media PRINT, prawidłowe formatowanie tabel oraz wyraźne podziały stron. CSS zapewnia spójną stylistykę, a struktura semantyczna poprawia dostępność i niezawodność renderowania. Elementy sterujące podziałem stron zapewniają precyzyjną kontrolę nad przepływem treści między stronami.

Wynik

Obsługa złożonych układów

Złożone układy graficzne wymagają szczególnej uwagi w zakresie renderowania. Ustaw odpowiednie szerokości okna wyświetlania, aby kontrolować punkty przełamania w responsywnym projekcie. Użyj opcji FitToPaper, aby odpowiednio dostosować długość treści. W przypadku układów wielokolumnowych warto rozważyć użycie kolumn CSS zamiast elementów float lub flexbox, aby uzyskać lepszy przepływ strony. Przetestuj układy z różną ilością treści, aby zapewnić spójny wygląd.

W przypadku pracy z dużymi dokumentami należy rozważyć optymalizację rozmiaru plików. Kompresuj obrazy przed osadzeniem ich w HTML, używaj czcionek systemowych tam, gdzie to możliwe, i unikaj niepotrzebnych zasobów osadzonych. Duże pliki PDF mogą wpływać zarówno na czas generowania, jak i na wrażenia użytkownika końcowego.

Kwestie związane z wdrożeniem

IronPDF obsługuje różne scenariusze wdrożenia, w tym usługi Windows, aplikacje internetowe, kontenery Docker i platformy chmurowe. Biblioteka zawiera natywne zależności, które muszą być obecne w środowisku wdrożeniowym. W przypadku wdrożeń w systemie Linux upewnij się, że zainstalowano wymagane pakiety. Wdrożenia Docker korzystają z oficjalnych obrazów bazowych, które zawierają niezbędne zależności.

Wdrożenia kontenerowe wymagają szczególnej uwagi w zakresie dostępności czcionek. Dodaj niestandardowe czcionki do obrazu kontenera lub konsekwentnie odwołuj się do czcionek systemowych. Silnik renderujący Chrome dostosowuje się do dostępnych zasobów systemowych, ale odpowiedni przydział pamięci poprawia wydajność w przypadku złożonych dokumentów. Generowanie plików PDF po stronie serwera korzysta z odpowiedniego zarządzania zasobami i strategii buforowania.

IronPDF obsługuje również standardy dostępności, zapewniając zgodność generowanych plików PDF z wymaganiami sekcji 508. W przypadku problemów z wdrożeniem tag IronPDF na Stack Overflow zapewnia rozwiązania opracowane przez społeczność. Przewodnik IronPDF dotyczący kompatybilności międzyplatformowej szczegółowo omawia wdrażanie w systemie Linux i Docker. W celu optymalizacji wydajności w scenariuszach o dużej przepustowości wytyczne Microsoftu dotyczące wydajności platformy .NET zawierają istotne informacje na temat zarządzania pamięcią i wzorców asynchronicznych, które mają zastosowanie do generowania dokumentów po stronie serwera.