IRONSOFTWAREHOME

Jak używać opcji renderowania w IronPDF z C#

Curtis Chau
Curtis Chau
Updated: 4 czerwca 2026

Opcje renderowania w IronPDF dostosowują generowanie PDF-ów za pomocą klasy Renderer ChromePdf, kontrolując ustawienia takie jak marginesy, nagłówki, stopki, rozmiar papieru, wykonanie JavaScript i typy mediów CSS, aby tworzyć precyzyjnie sformatowane dokumenty PDF z HTML, CSS i innych źródeł treści.

Szybki start: Zastosowanie opcji renderowania w C#
  1. Zainstaluj IronPDF za pomocą Menedżera pakietów NuGet
  2. Utwórz instancję Renderer ChromePdf
  3. Skonfiguruj opcje renderowania przez właściwość RenderingOptions
  4. Renderuj swoją treść (HTML, Markdown, itp.) do PDF
  5. Zapisz wynikowy dokument PDF
  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Skopiuj i uruchom ten fragment kodu.

    new IronPdf.Renderer ChromePdf { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaTyp = IronPdf.Rendering.PdfCssMediaTyp.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
        .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.pdf");
    C#
  3. 3Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
    arrow pointer

Opcje renderowania podczas generowania PDF to ustawienia, które określają, w jaki sposób dokument PDF jest tworzony, wyświetlany i drukowany. Te opcje obejmują renderowanie elementów formularza, włączanie JavaScript, generowanie spisów treści, dodawanie nagłówków i stopek, dopasowywanie marginesów, ustawianie rozmiarów papieru i inne.

Klasa Renderer ChromePdf w IronPDF oferuje różne opcje renderowania do dostosowywania generowania PDF. Zawiera PaperFit, menedżera, który kontroluje układ treści na stronach PDF, oferując różne style, takie jak responsywne układy CSS3 lub ciągły przepływ. Pracując z złożonymi dokumentami, możesz potrzebować połączyć lub podzielić pliki PDF po zastosowaniu opcji renderowania.


Jak używać opcji renderowania w IronPDF?

Chociaż wiele właściwości opcji renderowania jest zaprojektowanych do konwersji HTML na PDF, działają one również z innymi typami konwersji PDF. Zrenderujemy Markdown do PDF i skonfigurujemy wynik za pomocą opcji renderowania. Specjalnie dla konwersji HTML, dowiedz się o konwertowaniu plików HTML na PDF lub konwertowaniu ciągów HTML na PDF.

Dlaczego powinienem konfigurować opcje renderowania?

Konfiguracja opcji renderowania zapewnia generowanie PDF-ów zgodnie z dokładnymi specyfikacjami: niestandardowe rozmiary papieru, określone marginesy, nagłówki i stopki lub włączony JavaScript dla dynamicznej zawartości. Ta kontrola jest kluczowa przy tworzeniu nowych PDF-ów do profesjonalnych dokumentów lub raportów.

Co się dzieje, gdy zastosuję wiele opcji renderowania?

Wiele opcji renderowania współdziała, aby stworzyć końcowy wynik PDF. Każda opcja modyfikuje określony aspekt renderowania, a IronPDF stosuje je kolejno podczas konwersji. Na przykład, ustawiając zarówno marginesy, jak i nagłówki, zawartość nagłówka uwzględnia ustawienia marginesów, chyba że zostaną one nadpisane przy użyciu właściwości UseMarginsOnHeaderAndFooter.

using IronPdf;

// Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
// to render HTML/CSS as a PDF document.
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
// Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    // HTML fragment to add a header at the top of every page in the PDF.
    HtmlFragment = "<h1>Header Content</h1>"
};

// Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);

// Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0;

// Define a Markdown string that will be rendered as a PDF.
// Markdown text allows basic formatting like bold and italic styles.
string md = "This is some **bold** and *italic* text.";

// Render the Markdown string to a PDF document.
// The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf");

Przykład zaawansowanych opcji renderowania

