PDF (Portable Document Format) to powszechnie akceptowany format służący do udostępniania dokumentów na różnych platformach. Możliwość zachowania formatowania, czcionek i układu sprawia, że jest to niezbędne narzędzie do celów biznesowych, prawnych i edukacyjnych. Wraz ze wzrostem zapotrzebowania na obróbkę plików PDF w tworzeniu oprogramowania, ekosystem .NET zapewnia programistom wiele bibliotek do pracy z plikami PDF. Wśród nich PDFSharp i IronPDF wyróżniają się jako potężne rozwiązania do tworzenia i edycji plików PDF.

W tym artykule pokażemy, jak dodać numery stron do dokumentów PDF za pomocą PDFSharp i IronPDF w C#, i porównamy funkcje obu bibliotek, aby pomóc Ci zdecydować, która z nich najlepiej odpowiada Twoim potrzebom.

Czym jest IronPDF?

IronPDF to potężna biblioteka .NET przeznaczona do płynnego tworzenia, edycji i renderowania plików PDF. Wyróżnia się możliwością bezpośredniej konwersji HTML, CSS i JavaScript na wysokiej jakości pliki PDF przy użyciu silnika opartego na Chromium. To sprawia, że IronPDF jest idealnym rozwiązaniem dla programistów, którzy muszą konwertować dynamiczne strony internetowe lub złożoną zawartość HTML na dobrze sformatowany plik PDF, zachowując układ i styl tak, jak wygląda to w przeglądarce.

Najważniejsze cechy IronPDF:

• Konwertuje HTML, JavaScript i CSS na wysokiej jakości pliki PDF.
• Umożliwia tworzenie niestandardowych nagłówków, stopek, znaków wodnych i innych elementów strony.
• Obsługuje łączenie i dzielenie plików PDF.
• Działa płynnie z aplikacjami .NET, w tym frameworkami ASP.NET i MVC.
• Zapewnia precyzyjną kontrolę nad renderowaniem plików PDF, gwarantując, że treść jest wyświetlana zgodnie z zamierzeniami.
• Oferuje proste API ułatwiające integrację z projektami.

Aby zapoznać się z bardziej zaawansowanymi funkcjami i przykładami, zapoznaj się z oficjalną dokumentacją IronPDF.

Instalacja IronPDF

Aby dodać IronPDF do swojego projektu, użyj menedżera pakietów NuGet w Visual Studio. Można je zainstalować za pomocą interfejsu Visual Command-Line lub wyszukać bezpośrednio w menedżerze pakietów NuGet.

Instalacja z wiersza poleceń:

Install-Package IronPdf

Alternatywnie można wyszukać "IronPDF" w menedżerze pakietów NuGet i zainstalować go stamtąd.

Czym jest PDFSharp?

PDFSharp to wszechstronna biblioteka .NET skupiająca się na tworzeniu i manipulowaniu dokumentami PDF z dużą elastycznością. W odróżnieniu od innych bibliotek, PDFSharp pozwala na szczegółową kontrolę nad strukturą i projektowaniem PDF, co czyni ją doskonałym wyborem dla deweloperów, którzy chcą tworzyć dokumenty od podstaw lub modyfikować istniejące PDF. Dzięki bogatemu API, PDFSharp obsługuje szeroki zakres zadań związanych z manipulacją dokumentami, w tym dodawanie tekstu, obrazów, tabel, a nawet numerów stron.

Najważniejsze cechy PDFSharp:

• Tworzy, odczytuje i modyfikuje dokumenty PDF.
• Konfigurowalne zdarzenia strony umożliwiające dodawanie elementów, takich jak numery stron lub stopki.
• Obsługuje dodawanie obrazów, tekstu, tabel i innych treści.
• Zapewnia szczegółową kontrolę nad układem i strukturą plików PDF.
• Możliwość modyfikowania istniejących plików PDF, w tym łączenia lub dzielenia dokumentów.
• Biblioteka open source, którą programiści mogą elastycznie dostosowywać lub rozszerzać.

