Jak wygenerować plik PDF w języku C# (.NET 5) przy użyciu PDFSharp

Instalacja i konfiguracja

Zanim przejdzie do kodu, prelegent podkreśla, że skonfigurowanie środowiska dla PDFsharp może być dość trudne. Wyjaśniają, że przed rozpoczęciem pracy z PDFsharp należy zainstalować trzy pakiety NuGet. Szczegóły pakietu NuGet. Pierwszym pakietem jest sam PDFsharp, który może wygenerować ostrzeżenie, że może nie być zgodny z platformą .NET ze względu na starszą wersję. Pozostałe dwa pakiety to System.Drawing.Common i System.Text.Encoding.CodePages.

Prelegent podkreśla, że przed rozpoczęciem pracy z PDFsharp należy zainstalować wszystkie trzy pakiety; w przeciwnym razie kod wygeneruje błąd. Wyjaśniają, że pakiet System.Text.Encoding.CodePages jest szczególnie ważny, ponieważ zapewnia obsługę kodowania niezbędną do generowania plików PDF. Autor zwraca również uwagę, że nieprawidłowa instalacja pakietów może utrudnić rozwiązywanie problemów. Zespoły, które chcą całkowicie uniknąć tej konfiguracji z wieloma pakietami, mogą skorzystać z przewodnika migracji z PDFsharp do IronPDF, aby przeprowadzić przejście krok po kroku.

Tworzenie pliku PDF

Następnie prelegent przedstawia prostą aplikację konsolową, która wykorzystuje PDFsharp do generowania pliku PDF. Wyjaśnia, że przed użyciem biblioteki należy zadeklarować instrukcje using dla PDFsharp Drawing i PDFsharp PDF. Następnie prelegent przedstawia kod służący do generowania pliku PDF, który obejmuje utworzenie nowego dokumentu, dodanie nowej strony oraz narysowanie tekstu na tej stronie.

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

Imports PdfSharp.Drawing
Imports PdfSharp.Pdf

Namespace PdfSharpExample
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a new PDF document
			Dim document As New PdfDocument()
			' Add a new page
			Dim page As PdfPage = document.AddPage()
			' Prepare to draw on the page
			Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
			' Define a font
			Dim font As New XFont("Verdana", 20, XFontStyle.Bold)

			' Draw a string to the page
			gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black, New XRect(0, 0, page.Width, page.Height), XStringFormats.Center)

			' Save the document
			Const filename As String = "HelloWorld.pdf"
			document.Save(filename)
		End Sub
	End Class
End Namespace

Prelegent zauważa, że kod służący do generowania pliku PDF można dostosować tak, aby uwzględniał bardziej złożone funkcje, takie jak dodawanie obrazów (zobacz, jak konwertować obrazy do formatu PDF za pomocą IronPDF), tabel i wykresów. Wyjaśniają również, że PDFsharp oferuje różne funkcje do pracy z czcionkami, w tym osadzanie czcionek w pliku PDF.

Prelegent wyjaśnia, jak ważne jest prawidłowe skonfigurowanie środowiska poprzez zainstalowanie niezbędnych pakietów NuGet i zarejestrowanie dostawcy dla System.Text.Encoding. Przedstawiono również prostą aplikację konsolową, która wykorzystuje PDFsharp do generowania pliku PDF i pokazuje, w jaki sposób można dostosować kod, aby uwzględnić bardziej złożone funkcje. Film jest doskonałym źródłem informacji dla wszystkich osób zainteresowanych tworzeniem plików PDF przy użyciu języka C# i biblioteki PDFsharp.

Tworzenie list i bardziej złożonych elementów

W drugiej części filmu prelegent rozpoczyna od przedstawienia bardziej złożonego przykładu tworzenia dokumentu PDF. Podkreśla, że posiadanie pustego dokumentu PDF nie ma sensu, a następnie wyjaśnia, jak utworzyć nową stronę przy użyciu biblioteki PDFSharp. Zauważa on, że proces ten jest podobny do tworzenia elementów w dodatkach do programów Excel lub PowerPoint oraz że po utworzeniu strony działa ona w oparciu o odwołanie, które nie wymaga wywołania innej metody.

Następnie prelegent przedstawia zmienną XGraphics, która udostępnia metody rysowania takich elementów jak tekst, linie i obrazy — funkcjonalność, którąIronPDFobsługuje za pośrednictwem swojego API do umieszczania tekstu i obrazów bez konieczności ręcznego obliczania współrzędnych. Wprowadzono również zmienną XFont jako sposób na ustawienie czcionki do użycia w dokumencie PDF. Prelegent zauważa, że czcionkę można wygenerować gdzie indziej, ale w przypadku bardziej złożonego układu warto skonfigurować ją globalnie.