Ten kompleksowy przykład demonstruje łączenie wielu opcji renderowania dla generacji profesjonalnych dokumentów. To podejście pomaga, gdy musisz dodać nagłówki i stopki lub pracować z niestandardowymi rozmiarami papieru:

using IronPdf;
using IronPdf.Rendering;

// Create renderer with advanced options
var renderer = new ChromePdfRenderer();

// Configure paper and layout settings
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set margins for professional layout
renderer.RenderingOptions.MarginTop = 40;    // mm
renderer.RenderingOptions.MarginBottom = 40; // mm
renderer.RenderingOptions.MarginLeft = 20;   // mm
renderer.RenderingOptions.MarginRight = 20;  // mm

// Enable JavaScript for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(2000); // Wait 2 seconds for JS to execute

// Add professional header with page numbers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    Height = 25,
    HtmlFragment = @"<div style='text-align: center; padding: 10px;'>
                     <span>Document Title</span> - Page {page} of {total-pages}
                     </div>",
    DrawDividerLine = true
};

// Add footer with timestamp
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    Height = 20,
    HtmlFragment = @"<div style='text-align: center; font-size: 10px;'>
                     Generated on {date} at {time}
                     </div>"
};

// Render HTML content
string htmlContent = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .content { padding: 20px; }
    </style>
</head>
<body>
    <div class='content'>
        <h1>Professional Document</h1>
        <p>This document demonstrates advanced rendering options.</p>
    </div>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("professional-document.pdf");
C#

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jakie są wszystkie dostępne opcje renderowania?

Zaawansowane opcje definiują ustawienia renderowania PDF, takie jak marginesy, orientacja papieru, rozmiar papieru i inne. Zrozumienie tych opcji pomaga, gdy musisz ustawić niestandardowe marginesy lub pracować z różnymi ustawieniami widoku i poziomami powiększenia.

Jakie opcje renderowania są najczęściej używane?

Najczęściej używane opcje renderowania obejmują ustawienia marginesów, konfigurację rozmiaru papieru, ustawienia nagłówka/stopki i włączanie JavaScriptu. Te opcje pokrywają większość potrzeb związanych z dostosowywaniem PDF. Dla treści internetowych, opcje renderowania JavaScript zapewniają prawidłowe renderowanie elementów dynamicznych.

Jak wybrać odpowiednie opcje renderowania?

Wybierz opcje renderowania w oparciu o swoje wymagania: użyj ustawień marginesów do układów drukowanych, włącz JavaScript dla dynamicznej zawartości internetowej, skonfiguruj nagłówki/stopki dla profesjonalnych dokumentów i dostosuj rozmiar papieru do określonych formatów wyjściowych. Pracując z treścią internetową, rozważ typy mediów CSS dla optymalnego renderowania.

Kiedy powinienem używać zaawansowanych opcji renderowania?

Używaj zaawansowanych opcji renderowania dla specjalistycznych funkcji, takich jak niestandardowe wstrzyknięcie CSS, renderowanie matematyczne LaTeX, wyjście w skali szarości lub gdy pracujesz z złożonymi aplikacjami internetowymi wymagającymi określonego czasu wykonania JavaScript. Klasa WaitFor zapewnia precyzyjną kontrolę nad opóźnieniami renderowania w skomplikowanych scenariuszach.

Praca z elementami formularza

Gdy HTML zawiera elementy formularza, IronPDF automatycznie przekształca je w interaktywne formularze PDF:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable PDF form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// HTML with form elements
string formHtml = @"
<html>
<body>
    <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>
</body>
</html>";

PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml);
pdfWithForms.SaveAs("interactive-form.pdf");

Poniżej znajduje się tabela ilustrująca różne dostępne opcje.

