Format PDF (Portable Document Format) to powszechnie stosowany format plików, który zapewnia spójność prezentacji dokumentów na wszystkich platformach i urządzeniach. Dzięki stałemu układowi jest to idealny format do udostępniania dokumentów, umów, faktur i nie tylko. Pliki PDF są niezbędne w świecie korporacyjnym do tworzenia formalnej dokumentacji. Wraz z rosnącym zapotrzebowaniem na generowanie i edycję plików PDF pojawiło się kilka bibliotek, które upraszczają ten proces dla programistów.

W tym artykułe omówimy, jak dodać numery stron do pliku PDF za pomocą QuestPDF w języku C#, a także porównamy QuestPDF z IronPDF, aby pomóc Ci zdecydować, która biblioteka najlepiej odpowiada potrzebom Twojego projektu.

Czym jest IronPDF?

IronPDF to bogata w funkcje biblioteka stworzona dla ekosystemu .NET, zaprojektowana do wydajnego tworzenia, edycji i renderowania plików PDF. Wykorzystuje silnik oparty na Chromium, aby zapewnić precyzyjną konwersję HTML, CSS i JavaScript do dokumentów PDF. To sprawia, że jest to doskonały wybór dla programistów stron internetowych, którzy muszą konwertować treści HTML bezpośrednio do formatu PDF, zachowując oryginalny układ i styl.

Dzięki IronPDF możesz łatwo zintegrować funkcje PDF z aplikacjami .NET, w tym tworzyć niestandardowe nagłówki i stopki, dodawać nowe strony do plików PDF, osadzać obrazy i tabele oraz wykonywać zaawansowane operacje na plikach PDF, takie jak scałanie lub dzielenie dokumentów. Biblioteka obsługuje różne formaty i oferuje szeroki zakres opcji dostosowywania, dzięki czemu idealnie nadaje się do generowania profesjonalnych plików PDF na podstawie dynamicznych treści internetowych.

Najważniejsze cechy IronPDF:

• Umożliwia generowanie plików PDF bezpośrednio z kodu C#.
• Konwertuje strony internetowe, HTML i JavaScript na wysokiej jakości pliki PDF.
• Oferuje opcje dodawania niestandardowych elementów, takich jak nagłówki, stopki i znaki wodne.
• Ułatwia łączenie, dzielenie i edycję istniejących plików PDF.
• Działa płynnie z aplikacjami .NET, w tym frameworkami ASP.NET i MVC.

Aby dowiedzieć się więcej o możliwościach IronPDF i zapoznać się z bardziej zaawansowanymi przykładami, zajrzyj do oficjalnej dokumentacji tutaj.

Instalacja IronPDF

Aby dodać IronPDF do swojego projektu, użyj menedżera pakietów NuGet w Visual Studio. Możesz skorzystać z 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.

Czym jest QuestPDF?

QuestPDF to nowoczesna biblioteka .NET przeznaczona do generowania dokumentów PDF. Skupia się na zapewnieniu programistom elastycznego i wydajnego narzędzia do tworzenia plików PDF z języka C#. QuestPDF umożliwia intuicyjne i płynne podejście do projektowania dokumentów przy użyciu stylu deklaratywnego.

QuestPDF kładzie nacisk na prostotę, szybkość i wydajność, co czyni go doskonałym wyborem do generowania dynamicznych raportów i dokumentów. Biblioteka obsługuje również zaawansowane funkcje układu, niestandardowe style oraz łatwe w użyciu szablony.

Funkcje QuestPDF

• Łatwe w użyciu API do tworzenia złożonych dokumentów PDF.
• Obsługuje elastyczny układ i strukturyzację dokumentów, ustawianie domyślnych stron, elementów kolumn itp.
• Umożliwia łatwe stylizowanie elementów przy użyciu właściwości podobnych do CSS.
• Zapewnia obsługę obrazów, domyślnych ustawień stylu tekstu, tabel, kodów kreskowych, wykresów, kolumn, wierszy, wielu rodzajów stron i więcej.
• Doskonałe do tworzenia raportów, faktur i dokumentów opartych na danych.

Więcej szczegółów można znaleźć w dokumentacji QuestPDF.

Instalacja QuestPDF

Aby rozpocząć pracę z QuestPDF, zainstaluj go za pomocą wiersza poleceń NuGet:

Install-Package QuestPDF

Lub alternatywnie, za pośrednictwem menedżera pakietów NuGet:

Spowoduje to dodanie wymaganych bibliotek do projektu w celu generowania plików PDF za pomocą QuestPDF.

Dodawanie numerów stron za pomocą IronPDF

IronPDF oferuje łatwy sposób na dodawanie numerów stron do plików PDF. Poniższy kod pokazuje, jak to zrobić:

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        // HTML content for the PDF
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";

        // Set up the IronPDF renderer with header for page numbers
        ChromePdfRenderer renderer = new ChromePdfRenderer
        {
            RenderingOptions = 
            {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        };
        
        // Render the HTML as a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        
        // Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        // HTML content for the PDF
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";

        // Set up the IronPDF renderer with header for page numbers
        ChromePdfRenderer renderer = new ChromePdfRenderer
        {
            RenderingOptions = 
            {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        };
        
        // Render the HTML as a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        
        // Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf");
    }
}