Aby dowiedzieć się więcej o funkcjonalności i sposobie użycia PDFSharp, zajrzyj do repozytorium PDFSharp na GitHubie.

Instalowanie PDFSharp

Aby rozpocząć pracę z PDFSharp, zainstaluj pakiet za pośrednictwem NuGet, korzystając z wiersza poleceń:

Instalacja z wiersza poleceń:

Install-Package PDFSharp

Alternatywnie można wyszukać "PDFSharp" w menedżerze pakietów NuGet i zainstalować go stamtąd.

Jak dodać numery stron za pomocą IronPDF

IronPDF to wszechstronna biblioteka PDF zaprojektowana do obsługi szerokiego zakresu operacji związanych z plikami PDF, w tym dodawania numerów stron. IronPDF działa wewnętrznie na silniku Chromium, co pozwala mu oferować precyzyjne renderowanie treści HTML jako plików PDF. Dzięki prostemu API dodawanie numerów stron do plików PDF jest zarówno wydajne, jak i proste.

Poniższy kod stanowi przykład dodawania numerów stron przy użyciu IronPDF w języku C#:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";
        
        // Instantiate ChromePdfRenderer
        ChromePdfRenderer renderer = new ChromePdfRenderer()
        {
            // Set rendering options for page header
            RenderingOptions = {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>" // Page number format
                },
            }
        };

        // Render given HTML as PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

        // Save the resulting PDF with page numbers
        pdf.SaveAs("pageNumbers.pdf");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";
        
        // Instantiate ChromePdfRenderer
        ChromePdfRenderer renderer = new ChromePdfRenderer()
        {
            // Set rendering options for page header
            RenderingOptions = {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>" // Page number format
                },
            }
        };

        // Render given HTML as PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

        // Save the resulting PDF with page numbers
        pdf.SaveAs("pageNumbers.pdf");
    }
}

Imports IronPdf

Module Program
    Sub Main(args As String())
        Dim html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>"

        ' Instantiate ChromePdfRenderer
        Dim renderer As New ChromePdfRenderer() With {
            .RenderingOptions = New RenderingOptions With {
                .HtmlHeader = New HtmlHeaderFooter With {
                    .HtmlFragment = "<center><i>{page} of {total-pages}</i></center>" ' Page number format
                }
            }
        }

        ' Render given HTML as PDF
        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

        ' Save the resulting PDF with page numbers
        pdf.SaveAs("pageNumbers.pdf")
    End Sub
End Module

Imports IronPdf

Module Program
    Sub Main(args As String())
        Dim html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>"

        ' Instantiate ChromePdfRenderer
        Dim renderer As New ChromePdfRenderer() With {
            .RenderingOptions = New RenderingOptions With {
                .HtmlHeader = New HtmlHeaderFooter With {
                    .HtmlFragment = "<center><i>{page} of {total-pages}</i></center>" ' Page number format
                }
            }
        }

        ' Render given HTML as PDF
        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

        ' Save the resulting PDF with page numbers
        pdf.SaveAs("pageNumbers.pdf")
    End Sub
End Module

Wynik

Ten kod pokazuje, jak w prosty sposób wstawić numery stron w nagłówku dokumentu PDF. Obiekt HtmlHeaderFooter jest używany do specyfikacji treści nagłówka, a takie symbole zastępcze jak {page} i {total-pages} automatycznie wypełniają się numerem strony i całkowitą liczbą stron.

Dzięki takiemu podejściu IronPDF upraszcza proces renderowania HTML do formatu PDF, jednocześnie z łatwością zarządzając rozmieszczeniem numerów stron.

Jak dodać numery stron za pomocą PDFSharp

PDFSharp to kompleksowa biblioteka do pracy z plikami PDF w języku C#. Zapewnia narzędzia do tworzenia, modyfikowania i odczytywania plików PDF. Chociaż nie jest przeznaczony specjalnie do konwersji HTML na PDF, oferuje solidną kontrolę nad dokumentami PDF, w tym możliwość dodawania numerów stron przy użyciu niestandardowych zdarzeń stron. Niezależnie od tego, czy chcesz dodać numery stron tylko do pierwszej strony, drugiej strony, zakresu stron, czy po prostu do wszystkich.

