Konwersja HTML do PDF jest częstym wymaganiem w wielu aplikacjach, takich jak generowanie raportów, faktur lub zapisywanie stron internetowych jako plików PDF. W tym artykułe przyjrzymy się trzem popularnym bibliotekom open source do konwersji HTML na PDF w języku C#, omówimy ich mocne strony i ograniczenia oraz wyjaśnimy, dlaczego IronPDF jest lepszą alternatywą w wielu przypadkach.
PuppeteerSharp to nakładka .NET dla Puppeteer, bezinterfejsowej przeglądarki opartej na silniku Chromium. Umożliwia programistom konwersję dokumentów HTML do formatu PDF dzięki wykorzystaniu silnika renderującego Chromium.
PuppeteerSharp zapewnia precyzyjną kontrolę nad procesem renderowania. Oto przykład:
using PuppeteerSharp;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
// Download Chromium to ensure compatibility with PuppeteerSharp
await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultChromiumRevision);
// Launch a headless instance of Chromium browser
using (var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true }))
{
// Open a new browser page
var page = await browser.NewPageAsync();
// Set the HTML content for the page
await page.SetContentAsync("<html><body><h1>Hello, PuppeteerSharp!</h1></body></html>");
// Generate a PDF from the rendered HTML content
await page.PdfAsync("output.pdf");
Console.WriteLine("PDF Generated Successfully!");
}
}
}Imports PuppeteerSharp
Imports System.Threading.Tasks
Friend Class Program
Shared Async Function Main(ByVal args() As String) As Task
' Download Chromium to ensure compatibility with PuppeteerSharp
Await (New BrowserFetcher()).DownloadAsync(BrowserFetcher.DefaultChromiumRevision)
' Launch a headless instance of Chromium browser
Using browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {.Headless = True})
' Open a new browser page
Dim page = Await browser.NewPageAsync()
' Set the HTML content for the page
Await page.SetContentAsync("<html><body><h1>Hello, PuppeteerSharp!</h1></body></html>")
' Generate a PDF from the rendered HTML content
Await page.PdfAsync("output.pdf")
Console.WriteLine("PDF Generated Successfully!")
End Using
End Function
End ClassPobierz Chromium: PuppeteerSharp automatycznie pobiera wymaganą wersję Chromium, aby zapewnić kompatybilność.
Uruchomienie przeglądarki: Uruchom bezgłową instancję Chromium przy użyciu Puppeteer.LaunchAsync().
Ustawienie zawartości HTML: Załaduj żądany HTML do strony przeglądarki używając page.SetContentAsync().
Generowanie PDF: Użyj metody page.PdfAsync(), aby wygenerować PDF z wyrenderowanej zawartości.
Rezultatem jest wysokiej jakości PDF (output.pdf), który dokładnie odtwarza strukturę i design HTML.
PDFSharp to potężna biblioteka open-source do tworzenia i manipulacji plikami PDF w C#. Chociaż nie obsługuje bezpośrednio renderowania HTML, doskonale sprawdza się w dostarczaniu programistom narzędzi do programowego generowania i edycji dokumentów PDF.
Tworzenie PDF: PDFSharp pozwala deweloperom generować nowe pliki PDF od zera poprzez definiowanie rozmiarów stron, dodawanie tekstu, kształtów, obrazów i więcej.
Modyfikacja istniejących plików PDF: Można modyfikować istniejące dokumenty PDF, np. łączyć je, dzielić lub wyodrębniać zawartość.
Możliwości Rysowania: PDFSharp zapewnia solidne możliwości graficzne w celu dodawania własnych projektów do plików PDF przy użyciu klasy XGraphics.
Lekkość: Jest to lekka biblioteka, co czyni ją idealną do projektów, w których priorytetami są prostota i szybkość.
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using HtmlAgilityPack;
class Program
{
static void Main(string[] args)
{
// Example HTML content
string htmlContent = "<html><body><h1>Hello, PdfSharp!</h1><p>This is an example of HTML to PDF.</p></body></html>";
// Parse HTML using HtmlAgilityPack (You need to add HtmlAgilityPack via NuGet)
var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(htmlContent);
// Create a new PDF document
PdfDocument pdfDocument = new PdfDocument
{
Info = { Title = "HTML to PDF Example" }
};
// Add a new page to the document
PdfPage page = pdfDocument.AddPage();
XGraphics gfx = XGraphics.FromPdfPage(page);
XFont titleFont = new XFont("Arial", 20, XFontStyle.Bold);
XFont textFont = new XFont("Arial", 12, XFontStyle.Regular);
// Draw the parsed HTML content
int yPosition = 50; // Starting Y position
foreach (var node in htmlDoc.DocumentNode.SelectNodes("//h1 | //p"))
{
if (node.Name == "h1")
{
gfx.DrawString(node.InnerText, titleFont, XBrushes.Black, new XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft);
yPosition += 30; // Adjust spacing
}
else if (node.Name == "p")
{
gfx.DrawString(node.InnerText, textFont, XBrushes.Black, new XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft);
yPosition += 20; // Adjust spacing
}
}
// Save the PDF document
string outputFilePath = "HtmlToPdf.pdf";
pdfDocument.Save(outputFilePath);
System.Console.WriteLine($"PDF file created: {outputFilePath}");
}
}Imports PdfSharp.Pdf
Imports PdfSharp.Drawing
Imports HtmlAgilityPack
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Example HTML content
Dim htmlContent As String = "<html><body><h1>Hello, PdfSharp!</h1><p>This is an example of HTML to PDF.</p></body></html>"
' Parse HTML using HtmlAgilityPack (You need to add HtmlAgilityPack via NuGet)
Dim htmlDoc = New HtmlDocument()
htmlDoc.LoadHtml(htmlContent)
' Create a new PDF document
Dim pdfDocument As New PdfDocument With {
.Info = { Title = "HTML to PDF Example" }
}
' Add a new page to the document
Dim page As PdfPage = pdfDocument.AddPage()
Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
Dim titleFont As New XFont("Arial", 20, XFontStyle.Bold)
Dim textFont As New XFont("Arial", 12, XFontStyle.Regular)
' Draw the parsed HTML content
Dim yPosition As Integer = 50 ' Starting Y position
For Each node In htmlDoc.DocumentNode.SelectNodes("//h1 | //p")
If node.Name = "h1" Then
gfx.DrawString(node.InnerText, titleFont, XBrushes.Black, New XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft)
yPosition += 30 ' Adjust spacing
ElseIf node.Name = "p" Then
gfx.DrawString(node.InnerText, textFont, XBrushes.Black, New XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft)
yPosition += 20 ' Adjust spacing
End If
Next node
' Save the PDF document
Dim outputFilePath As String = "HtmlToPdf.pdf"
pdfDocument.Save(outputFilePath)
System.Console.WriteLine($"PDF file created: {outputFilePath}")
End Sub
End ClassParsowanie HTML: Przykład używa HtmlAgilityPack (biblioteki open-source do parsowania i manipulacji HTML), aby wydobyć treść z tagów <h1> i <p>.
Rysowanie Treści: Klasa XGraphics PDFSharp jest używana do renderowania przeanalizowanej zawartości HTML jako tekst na stronie PDF.
Ograniczenia: To podejście sprawdza się w przypadku prostych struktur HTML, ale nie radzi sobie ze złożonymi układami, stylami ani JavaScriptem.
Pdfium.NET to kompleksowa biblioteka oparta na projekcie open source PDFium, przeznaczona do przeglądania, edycji i manipulowania plikami PDF w aplikacjach .NET. Zapewnia programistom potężne narzędzia do tworzenia, edytowania i wyodrębniania treści z plików PDF, dzięki czemu nadaje się do szerokiego zakresu zastosowań. Jest to w zasadzie bezpłatna biblioteka do konwersji HTML na PDF.
Tworzenie i Edytowanie PDF:
Wydobywanie Tekstu i Obrazów:
Kontrola Przeglądarki PDF:
Zgodność:
Zaawansowane Funkcje:
using Pdfium.Net.SDK;
using System;
class Program
{
static void Main(string[] args)
{
// Initialize Pdfium.NET SDK functionalities
PdfCommon.Initialize();
// Create a new PDF document
PdfDocument pdfDocument = PdfDocument.CreateNew();
// Add a page to the document (A4 size in points: 8.27 x 11.69 inches)
var page = pdfDocument.Pages.InsertPageAt(pdfDocument.Pages.Count, 595, 842);
// Sample HTML content to be parsed and rendered manually
var htmlContent = "<h1>Hello, Pdfium.NET SDK!</h1><p>This is an example of HTML to PDF.</p>";
// Example: Manually render text since Pdfium.NET doesn't render HTML directly
var font = PdfFont.CreateFont(pdfDocument, "Arial");
page.AddText(72, 750, font, 20, "Hello, Pdfium.NET SDK!");
page.AddText(72, 700, font, 14, "This is an example of HTML to PDF.");
// Save the document to a file
string outputFilePath = "HtmlToPdfExample.pdf";
pdfDocument.Save(outputFilePath, SaveFlags.Default);
Console.WriteLine($"PDF created successfully: {outputFilePath}");
}
}Imports Pdfium.Net.SDK
Imports System
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Initialize Pdfium.NET SDK functionalities
PdfCommon.Initialize()
' Create a new PDF document
Dim pdfDocument As PdfDocument = PdfDocument.CreateNew()
' Add a page to the document (A4 size in points: 8.27 x 11.69 inches)
Dim page = pdfDocument.Pages.InsertPageAt(pdfDocument.Pages.Count, 595, 842)
' Sample HTML content to be parsed and rendered manually
Dim htmlContent = "<h1>Hello, Pdfium.NET SDK!</h1><p>This is an example of HTML to PDF.</p>"
' Example: Manually render text since Pdfium.NET doesn't render HTML directly
Dim font = PdfFont.CreateFont(pdfDocument, "Arial")
page.AddText(72, 750, font, 20, "Hello, Pdfium.NET SDK!")
page.AddText(72, 700, font, 14, "This is an example of HTML to PDF.")
' Save the document to a file
Dim outputFilePath As String = "HtmlToPdfExample.pdf"
pdfDocument.Save(outputFilePath, SaveFlags.Default)
Console.WriteLine($"PDF created successfully: {outputFilePath}")
End Sub
End ClassInicjalizacja SDK: Metoda PdfCommon.Initialize() inicjalizuje funkcje Pdfium.NET.
Tworzenie PDF: Nowy dokument PDF jest tworzony za pomocą PdfDocument.CreateNew().
Dodawanie stron: Strony są wstawiane do pliku PDF o określonych wymiarach (np. format A4).
Renderowanie treści HTML: Ponieważ Pdfium.NET SDK nie obsługuje natywnie renderowania HTML, należy ręcznie analizować i renderować elementy HTML jako tekst, kształty lub obrazy.
Zapisywanie PDF: Dokument jest zapisywany w ścieżce pliku przy użyciu metody Save().
IronPDF to profesjonalna biblioteka przeznaczona dla programistów .NET, umożliwiająca łatwą konwersję treści HTML do wysokiej jakości plików PDF. Znany ze swojej niezawodności, zaawansowanych funkcji i łatwości użytkowania, IronPDF usprawnia proces tworzenia oprogramowania, zapewniając jednocześnie precyzyjne renderowanie i solidną funkcjonalność. Oto dlaczego IronPDF jest rozwiązaniem, które się wyróżnia:
Bezpośrednia konwersja HTML do PDF: Twórz dokumenty PDF bezpośrednio za pomocą IronPDF z treścią HTML, w tym CSS i JavaScript, do w pełni sformatowanych plików PDF. Za pomocą zaledwie kilku linii kodu programiści mogą generować pliki PDF ze stron internetowych, surowych ciągów HTML lub lokalnych plików HTML.
Nowoczesne możliwości renderowania: Obsługując najnowsze standardy internetowe, IronPDF zapewnia dokładne renderowanie złożonych układów, stylów i elementów interaktywnych w celu konwersji stron HTML do formatu PDF.
Zaawansowane funkcje PDF: IronPDF oferuje szerokie możliwości dostosowywania, takie jak dodawanie nagłówków, stopek, znaków wodnych, adnotacji i zakładek. Obsługuje również scałanie, dzielenie i edycję istniejących plików PDF.
Wydajność i skalowalność: Zoptymalizowany zarówno pod kątem aplikacji na małą skalę, jak i środowisk Enterprise, IronPDF zapewnia szybką i niezawodną wydajność w projektach każdej wielkości.
Łatwość integracji: Zaprojektowany dla platform .NET Framework i .NET Core, IronPDF płynnie integruje się z aplikacjami C#, oferując programistom prosty proces konfiguracji oraz obszerną dokumentację.
IronPDF wyróżnia się na tle innych rozwiązań dzięki połączeniu funkcji, wsparcia dla programistów i wydajności. W przeciwieństwie do alternatywnych rozwiązań open source, które często wymagają rozbudowanej konfiguracji lub zewnętrznych zależności, IronPDF jest samodzielnym rozwiązaniem, które upraszcza proces tworzenia oprogramowania bez utraty funkcjonalności. Niezależnie od tego, czy chodzi o generowanie faktur, raportów czy archiwizację treści internetowych, IronPDF zapewnia programistom narzędzia niezbędne do szybkiego i wydajnego osiągania profesjonalnych wyników.
IronPDF to praktyczny wybór dla programistów, którzy cenią sobie niezawodność, skalowalność i łatwość użytkowania w procesach konwersji HTML do PDF.
using IronPdf;
class Program
{
static void Main()
{
// Specify license key
IronPdf.License.LicenseKey = "Your Key";
// Create a new HtmlToPdf object using ChromePdfRenderer
var Renderer = new ChromePdfRenderer();
// Define the HTML string to be converted
string htmlContent = "<html><body><h1>IronPDF: Better than Open source</h1></body></html>";
// Convert the HTML string to a PDF document
var document = Renderer.RenderHtmlAsPdf(htmlContent);
// Save the PDF document to a file
document.SaveAs("html2Pdf.pdf");
Console.WriteLine("PDF generated and saved successfully!");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main()
' Specify license key
IronPdf.License.LicenseKey = "Your Key"
' Create a new HtmlToPdf object using ChromePdfRenderer
Dim Renderer = New ChromePdfRenderer()
' Define the HTML string to be converted
Dim htmlContent As String = "<html><body><h1>IronPDF: Better than Open source</h1></body></html>"
' Convert the HTML string to a PDF document
Dim document = Renderer.RenderHtmlAsPdf(htmlContent)
' Save the PDF document to a file
document.SaveAs("html2Pdf.pdf")
Console.WriteLine("PDF generated and saved successfully!")
End Sub
End ClassKonfiguracja klucza licencyjnego: Program rozpoczyna się od ustawienia klucza licencyjnego IronPDF, który jest wymagany do odblokowania pełnej funkcjonalności biblioteki.
Tworzenie renderera: Inicjalizowana jest instancja ChromePdfRenderer. Ten komponent odpowiada za konwersję treści HTML do dokumentu PDF, pełniąc rolę pomostu między surowym kodem HTML a końcowym wynikiem.
Definiowanie zawartości HTML: Tworzona jest zmienna string, htmlContent, przechowująca strukturę HTML, która zostanie przekonwertowana na PDF. W tym przykładzie znajduje się prosty nagłówek.
Konwersja HTML do PDF: Wywoływana jest metoda RenderHtmlAsPdf() na instancji ChromePdfRenderer, przekazując string HTML jako wejście. Ta funkcja przetwarza treść i przekształca ją w dokument PDF.
Zapisywanie PDF: Na koniec wygenerowany PDF jest zapisywany do pliku o nazwie "html2Pdf.pdf" przy użyciu metody SaveAs(), przechowując go na dysku do przyszłego dostępu.
Aby korzystać z pełnej funkcjonalności IronPDF, wymagany jest ważny klucz licencyjny. Licencję Trial można uzyskać na oficjalnej stronie internetowej. Przed użyciem biblioteki IronPDF należy ustawić klucz licencyjny w następujący sposób:
IronPdf.License.LicenseKey = "your key";IronPdf.License.LicenseKey = "your key"Gwarantuje to, że biblioteka działa bez ograniczeń.
PuppeteerSharp to doskonały wybór dla programistów, którzy potrzebują precyzyjnego renderowania HTML do formatu PDF, zwłaszcza w przypadku złożonych stron internetowych. Jednak w przypadku aplikacji wymagających zaawansowanych funkcji związanych z plikami PDF, optymalizacji wydajności i łatwości integracji, profesjonalne narzędzia, takie jak IronPDF, są często lepszym rozwiązaniem.
PDFSharp jest doskonałym wyborem do lekkiego, programistycznego tworzenia i manipulacji PDF, zwłaszcza do projektów o prostych wymaganiach. Jeśli jednak Twoja aplikacja wymaga konwersji HTML do formatu PDF lub zaawansowanych funkcji PDF, IronPDF zapewnia bardziej wydajne i bogate w funkcje rozwiązanie.
Podczas gdy Pdfium.NET SDK jest solidnym narzędziem do manipulacji plikami PDF, IronPDF zapewnia natywną obsługę bezpośredniej konwersji HTML do PDF, w tym renderowanie nowoczesnego HTML, CSS i JavaScript. IronPDF upraszcza przepływ pracy dzięki wbudowanym metodom takim jak HtmlToPdf.RenderHtmlAsPdf(), czyniąc to szybszym i bardziej efektywnym dla deweloperów.
Niezależnie od tego, czy chodzi o generowanie faktur, raportów czy archiwizację treści internetowych, IronPDF zapewnia programistom narzędzia niezbędne do szybkiego i wydajnego osiągania profesjonalnych wyników.
IronPDF to praktyczny wybór dla programistów, którzy cenią sobie niezawodność, skalowalność i łatwość obsługi w procesach konwersji HTML do PDF.
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.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