Imports IronPdf

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

        ' Set up the IronPDF renderer with header for page numbers
        Dim renderer As New ChromePdfRenderer With {
            .RenderingOptions = New RenderingOptions With {
                .HtmlHeader = New HtmlHeaderFooter With {
                    .HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        }
        
        ' Render the HTML as a PDF
        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        
        ' Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf")
    End Sub
End Module

Imports IronPdf

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

        ' Set up the IronPDF renderer with header for page numbers
        Dim renderer As New ChromePdfRenderer With {
            .RenderingOptions = New RenderingOptions With {
                .HtmlHeader = New HtmlHeaderFooter With {
                    .HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        }
        
        ' Render the HTML as a PDF
        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        
        ' Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf")
    End Sub
End Module

Wynik

W tym kodzie tworzymy nagłówek HTML dla dokumentu PDF, gdzie {page} i {total-pages} reprezentują dynamiczne symbole zastępcze dla bieżącego numeru strony i łącznej liczby stron. Metoda RenderHtmlAsPdf konwertuje HTML na PDF. Ta funkcja pozwala na dynamiczne dostosowywanie stron w oparciu o długość dokumentu.

Jak dodać numery stron za pomocą QuestPDF

W programie QuestPDF dodawanie numerów stron można wykonać w podobny sposób. Poniżej znajduje się kod służący do dodawania numerów stron za pomocą QuestPDF:

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

class Program
{
    static void Main(string[] args)
    {
        // Set the license type for QuestPDF
        QuestPDF.Settings.License = LicenseType.Community;

        // Create a PDF document using the QuestPDF fluent API
        var document = Document.Create(container =>
        {
            // Define a page with content and a header with page numbers
            container.Page(page =>
            {
                page.Content().Text("Hello, QuestPDF!");

                // Add a centered header with page number and total pages
                page.Header().AlignCenter().Text(text =>
                {
                    text.Span("Page ");
                    text.CurrentPageNumber();
                    text.Span(" of ");
                    text.TotalPages();
                });
            });
        });

        // Generate and save the PDF document
        document.GeneratePdf("QuestPdfOutput.pdf");
    }
}

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

class Program
{
    static void Main(string[] args)
    {
        // Set the license type for QuestPDF
        QuestPDF.Settings.License = LicenseType.Community;

        // Create a PDF document using the QuestPDF fluent API
        var document = Document.Create(container =>
        {
            // Define a page with content and a header with page numbers
            container.Page(page =>
            {
                page.Content().Text("Hello, QuestPDF!");

                // Add a centered header with page number and total pages
                page.Header().AlignCenter().Text(text =>
                {
                    text.Span("Page ");
                    text.CurrentPageNumber();
                    text.Span(" of ");
                    text.TotalPages();
                });
            });
        });

        // Generate and save the PDF document
        document.GeneratePdf("QuestPdfOutput.pdf");
    }
}

Imports QuestPDF.Fluent
Imports QuestPDF.Infrastructure

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set the license type for QuestPDF
		QuestPDF.Settings.License = LicenseType.Community

		' Create a PDF document using the QuestPDF fluent API
		Dim document = Document.Create(Sub(container)
			' Define a page with content and a header with page numbers
			container.Page(Sub(page)
				page.Content().Text("Hello, QuestPDF!")

				' Add a centered header with page number and total pages
				page.Header().AlignCenter().Text(Sub(text)
					text.Span("Page ")
					text.CurrentPageNumber()
					text.Span(" of ")
					text.TotalPages()
				End Sub)
			End Sub)
		End Sub)

		' Generate and save the PDF document
		document.GeneratePdf("QuestPdfOutput.pdf")
	End Sub
End Class

Imports QuestPDF.Fluent
Imports QuestPDF.Infrastructure

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set the license type for QuestPDF
		QuestPDF.Settings.License = LicenseType.Community

		' Create a PDF document using the QuestPDF fluent API
		Dim document = Document.Create(Sub(container)
			' Define a page with content and a header with page numbers
			container.Page(Sub(page)
				page.Content().Text("Hello, QuestPDF!")

				' Add a centered header with page number and total pages
				page.Header().AlignCenter().Text(Sub(text)
					text.Span("Page ")
					text.CurrentPageNumber()
					text.Span(" of ")
					text.TotalPages()
				End Sub)
			End Sub)
		End Sub)

		' Generate and save the PDF document
		document.GeneratePdf("QuestPdfOutput.pdf")
	End Sub
End Class

Ten kod QuestPDF definiuje prosty dokument z numerem strony w nagłówku. Metody CurrentPageNumber() i TotalPages() są używane do dynamicznego generowania numeru strony w odniesieniu do każdej strony.

Wnioski

Podsumowując, zarówno IronPDF, jak i QuestPDF oferują skuteczne rozwiązania do dodawania numerów stron do plików PDF w języku C#. Jednak IronPDF zapewnia bardziej usprawnione i przyjazne dla użytkownika podejście. Jego elastyczność i łatwość obsługi sprawiają, że jest to idealny wybór dla programistów, którzy chcą dodawać numery stron lub edytować istniejące pliki PDF przy minimalnym wysiłku.

IronPDF jest dostępny do bezpłatnego użytku programistycznego, co pozwala programistom na eksperymentowanie i integrację go z projektami bez żadnych kosztów na etapie rozwoju. Gdy będziesz gotowy do wdrożenia, dostępne są licencje komercyjne dla tych opcji licencyjnych.

Wybierając IronPDF, programiści zyskują dostęp do niezawodnego i bogatego w funkcje narzędzia, które upraszcza tworzenie i edycję plików PDF, w tym wstawianie numerów stron, a dodatkową korzyścią jest stała konserwacja i aktualizacje.

Więcej informacji na temat bezpłatnej wersji IronPDF oraz licencji komercyjnych można znaleźć na oficjalnej stronie internetowej IronPDF.