Oto przykład dodawania numerów stron za pomocą PDFSharp:

using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
internal class Program
{
    static void Main(string[] args)
    {
        // Create a new PDF document
        var doc = new PdfDocument();
        doc.Info.Title = "Page Numbers Example";
        
        // Add a new page to the document
        PdfPage page = doc.AddPage();
        
        // Create graphics object for drawing
        var gfx = XGraphics.FromPdfPage(page);
        var font = new XFont("Arial", 12);
        
        // Draw page number in the footer
        gfx.DrawString("Page " + doc.PageCount, font, XBrushes.Black, new XPoint(500, 770));
        
        // Save the PDF file
        doc.Save("PdfSharpOutput.pdf");
    }
}

using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
internal class Program
{
    static void Main(string[] args)
    {
        // Create a new PDF document
        var doc = new PdfDocument();
        doc.Info.Title = "Page Numbers Example";
        
        // Add a new page to the document
        PdfPage page = doc.AddPage();
        
        // Create graphics object for drawing
        var gfx = XGraphics.FromPdfPage(page);
        var font = new XFont("Arial", 12);
        
        // Draw page number in the footer
        gfx.DrawString("Page " + doc.PageCount, font, XBrushes.Black, new XPoint(500, 770));
        
        // Save the PDF file
        doc.Save("PdfSharpOutput.pdf");
    }
}

Imports PdfSharp.Pdf
Imports PdfSharp.Pdf.IO
Imports PdfSharp.Drawing

Friend Class Program
    Shared Sub Main(args As String())
        ' Create a new PDF document
        Dim doc = New PdfDocument()
        doc.Info.Title = "Page Numbers Example"

        ' Add a new page to the document
        Dim page As PdfPage = doc.AddPage()

        ' Create graphics object for drawing
        Dim gfx = XGraphics.FromPdfPage(page)
        Dim font = New XFont("Arial", 12)

        ' Draw page number in the footer
        gfx.DrawString("Page " & doc.PageCount, font, XBrushes.Black, New XPoint(500, 770))

        ' Save the PDF file
        doc.Save("PdfSharpOutput.pdf")
    End Sub
End Class

Imports PdfSharp.Pdf
Imports PdfSharp.Pdf.IO
Imports PdfSharp.Drawing

Friend Class Program
    Shared Sub Main(args As String())
        ' Create a new PDF document
        Dim doc = New PdfDocument()
        doc.Info.Title = "Page Numbers Example"

        ' Add a new page to the document
        Dim page As PdfPage = doc.AddPage()

        ' Create graphics object for drawing
        Dim gfx = XGraphics.FromPdfPage(page)
        Dim font = New XFont("Arial", 12)

        ' Draw page number in the footer
        gfx.DrawString("Page " & doc.PageCount, font, XBrushes.Black, New XPoint(500, 770))

        ' Save the PDF file
        doc.Save("PdfSharpOutput.pdf")
    End Sub
End Class

Wynik

Wnioski

Podsumowując, IronPDF wyróżnia się możliwością łatwego dodawania numerów stron do istniejących dokumentów PDF za pomocą jednego zwięzłego bloku kodu, co daje pełną kontrolę nad tym, jak i gdzie wyświetlane są numery stron. Choć PDFSharp to wszechstronna opcja do tworzenia i manipulowania PDF z precyzyjną kontrolą, prowadzi to do bardziej manualnego, trudniejszego do zaimplementowania podejścia do dodawania numerów stron do plików PDF.

Dostępna jest komercyjna licencja IronPDF, która pozwala użytkownikom ocenić jego funkcje przed podjęciem decyzji o zakupie.

Aby uzyskać więcej informacji na temat IronPDF, odwiedź stronę dokumentacji, a w przypadku PDFSharp zajrzyj do repozytorium GitHub.