1. IronPDF
  2. Poradniki
  3. How to Render HTML File into PDF
Jak przekonwertować plik HTML do formatu PDF w języku C#

Renderowanie pliku HTML do formatu PDF w języku C# za pomocą IronPDF

Curtis Chau
Curtis Chau
Zaktualizowano:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF konwertuje pliki HTML na dokumenty PDF w języku C#, renderując je za pomocą silnika opartego na przeglądarce Chrome. Wystarczy jedno wywołanie metody, aby przekształcić dowolny dostępny plik HTML w profesjonalny plik PDF.

IronPDF renderuje każdy plik HTML, do którego komputer ma dostęp, co czyni go prostym rozwiązaniem do generowania plików PDF.

Szybki start: Konwersja pliku HTML do formatu PDF za pomocą IronPDF

Konwertuj pliki HTML na PDF za pomocą IronPDF za pomocą zaledwie kilku wierszy kodu. Klasa ChromePdfRenderer szybko przeksztalca zawartosc HTML w dokumenty PDF. Wystarczy podać ścieżkę do pliku HTML, a IronPDF zajmie się konwersją. Ten usprawniony proces sprawia, że idealnie nadaje się on do dodawania funkcji generowania plików PDF do aplikacji napisanych w języku C#.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

    new IronPdf.ChromePdfRenderer()
  .RenderHtmlFileAsPdf("path/to/your/file.html")
  .SaveAs("output.pdf");

  3. Wdrożenie do testowania w środowisku produkcyjnym

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

    arrow pointer

Minimalny proces (5 kroków)

IronPDF tutorial showing 5 steps to convert HTML to PDF in C# with NuGet installation command
  1. Pobierz bibliotekę IronPDF do konwersji HTML na PDF
  2. Instantiate the `ChromePdfRenderer` class
  3. Configure the `RenderingOptions` to fine-tune the output PDF
  4. Przekaż ścieżkę do pliku HTML do renderera
  5. Zapisz i pobierz plik PDF

Jak przekonwertować pliki HTML do formatu PDF za pomocą IronPDF?

IronPDF renderuje pliki HTML do formatu PDF przy uzyciu metody RenderHtmlFileAsPdf. Parametr to ścieżka do lokalnego pliku HTML.

Ta metoda pozwala programistom na testowanie treści HTML w przeglądarce podczas tworzenia aplikacji. Przed konwersją mogą oni zweryfikować wierność renderowania. Zalecamy korzystanie z przeglądarki Chrome, ponieważ silnik renderujący IronPDF jest oparty właśnie na tej przeglądarce.

Jeśli treść wyświetla się poprawnie w przeglądarce Chrome, zostanie ona poprawnie wyrenderowana w IronPDF. Aby poznać dokładne wymagania dotyczące renderowania, zapoznaj się z naszym przewodnikiem dotyczącym debugowania HTML w przeglądarce Chrome, aby upewnić się, że pliki PDF spełniają Twoje oczekiwania.

Jakie treści HTML mogę konwertować?

To jest plik HTML example.html, który kod renderuje:


<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>


<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>
HTML

Poniżej wyświetlono plik HTML wygenerowany w sieci.

IronPDF obsługuje zaawansowane funkcje HTML, w tym CSS3, JavaScript, obrazy i czcionki. Dowiedz się więcej o opcjach renderowania, aby dostosować plik PDF do swoich potrzeb, dodając nagłówki, stopki, marginesy i inne elementy.

Jak zaimplementować konwersję w języku C#?

:path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf.cs
using IronPdf;
using IronPdf.Engines.Chrome;
using IronPdf.Rendering;


var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        CssMediaType = PdfCssMediaType.Print,
        MarginBottom = 0,
        MarginLeft = 0,
        MarginRight = 0,
        MarginTop = 0,
        Timeout = 120,
    },
};
renderer.RenderingOptions.WaitFor.RenderDelay(50);

// Create a PDF from an existing HTML file using C#
var pdf = renderer.RenderHtmlFileAsPdf("example.html");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf
Imports IronPdf.Engines.Chrome
Imports IronPdf.Rendering


Private renderer = New ChromePdfRenderer With {
	.RenderingOptions = New ChromePdfRenderOptions With {
		.CssMediaType = PdfCssMediaType.Print,
		.MarginBottom = 0,
		.MarginLeft = 0,
		.MarginRight = 0,
		.MarginTop = 0,
		.Timeout = 120
	}
}
renderer.RenderingOptions.WaitFor.RenderDelay(50)

' Create a PDF from an existing HTML file using C#
Dim pdf = renderer.RenderHtmlFileAsPdf("example.html")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

Metoda RenderHtmlFileAsPdf zwraca obiekt PdfDocument, który zawiera informacje o pliku PDF. Możesz dalej modyfikować ten obiekt — na przykład dodać nagłówki i stopki, zastosować znaki wodne lub połączyć wiele plików PDF w jeden dokument.

Opcje renderowania pozwalają dostosować wygląd wynikowego tekstu. Ustawienie CssMediaType na Print stosuje reguly CSS specyficzne dla druku, podczas gdy ustawienia marginesów tworza dokument na pelna szerokosc. Limit czasu wynoszący 120 sekund pozwala na całkowite załadowanie złożonych plików HTML z zasobami zewnętrznymi.

50-milisekundowy RenderDelay zapewnia, ze wszystkie zasoby zaladuja sie przed utworzeniem PDF. Pomaga to w przypadku stron zawierających dużo kodu JavaScript. W przypadku złożonych scenariuszy z treścią dynamiczną zapoznaj się z naszym przewodnikiem dotyczącym renderowania JavaScript.