Następnie prelegent omawia metodę DrawString, która zapisuje tekst w pliku PDF. Zauważa, że złożoną częścią tej metody jest określenie miejsca, w którym tekst zostanie narysowany, i wyjaśnia różne związane z tym parametry, takie jak czcionka, kolor i granice, w których tekst może się wyrównać. Wyjaśnia również użycie zmiennej XBrushes do ustawienia koloru tekstu.

Którą bibliotekę wybrać?

Podsumowując, prelegent podkreśla znaczenie znajomości dodatków do pakietu Microsoft Office podczas pracy z PDFSharp i oferuje własny kurs na ten temat. Zauważa również, że biblioteka jest bardzo wszechstronna i może służyć do tworzenia szerokiej gamy dokumentów PDF, od prostych dokumentów tekstowych po bardziej złożone, zawierające obrazy, grafiki i niestandardowe układy.

Czym jest IronPDF?

IronPDF to biblioteka C# do tworzenia, edycji i manipulowania dokumentami PDF. Jest dostarczany jako pojedynczy pakiet NuGet — Install-Package IronPdf — i integruje się z aplikacjami .NET bez konieczności dodatkowej konfiguracji zależności.

PDFsharp zapewnia solidną kontrolę rysowania na niskim poziomie i jest dystrybuowany na liberalnej licencji MIT — to dwie prawdziwe zalety, które sprawiły, że stał się on podstawowym narzędziem w wielu projektach .NET. Zespoły często napotykają trudności, gdy wymagania wykraczają poza renderowanie oparte na współrzędnych i obejmują takie obszary, jak konwersja HTML do PDF, podpisy cyfrowe lub szyfrowanie dokumentów.IronPDFto biblioteka objęta wsparciem komercyjnym, która traktuje te scenariusze jako operacje najwyższej klasy, oferując profesjonalne wsparcie oraz interfejs API zaprojektowany z myślą o typowych procesach generowania dokumentów, w tym renderowaniu HTML, CSS i JavaScript.

Funkcje

Jedną z kluczowych funkcjiIronPDFjest możliwość konwersji HTML do PDF za pomocą IronPDF, co ułatwia tworzenie dokumentów PDF ze stron internetowych. Konwersja HTML do PDF wykracza poza obecny zakres działania PDFsharp — działa on na poziomie rysowania współrzędnych — więc zespoły potrzebujące tej funkcji zazwyczaj dodają oddzielną bibliotekę renderującą lub rozważają wbudowany silnik Chromium w IronPDF.

IronPDF obsługuje również podpisy cyfrowe oraz szyfrowanie plików PDF z ochroną hasłem, co ma kluczowe znaczenie w przypadku poufnych dokumentów wymagających bezpiecznego postępowania. PDFsharp nie jest przeznaczony do obsługi takich scenariuszy bezpieczeństwa, więc zespoły, które muszą spełniać wymogi dotyczące zgodności lub ochrony dokumentów, często uznają to za naturalny punkt zwrotny przy ocenie IronPDF.

IronPDF zapewnia szerszy zestaw funkcji i bardziej kompleksową ofertę wsparcia w porównaniu z PDFsharp, obejmując renderowanie HTML, szyfrowanie i podpisy cyfrowe w jednym pakiecie NuGet. Jest to jednak produkt komercyjny, więc zespoły, których wymagania mieszczą się w modelu rysowania współrzędnych PDFsharp — i które nie potrzebują konwersji HTML ani wbudowanych funkcji bezpieczeństwa — mogą preferować podejście PDFsharp oparte na licencji MIT i oprogramowaniu open source.

Oprócz kosztów licencji, całkowity koszt projektu obejmuje godziny pracy programistów poświęcone na tworzenie oddzielnych bibliotek renderujących, zarządzanie układami stron opartymi na współrzędnych dla złożonych dokumentów oraz rozwiązywanie problemów związanych z konfiguracją wielu pakietów, której wymaga PDFsharp. Dla zespołów oceniających koszty w perspektywie wieloletniego cyklu życia projektu koszty integracji i utrzymania często przewyższają różnicę między licencjami open source a komercyjnymi.

Chcesz sprawdzić, jakIronPDFwpisuje się w Twój proces pracy? [Pobierz bezpłatną 30-dniową wersję probną](Licencja Trial, aby przetestować wszystkie funkcje omówione w tym porównaniu.