PDFsharp vs QuestPDF (C# Porównanie bibliotek PDF)

Najważniejsze cechy PDFsharp

• Tworzenie i edycja plików PDF: Generuj nowe pliki PDF lub modyfikuj istniejące.
• Rysowanie grafiki: Obejmuje obsługę rysowania kształtów, tekstu i obrazów.
• Open Source: Na licencji MIT, co oznacza, że można z niego korzystać i modyfikować go bezpłatnie.

Instalacja

Dzięki menedżerowi pakietów NuGet łatwo zainstalujesz PDFsharp w swoich projektach. Wystarczy uruchomić następujący wiersz w konsoli menedżera pakietów NuGet:

Install-Package PDFsharp

Przykład kodu PDFsharp

Przyjrzyjmy się teraz, w jaki sposób PDFsharp może obsłużyć tworzenie nowego dokumentu PDF na podstawie podanego adresu URL. Ponieważ sam PDFsharp nie obsługuje konwersji HTML lub URL do formatu PDF, będziemy musieli zintegrować silnik renderowania stron internetowych, taki jak HtmlRenderer.PdfSharp. Dodatkowo użyjemy HttpClient do pobrania treści HTML z podanego adresu URL.

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using PdfSharp.Pdf;
using TheArtOfDev.HtmlRenderer.PdfSharp;

public class Program
{
    static async Task Main(string[] args)
    {
        // Ensure proper encoding support
        Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Generate PDF from the fetched HTML content
            var pdf = PdfGenerator.GeneratePdf(htmlContent, PdfSharp.PageSize.A4);
            pdf.Save("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using PdfSharp.Pdf;
using TheArtOfDev.HtmlRenderer.PdfSharp;

public class Program
{
    static async Task Main(string[] args)
    {
        // Ensure proper encoding support
        Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Generate PDF from the fetched HTML content
            var pdf = PdfGenerator.GeneratePdf(htmlContent, PdfSharp.PageSize.A4);
            pdf.Save("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

Imports System
Imports System.Net.Http
Imports System.Text
Imports System.Threading.Tasks
Imports PdfSharp.Pdf
Imports TheArtOfDev.HtmlRenderer.PdfSharp

Public Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Ensure proper encoding support
		Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

		Dim url As String = "https://www.apple.com"

		' Fetch HTML content from the URL
		Using client As New HttpClient()
			Dim htmlContent As String = Await client.GetStringAsync(url)

			' Generate PDF from the fetched HTML content
			Dim pdf = PdfGenerator.GeneratePdf(htmlContent, PdfSharp.PageSize.A4)
			pdf.Save("output.pdf")

			Console.WriteLine("PDF created successfully as 'output.pdf'.")
		End Using
	End Function
End Class

Plik PDF wyjściowy

Jak widać, chociaż PDFsharp może służyć do konwersji treści HTML i stron internetowych do plików PDF, wymaga pomocy dodatkowych bibliotek i nie jest w stanie zachować żadnego z elementów CSS ani formatowania widocznego na oryginalnej stronie internetowej. Chociaż jest to świetna bezpłatna biblioteka dla programistów PDF, brakuje jej niektórych bardziej zaawansowanych funkcji dostępnych w bibliotekach płatnych, takich jak IronPDF.

Najważniejsze funkcje QuestPDF

• Fluent API: Oferuje deklaratywne podejście do definiowania układów dokumentów.
• Nowoczesny system układów: Zainspirowany CSS, obsługuje siatki, komponenty i elastyczne struktury układów.
• Wysoka wydajność: Zoptymalizowana pod kątem szybkiego renderowania dużych i złożonych dokumentów.

Instalacja

Dzięki temu, że biblioteka ta jest dostępna do zainstalowania jako pakiet NuGet, jej instalacja jest prosta i wymaga jedynie uruchomienia jednej linii w konsoli NuGet:

Install-Package QuestPDF

Przykład kodu QuestPDF

Teraz przyjrzyjmy się, jak QuestPDF poradzi sobie z konwersją naszego przykładowego adresu URL do formatu PDF. Chociaż QuestPDF nie obsługuje natywnie konwersji adresów URL do formatu PDF, można użyć klienta HTTP do pobrania treści HTML i renderowania jej do formatu PDF przy użyciu płynnego interfejsu API QuestPDF.

using System;
using System.Net.Http;
using System.Threading.Tasks;
using HtmlAgilityPack;
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;

public class Program
{
    static async Task Main(string[] args)
    {
        // Configure QuestPDF to use the community license
        QuestPDF.Settings.License = LicenseType.Community;

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Parse the HTML content using HtmlAgilityPack
            var htmlDoc = new HtmlDocument();
            htmlDoc.LoadHtml(htmlContent);

            // Extract meaningful content (e.g., text inside <body>)
            var bodyContent = htmlDoc.DocumentNode.SelectSingleNode("//body")?.InnerText ?? "No content found";

            // Generate PDF using QuestPDF
            Document.Create(container =>
            {
                container.Page(page =>
                {
                    page.Size(PageSizes.A4);
                    page.Margin(20);
                    page.Content().Text(bodyContent);
                });
            }).GeneratePdf("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;
using HtmlAgilityPack;
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;

public class Program
{
    static async Task Main(string[] args)
    {
        // Configure QuestPDF to use the community license
        QuestPDF.Settings.License = LicenseType.Community;

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Parse the HTML content using HtmlAgilityPack
            var htmlDoc = new HtmlDocument();
            htmlDoc.LoadHtml(htmlContent);

            // Extract meaningful content (e.g., text inside <body>)
            var bodyContent = htmlDoc.DocumentNode.SelectSingleNode("//body")?.InnerText ?? "No content found";

            // Generate PDF using QuestPDF
            Document.Create(container =>
            {
                container.Page(page =>
                {
                    page.Size(PageSizes.A4);
                    page.Margin(20);
                    page.Content().Text(bodyContent);
                });
            }).GeneratePdf("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

Imports System
Imports System.Net.Http
Imports System.Threading.Tasks
Imports HtmlAgilityPack
Imports QuestPDF.Fluent
Imports QuestPDF.Helpers
Imports QuestPDF.Infrastructure

Public Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Configure QuestPDF to use the community license
		QuestPDF.Settings.License = LicenseType.Community

		Dim url As String = "https://www.apple.com"

		' Fetch HTML content from the URL
		Using client As New HttpClient()
			Dim htmlContent As String = Await client.GetStringAsync(url)

			' Parse the HTML content using HtmlAgilityPack
			Dim htmlDoc = New HtmlDocument()
			htmlDoc.LoadHtml(htmlContent)

			' Extract meaningful content (e.g., text inside <body>)
			Dim bodyContent = If(htmlDoc.DocumentNode.SelectSingleNode("//body")?.InnerText, "No content found")

			' Generate PDF using QuestPDF
			Document.Create(Sub(container)
				container.Page(Sub(page)
					page.Size(PageSizes.A4)
					page.Margin(20)
					page.Content().Text(bodyContent)
				End Sub)
			End Sub).GeneratePdf("output.pdf")

			Console.WriteLine("PDF created successfully as 'output.pdf'.")
		End Using
	End Function
End Class

Plik PDF wyjściowy

Podobnie jak w przypadku PDFSharp, chociaż QuestPDF może być wykorzystywany do konwersji treści HTML do formatu PDF przy pomocy zewnętrznych bibliotek, takich jak HtmlAgilityPack, nie jest w stanie zachować żadnego stylowania CSS ani formatowania. Chociaż QuestPDF to świetny wybór dla każdego, kto chce tworzyć dokumenty PDF od podstaw, konwersja HTML na PDF nie jest mocną stroną tej biblioteki.

Najważniejsze cechy IronPDF

• HTML do PDF: Łatwe renderowanie pełnych stron internetowych lub ciągów HTML jako plików PDF.
• Zgodność z PDF/A: Generuj dokumenty zgodne ze standardami długoterminowej archiwizacji.
• Zaawansowane zabezpieczenia: Obsługuje szyfrowanie, ochronę hasłem i podpisy cyfrowe.
• Edycja plików PDF: Modyfikuj, scalaj i dziel istniejące pliki PDF.
• Wieloplatformowość: w pełni kompatybilny z .NET Framework, .NET Core i .NET 5+.

Instalacja

Aby zainstalować IronPDF, użyj menedżera pakietów NuGet w Visual Studio:

Korzystanie z menedżera pakietów NuGet:

1. Otwórz swój projekt w Visual Studio.
2. Kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań i wybierz opcję "Zarządzaj pakietami NuGet".
3. Wyszukaj "IronPDF" i kliknij "Zainstaluj".

Korzystanie z konsoli menedżera pakietów NuGet:

Install-Package IronPdf

Przykład: Konwersja adresu URL do formatu PDF przy użyciu IronPDF

IronPDF zapewnia proste i bezpośrednie API do konwersji adresów URL na pliki PDF. Oto przykład:

using IronPdf;

public class PdfConverter
{
    public static void Main(string[] args)
    {
        // Create a renderer with IronPdf
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Render the URL as a PDF
        PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.apple.com");

        // Save the PDF
        pdf.SaveAs("url.pdf");
    }
}

using IronPdf;

public class PdfConverter
{
    public static void Main(string[] args)
    {
        // Create a renderer with IronPdf
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Render the URL as a PDF
        PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.apple.com");

        // Save the PDF
        pdf.SaveAs("url.pdf");
    }
}

Imports IronPdf

Public Class PdfConverter
	Public Shared Sub Main(ByVal args() As String)
		' Create a renderer with IronPdf
		Dim renderer As New ChromePdfRenderer()

		' Render the URL as a PDF
		Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://www.apple.com")

		' Save the PDF
		pdf.SaveAs("url.pdf")
	End Sub
End Class

Plik PDF wyjściowy

Powyższy przykład kodu pokazuje, jak IronPDF może z łatwością konwertować zawartość adresów URL do formatu PDF za pomocą zaledwie kilku wierszy kodu. Jak widać, nie tylko przekonwertowano kod HTML, ale także style CSS i układy, dzięki czemu plik PDF jest wierny oryginalnemu formatowaniu. Dzięki wykorzystaniu silnika renderującego ChromePdfRenderer, IronPDF tworzy dokumenty PDF o idealnej jakości pikseli, które nie tracą nic z oryginalnej jakości treści w procesie konwersji.

Jak widać, IronPDF to świetny wybór do konwersji HTML na PDF, a także do konwersji innych typów dokumentów na PDF. Obsługuje zadania konwersji o wysokiej jakości w zwięzłym, łatwym do wdrożenia bloku kodu.

Łatwość użytkowania

PDFsharp jest prosty i łatwy w użyciu, co czyni go doskonałym wyborem dla początkujących lub programistów o podstawowych potrzebach związanych z plikami PDF. Jego proceduralne podejście pozwala na szybką konfigurację i wdrożenie w przypadku zadań takich jak dodawanie tekstu, kształtów lub obrazów do pliku PDF. Wymaga jednak zewnętrznej biblioteki do obsługi zadań związanych z konwersją HTML i adresów URL do formatu PDF.

Z kolei QuestPDF oferuje bardziej nowoczesne podejście dzięki płynnemu API. Programiści z doświadczeniem w projektowaniu stron internetowych lub interfejsów użytkownika uznają go za intuicyjny, ale nowicjusze mogą napotkać niewielkie trudności w nauce, przyzwyczajając się do filozofii projektowania skoncentrowanej na układzie. Ponownie, brakuje wbudowanych narzędzi do konwersji HTML na PDF.

IronPDF zapewnia najprostszą obsługę konwersji HTML do PDF oraz zaawansowane funkcje PDF. Jego intuicyjny interfejs API skraca czas wdrożenia i oferuje obszerną dokumentację oraz przykłady. IronPDF umożliwia konwersję wielu różnych typów dokumentów do formatu PDF, takich jak przykład przekształcenia adresu URL na plik PDF, który omówiliśmy w tym artykule, a wszystko to bez utraty jakości dokumentu.

Wydajność

Wydajność jest kluczowym czynnikiem, zwłaszcza w przypadku aplikacji, które muszą dynamicznie generować pliki PDF. PDFsharp nadaje się do małych i prostych dokumentów, ale ma trudności z obsługą dużych lub złożonych układów.

QuestPDF wyróżnia się w renderowaniu dynamicznych i atrakcyjnych wizualnie dokumentów. Jest zoptymalizowany pod kątem obsługi ustrukturyzowanych układów z wysoką wydajnością.

IronPDF wyjątkowo dobrze łączy wydajność z funkcjonalnością, zwłaszcza w przypadku aplikacji wymagających renderowania HTML oraz obsługi CSS i JavaScript. Z łatwością radzi sobie również z zadaniami związanymi z plikami PDF na poziomie Enterprise.