1. IronPDF
  2. Poradniki
  3. Jak zrenderować plik HTML do 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 przekształca zawartość 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. Utwórz instancję klasy ChromePdfRenderer
  3. Skonfiguruj RenderingOptions, aby dostosować wyjściowy PDF
    4. RenderHtmlFileAsPdf
  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 użyciu 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ć?

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


<!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 powoduje zastosowanie reguł CSS specyficznych dla drukowania, natomiast ustawienia marginesów tworzą dokument z pełnym spadkiem. Limit czasu wynoszący 120 sekund pozwala na całkowite załadowanie złożonych plików HTML z zasobami zewnętrznymi.

50 milisekund RenderDelay gwarantuje, że wszystkie zasoby zostaną załadowane przed utworzeniem pliku 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 język obok hyphens: auto w swoim CSS, aby włączyć automatyczne dzielenie wyrazów w wygenerowanym pliku 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: W celu uzyskania lepszej wydajności 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 dostępne 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 zarządzania czcionkami.
  • Duze pliki: W przypadku plików HTML z wieloma obrazami lub skomplikówanymi 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

Jaki silnik renderujący jest używany do konwersji HTML na PDF?

IronPDF używa silnika renderującego opartego na Chrome do konwersji plików HTML na PDF. To zapewnia, że twoje treści HTML są renderowane dokładnie w PDF, pasując do tego, jak wyglądają w przeglądarce Chrome.

Jak przekonwertować plik HTML na PDF w C#?

Użyj klasy ChromePdfRenderer IronPDF z metodą RenderHtmlFileAsPdf. Po prostu podaj ścieżkę do pliku HTML jako parametr i zapisz wynik za pomocą metody SaveAs. Cała konwersja wymaga zaledwie kilku linii kodu.

Jakie funkcje HTML są obsługiwane w konwersji na PDF?

IronPDF obsługuje zaawansowane funkcje HTML, w tym CSS3, JavaScript, obrazy i czcionki. Silnik oparty na Chrome zapewnia pełną zgodność z nowoczesnymi standardami sieci podczas procesu konwersji.

Czy mogę dostosować wyjściowy PDF do nagłówków i stopki?

Tak, IronPDF pozwala na rozbudowane dostosowanie wyjściowego PDF-a. Możesz dodawać nagłówki i stopki, stosować znaki wodne, ustawiać marginesy i łączyć wiele PDF-ów. Konfiguracja RenderingOptions oferuje dokładną kontrolę nad końcowym dokumentem.

Jak mogę zapewnić, że mój HTML jest poprawnie renderowany przed konwersją na PDF?

Testuj swoje treści HTML w przeglądarce Chrome przed konwersją. Ponieważ IronPDF używa silnika renderującego opartego na Chrome, treści, które są wyświetlane poprawnie w Chrome, będą dokładnie renderowane w PDF. W przypadku precyzyjnych wymagań skorzystaj z przewodnika debugowania IronPDF, aby uzyskać renderowanie na poziomie piksela.

Jaki typ obiektu zwraca metoda konwersji?

Metoda RenderHtmlFileAsPdf zwraca obiekt PdfDocument. Ten obiekt zawiera wszystkie informacje o PDF i może być dalej manipulowany do dodatkowych operacji, takich jak dodawanie znaki wodne lub łączenie z innymi PDF-ami.

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,926,724 | Wersja: 2026.5 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.