Jak wygląda ostateczny plik PDF?

Oto plik PDF wygenerowany przez kod:

Jak mogę korzystać z domyślnych ustawień drukowania w przeglądarce Chrome?

Aby skorzystać z domyślnych opcji drukowania przeglądarki Chrome, należy uzyskać dostęp do właściwości DefaultChrome klasy ChromePdfRenderOptions i przypisać ją do RenderingOptions. Przy tych ustawieniach wynik IronPDF dokładnie odpowiada podglądowi wydruku w przeglądarce Chrome.

:path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf-default-chrome.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure the rendering options to default Chrome options
renderer.RenderingOptions = ChromePdfRenderOptions.DefaultChrome;
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Configure the rendering options to default Chrome options
renderer.RenderingOptions = ChromePdfRenderOptions.DefaultChrome
$vbLabelText   $csharpLabel

Domyślne ustawienia przeglądarki Chrome sprawdzają się dobrze, gdy chcesz, aby pliki PDF odpowiadały temu, co widzą użytkownicy podczas drukowania z przeglądarki. To podejście automatycznie obsługuje typowe ustawienia drukowania, takie jak podziały stron, formatowanie nagłówków i stopek oraz standardowe marginesy.

Dodatkowe opcje konwersji

IronPDF oferuje kilka powiązanych funkcji, które usprawniają procesy tworzenia plików PDF:

  • Konwersja z ciągów znaków HTML: Dynamiczne generowanie kodu HTML i konwersja ciągów znaków HTML bezpośrednio do formatu PDF bez konieczności uprzedniego zapisywania w pliku.
  • URL do PDF: Konwertuj aktywne strony internetowe, korzystając z naszego przewodnika dotyczącego konwersji adresów URL do formatu PDF.
  • Archiwa ZIP HTML: W przypadku złożonych projektów z wieloma zasobami dowiedz się, jak konwertować pliki ZIP HTML do formatu PDF.
  • Niestandardowe dzielenie wyrazów: ChromePdfRenderOptions obsługuje dzielenie wyrazów za pomocą właściwości HyphenationLanguage. Ustaw go na konkretny jezyk wraz z hyphens: auto w CSS, aby umozliwic automatyczne dzielenie wyrazów w generowanym PDF. W zaawansowanych przypadkach właściwość CustomHyphenation akceptuje niestandardowe wzorce dzielenia wyrazów, które mają pierwszeństwo przed opcją opartą na języku.

Kwestie związane z wydajnością

Podczas konwersji plików HTML do formatu PDF w środowiskach produkcyjnych należy wziąć pod uwagę następujące optymalizacje:

  1. Operacje asynchroniczne: Należy stosować asynchroniczne metody generowania plików PDF w celu uzyskania lepszej responsywności aplikacji.
  2. Buforowanie: Buforuj wynikowe pliki PDF podczas wielokrotnej konwersji tego samego pliku HTML, aby uniknąć powtarzającego się renderowania.
  3. Zarządzanie zasobami: Zawsze usuwaj obiekty PdfDocument po zakończeniu pracy, aby zwolnić zasoby pamięci.
  4. Przetwarzanie wsadowe: Aby uzyskać lepszą wydajność, podczas konwersji wielu plików należy ponownie wykorzystać tę samą instancję ChromePdfRenderer.

Rozwiązywanie typowych problemów

Jeśli napotkasz problemy podczas konwersji HTML do PDF, wypróbuj następujące rozwiązania:

  • Brakujace zasoby: Upewnij sie, ze wszystkie pliki CSS, JavaScript i obrazy odwolane w HTML sa dostepne z lokalizacji pliku.
  • Renderowanie czcionek: Aby zapewnic spójne renderowanie czcionek na róznych systemach, osadz czcionki w HTML lub zapoznaj sie z naszym przewodnikiem zarzadzania czcionkami.
  • Duze pliki: W przypadku plików HTML z wieloma obrazami lub skomplikowanymi ukladami, skorzystaj z technik kompresji PDF w celu zmniejszenia rozmiaru pliku.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Konwersja PDF-ów

Często Zadawane Pytania

What rendering engine does the HTML to PDF conversion use?

IronPDF uses a Chrome-based rendering engine to convert HTML files to PDF. This ensures that your HTML content renders accurately in the PDF, matching how it appears in Chrome browser.

How do I convert an HTML file to PDF in C#?

Use IronPDF's ChromePdfRenderer class with the RenderHtmlFileAsPdf method. Simply pass your HTML file path as a parameter and save the output using the SaveAs method. The entire conversion requires just a few lines of code.

What HTML features are supported in the PDF conversion?

IronPDF supports advanced HTML features including CSS3, JavaScript, images, and fonts. The Chrome-based engine ensures full compatibility with modern web standards during the conversion process.

Can I customize the PDF output with headers and footers?

Yes, IronPDF allows extensive customization of PDF output. You can add headers and footers, apply watermarks, set margins, and merge multiple PDFs. The RenderingOptions configuration provides fine-tuned control over the final document.

How can I ensure my HTML renders correctly before converting to PDF?

Test your HTML content in Chrome browser before conversion. Since IronPDF uses a Chrome-based rendering engine, content that displays correctly in Chrome will render accurately in the PDF. For precise requirements, use IronPDF's debugging guide for pixel-perfect rendering.

What object type does the conversion method return?

The RenderHtmlFileAsPdf method returns a PdfDocument object. This object contains all PDF information and can be manipulated further for additional operations like adding watermarks or merging with other PDFs.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
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ę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.