KlasaRenderer ChromePdf
OpisUżywane do definiowania opcji wydruku PDF, takich jak rozmiar papieru, DPI, nagłówki i stopki
Właściwości / funkcjeTypOpis
CustomCookiesDictionary<string, string>Niestandardowe pliki cookie dla renderowania HTML. Pliki cookie nie są zachowywane między renderowaniami i muszą być ustawiane za każdym razem.
PaperFitVirtualPaperLayoutManagerMenedżer do ustawiania wirtualnych układów papieru, kontrolujący, jak zawartość będzie rozmieszczana na "papierowych" stronach PDF. Obejmuje opcje dla Domyślnego Zachowania Chrome, Zoom, Responsywne Układy CSS3, Skala Do Strony i styl ustawień strony typu Ciągły Przepływ.
UseMarginsOnHeaderAndFooterUseMarginsUżyj wartości marginesów z głównego dokumentu podczas renderowania nagłówków i stopek.
CreatePdfFormsFromHtmlboolZamienia wszystkie elementy formularza HTML na edytowalne formularze PDF. Wartość domyślna to true.
CssMediaTypPdfCssMediaTypUmożliwia style CSS z Media="screen" i StyleSheets. Wartość domyślna to PdfCssMediaTyp.Screen.
CustomCssUrlciąg_znakówPozwala na zastosowanie niestandardowego arkusza stylów CSS do HTML przed renderowaniem. Może to być ścieżka do lokalnego pliku lub zdalny URL. Ma zastosowanie tylko w przypadku renderowania HTML do PDF.
Włącz JavaScriptboolUmożliwia wykonanie JavaScript i JSON przed renderowaniem strony. Idealne do drukowania z aplikacji Ajax / Angular. Wartość domyślna to false.
Włącz matematyczny LaTeXboolUmożliwia renderowanie elementów matematycznych LaTeX.
JavaScriptciąg_znakówNiestandardowy ciąg JavaScriptu, który ma być wykonany po załadowaniu całego HTML, ale przed renderowaniem PDF.
JavaScriptMessageListenerStringDelegateMetoda zwrotna wywoływana zawsze, gdy dostępna jest wiadomość konsoli JavaScript przeglądarki.
Numer pierwszej stronyintNumer pierwszej strony do użycia w nagłówkach i stopkach PDF. Wartość domyślna to 1.
Spis treściRodzaje spisów treściGeneruje spis treści w miejscu dokumentu HTML, gdzie znajdują się elementy o identyfikatorze "IronPDF-toc".
GrayScaleboolGeneruje czarno-biały PDF. Wartość domyślna to false.
TextHeaderITextHeaderFooterUstala treść stopki dla każdej strony PDF jako tekst, obsługujący 'mail-merge' i automatycznie zamieniający URL-e na hiperłącza.
TextFooter
HtmlHeaderHtmlHeaderFooterUstala treść nagłówka dla każdej strony PDF jako HTML. Obsługuje 'mail-merge'.
HtmlFooter
InputEncodingKodowanieKodowanie znaków wejściowych jako ciąg. Wartość domyślna to Encoding.UTF8.
MarginTopdoubleGórny margines "papieru" PDF w milimetrach. Ustaw na zero w przypadku aplikacji drukowania komercyjnego i bez obramowania. Wartość domyślna to 25.
MarginRightdoublePrawy margines "papieru" PDF w milimetrach. Ustaw na zero w przypadku aplikacji drukowania komercyjnego i bez obramowania. Wartość domyślna to 25.
MarginBottomdoubleDolny margines "papieru" PDF w milimetrach. Ustaw na zero w przypadku aplikacji drukowania komercyjnego i bez obramowania. Wartość domyślna to 25.
MarginLeftdoubleLewy margines "papieru" PDF w milimetrach. Ustaw na zero w przypadku aplikacji drukowania komercyjnego i bez obramowania. Wartość domyślna to 25.
Orientacja stronyPdfPaperOrientationOrientacja papieru PDF, na przykład Portretowa lub Krajobrazówa. Wartość domyślna to Portretowa.
Rozmiar papieruPdfPaperSizeUstawia rozmiar papieru
Ustaw rozmiar papieru w centymetrachdoubleUstawia rozmiar papieru w centymetrach.
SetCustomPaperSizeInInchesUstawia rozmiar papieru w całach.
Ustaw rozmiar papieru w milimetrachUstawia rozmiar papieru w milimetrach.
Ustaw rozmiar papieru w pikselach lub punktachUstawia rozmiar papieru w pikselach ekranu lub punktach drukarki.
PrintHtmlBackgroundsBooleanWskazuje, czy drukować kolory tła i obrazy z HTML. Wartość domyślna to true.
RequestContextKonteksty zapytaniaKontekst żądania dla tego renderowania, określający izolację niektórych zasobów, takich jak pliki cookie.
Limit czasuLiczba całkowitaLimit czasu renderowania w sekundach. Wartość domyślna to 60.
TytułCiąg znakówMetadane nazwy i tytułu dokumentu PDF, przydatne do korespondencji seryjnej i automatycznego nazewnictwa plików w rozszerzeniach IronPDF MVC i Razor.
ForcePaperSizeBooleanWymusza dokładnie takie wymiary stron, jakie są określone za pomocą IronPdf.ChromePdfRenderOptions.PaperSize, poprzez zmienienie rozmiaru strony po wygenerowaniu PDF z HTML. Pomaga skorygować małe błędy w rozmiarze strony podczas renderowania HTML do PDF.
WaitForWaitForObiekt opakowania, który przechowuje konfigurację mechanizmu oczekiwania na określone wydarzenia przed renderowaniem. Domyślnie nie będzie czekać na nic.

Gotowy na odkrywanie większych możliwości? Odwiedź naszą stronę z samouczkami: Konwertuj PDF-y

Często Zadawane Pytania

Czym są opcje renderowania w generowaniu PDF?

Opcje renderowania w IronPDF to ustawienia kontrolujące, jak dokumenty PDF są tworzone, wyświetlane i drukowane przez klasę ChromePdfRenderer. Zawierają one konfiguracje dla marginesów, nagłówków, stopek, rozmiaru papieru, wykonania JavaScript, typów mediów CSS, elementów formularzy i spisów treści, umożliwiając precyzyjną personalizację wyjścia PDF z HTML, CSS i innych źródeł treści.

Jak stosować opcje renderowania do PDF?

Aby stosować opcje renderowania w IronPDF: 1) Zainstaluj IronPDF przez NuGet, 2) Utwórz instancję ChromePdfRenderer, 3) Skonfiguruj ustawienia przez właściwość RenderingOptions, 4) Renderuj swoją treść (HTML, Markdown, itp.) do PDF, a 5) Zapisz wynikowy PDF. Możesz ustawiać wiele opcji w jednej linii, np. marginesy, typ mediów CSS, nagłówki i wartości timeout.

Czy mogę używać opcji renderowania z treścią inną niż HTML?

Tak, choć wiele właściwości opcji renderowania jest zaprojektowanych dla konwersji HTML do PDF, działają one również z innymi typami konwersji PDF w IronPDF. Możesz stosować opcje renderowania przy konwersji Markdown do PDF lub innych obsługiwanych formatów, dając ten sam poziom kontroli nad finalnym wyjściem PDF niezależnie od typu źródła treści.

Czym jest PaperFit i jak działa?

PaperFit jest menedżerem w klasie ChromePdfRenderer IronPDF, który kontroluje układ treści na stronach PDF. Oferuje różne style renderowania, w tym responsywne układy CSS3 lub opcje ciągłego przewijania, pomagając upewnić się, że twoja treść mieści się odpowiednio na stronach PDF według twoich konkretnych wymagań.

Dlaczego powinienem konfigurować opcje renderowania dla moich PDF-ów?

Konfigurowanie opcji renderowania w IronPDF zapewnia generowanie PDF-ów ze ścisłymi specyfikacjami potrzebnymi dla profesjonalnych dokumentów. Obejmuje to niestandardowe rozmiary papieru, specyficzne marginesy, nagłówki i stopki, lub włączony JavaScript dla dynamicznej treści. Ten poziom kontroli jest kluczowy przy tworzeniu raportów, faktur, lub jakichkolwiek dokumentów wymagających precyzyjnego formatowania.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543Wersja:2026.7właśnie wydany

Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka C# NuGet dla plików PDF
Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
  2. Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
  3. Wybierz pakiet i zainstaluj
DLL PDF dla C#
Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

  1. Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
  2. W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta