C# Utwórz plik PDF programowo

Zanim przejdziemy dalej, powinniśmy zainstalować bibliotekę IronPdf w naszym projekcie. Możemy to osiągnąć na różne sposoby.

Metoda 1: Menedżer pakietów NuGet

Bibliotekę IronPdf C# można zainstalować z menedżera pakietów NuGet. Otwórz menedżera pakietów NuGet, klikając Narzędzia > Menedżer pakietów NuGet > Zarządzaj pakietami NuGet dla rozwiązania. Spowoduje to otwarcie Eksploratora rozwiązań menedżera pakietów NuGet.

Otwórz menedżera pakietów NuGet

Kliknij "Przeglądaj" i wpisz IronPdf w pasku wyszukiwania. Pojawi się następujący wynik. Wybierz IronPDF i kliknij przycisk Instaluj; rozpocznie się instalacja biblioteki.

Wyszukaj i zainstaluj pakiet IronPdf

Metoda 2: Konsola menedżera pakietów NuGet

Możemy użyć konsoli NuGet Package Manager Console, aby szybko zainstalować naszą bibliotekę. Instalacja nie wymaga żadnych uprawnień administracyjnych. Możesz użyć polecenia NuGet, aby zainstalować bibliotekę IronPdf w swoim projekcie.

Install-Package IronPdf

Zainstaluj pakiet IronPdf za pomocą wiersza poleceń

Metoda 3: Korzystanie z pliku DLL

Trzecim sposobem wykorzystania IronPDF w projekcie jest dodanie pliku DLL z biblioteki IronPDF. Możesz pobrać plik DLL.

• Pobierz plik ZIP z biblioteką DLL. Rozpakuj go do wybranego folderu.
• Otwórz projekt w Visual Studio. W oknie Solution Explorer kliknij prawym przyciskiem myszy opcję References i wybierz plik DLL IronPDF.

Zapoznaj się z bardziej szczegółowym przewodnikiem instalacji, aby dowiedzieć się, jak zainstalować IronPDF.

Przyjrzymy się wielu metodom tworzenia plików PDF przy użyciu IronPDF. Zobaczymy, jak łatwo jest używać prostych funkcji do tworzenia plików PDF. Zacznijmy od tworzenia plików PDF przy użyciu ciągu znaków HTML.

4.1. Tworzenie plików PDF programowo przy użyciu ciągu znaków HTML

W bibliotece IronPDF HTML jest używany do celów stylizacyjnych. Aby generować dokumenty PDF przy użyciu biblioteki IronPDF, musisz posiadać podstawową znajomość języka HTML.

Biblioteka IronPDF znacznie ułatwia przetwarzanie ciągów znaków HTML i konwertowanie ich do formatu PDF. Zobaczmy, jak to zrobić za pomocą kodu.

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// HTML content to be converted into a PDF
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// HTML content to be converted into a PDF
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' HTML content to be converted into a PDF
Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")

Ten kod wygeneruje plik PDF zawierający treść przechowywaną w zmiennej htmlString. W tym przykładzie kodu użyto funkcji RenderHtmlAsPdf. Ta funkcja konwertuje ciąg znaków HTML na dokument PDF.

Aby generować pliki PDF przy użyciu biblioteki IronPDF, musisz znać tagi HTML. Funkcja SaveAs służy do zapisania pliku PDF z wynikami. Poniżej można zobaczyć plik PDF z wynikami.

Wynik:

Plik wyjściowy w formacie PDF

4.2. Tworzenie plików PDF programowo przy użyciu plików HTML

Biblioteka IronPDF oferuje fantastyczną funkcję tworzenia plików PDF na podstawie plików HTML. IronPDF bezpośrednio konwertuje całą zawartość pliku HTML, w tym obrazy, CSS, formularze itp., na dokument PDF. Nie wymaga żadnych innych bibliotek ani funkcji do dalszego przetwarzania. IronPDF bezpośrednio konwertuje dowolny plik HTML na plik PDF.

Przyjrzyjmy się przykładowemu kodowi służącemu do tworzenia pliku PDF na podstawie pliku HTML:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert an HTML file to a PDF and save it
Dim pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")

Używamy funkcji RenderHtmlFileAsPdf do tworzenia plików PDF z plików HTML. Możesz podać lokalizację pliku HTML w parametrze funkcji lub umieścić plik HTML w folderze bin kodu źródłowego, dzięki czemu wystarczy podać nazwę pliku z rozszerzeniem w parametrze funkcji RenderHtmlFileAsPdf. Plik PDF z wynikami zostanie zapisany w folderze bin po uruchomieniu tego kodu. Funkcja SaveAs pomaga zapisywać utworzone pliki PDF.

4.3. Tworzenie plików PDF programowo przy użyciu adresów URL

Czasami w naszym programie musimy programowo tworzyć pliki PDF z adresu URL. Może to być bardzo techniczne zadanie, jeśli będziemy pisać wszystko od podstaw. IronPDF pomaga nam w tym, oferując doskonałą funkcję tworzenia plików PDF na podstawie adresów URL. Możesz użyć dowolnego adresu URL, aby utworzyć plik PDF.

Przyjrzyjmy się, jak to zrobić:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert a URL to a PDF and save it
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")

Powyższy kod utworzy plik PDF na podstawie parametru URL przekazanego do funkcji RenderUrlAsPdf. Ta funkcja tworzy plik PDF z podanego adresu URL. Gdybyś próbował wykonać to zadanie od podstaw, byłoby to bardzo skomplikowane, dlatego IronPDF oferuje programistom prosty proces konwersji dowolnego adresu URL do formatu PDF. Funkcja SaveAs służy do zapisywania plików wyjściowych w folderze bin. Aby ustawić format pliku na PDF, należy określić rozszerzenie .pdf za pomocą parametru nazwy pliku w funkcji SaveAs. W folderze projektu znajduje się folder bin. Wynik znajduje się poniżej.

Wynik:

Utwórz plik PDF z adresu URL

4.4. Tworzenie plików PDF programowo przy użyciu formularzy internetowych ASP.NET

ASP.NET to framework programistyczny po stronie serwera, który rozszerza funkcjonalność HTML i wspiera tworzenie stron internetowych w przeglądarce. Strony ASP.NET są napisane w HTML, CSS i JavaScript i mogą być kodowane jako pliki ASPX (.aspx). Formularze internetowe ASP.NET pozwalają tworzyć przyjazne dla użytkownika, bogate w funkcje strony internetowe, bankowość internetową, intranety i systemy księgowe.

Do konwersji formularzy internetowych ASP.NET do formatu PDF użyjemy biblioteki IronPDF. Początkowo wyświetlane jako strona internetowa, przekształcimy to w plik PDF do przeglądania i pobierania w przeglądarce internetowej. Do konwersji użyjemy klasy AspxToPdf biblioteki IronPDF.

Zobaczmy, jak to zrobić:

1. Utwórz projekt formularza internetowego ASP.NET w programie Visual Studio. Zalecana jest najnowsza wersja programu Visual Studio.
2. Zainstaluj bibliotekę IronPDF za pomocą menedżera pakietów NuGet lub pliku DLL, zgodnie z własnym wyborem. Możesz również użyć konsoli menedżera pakietów NuGet, aby ją zainstalować.
3. Teraz otwórz kod dowolnej strony internetowej ASPX, którą chcesz przekonwertować na plik PDF. W tym przypadku utworzymy plik PDF strony Default.aspx projektu.

Struktura projektu Web Form w Visual Studio

4. Otwórz plik Default.aspx.cs. Dodaj do pliku przestrzeń nazw IronPdf, która jest najważniejszym wierszem.

using IronPdf;

using IronPdf;

Imports IronPdf

5. Wpisz następujący wiersz kodu w funkcji Page_Load, aby utworzyć dokument PDF strony.

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)

I to wszystko! Utworzono plik PDF strony internetowej ASPX. Po uruchomieniu projektu w przeglądarce pojawi się plik PDF strony internetowej. Rezultat jest taki sam, jak w przypadku tworzenia pliku PDF poprzez naciśnięcie klawiszy Ctrl+P. W tym przypadku nie trzeba było naciskać klawiszy Ctrl+P, aby utworzyć plik PDF z pliku ASPX.

Zostało to zrealizowane po stronie serwera. W tym kodzie używamy klasy AspxToPdf biblioteki IronPDF. Funkcja RenderThisPageAsPdf tworzy plik PDF strony internetowej ASPX.

Powyższy kod pokazuje plik PDF w przeglądarce. Możemy pobrać plik PDF bezpośrednio do naszego systemu, dodając następujący wiersz kodu w funkcji Page_Load:

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment)

Ten kod pobierze plik PDF strony internetowej ASPX z systemu. Możemy również ustawić nazwę pliku PDF ASPX. Dostępnych jest wiele opcji modyfikacji i formatowania, takich jak nagłówki, stopki, opcje drukowania, jakość itp. Aby uzyskać więcej informacji, zapoznaj się z tym obszernym samouczkiem dotyczącym konwersji plików ASPX do formatu PDF.

Wynik:

Wynik renderowania pliku PDF po stronie serwera

Poznaj najnowszą technologię Microsoftu dla aplikacji Blazor do tworzenia plików PDF

4.5. Programowe tworzenie plików PDF z formatowaniem

Podczas tworzenia plików PDF większość problemów pojawia się podczas formatowania dokumentów PDF. Programowe formatowanie plików PDF nie jest łatwe. Teraz jednak mamy rozwiązanie w postaci IronPDF. IronPDF oferuje różne opcje formatowania, które pozwalają nam dostosować tworzony plik PDF. Zapewnia nam metody dodawania nagłówków, stopek, marginesów i wielu innych opcji formatowania.

Korzystanie z IronPDF pozwala nam ustawić orientację strony, rozmiar strony i tytuły. Obsługuje również zmianę rozmiaru czcionki, koloru czcionki, rodzaju czcionki oraz inne operacje związane z czcionkami. Możesz dodać stopki i nagłówki z linią oddzielającą i własnym tekstem. Przyjrzyjmy się, jak dostosowywać pliki PDF za pomocą IronPDF.

• Utwórz projekt konsolowy w języku C#. W zależności od wymagań można również utworzyć projekt GUI. Możesz również otworzyć istniejące projekty.
• Zainstaluj bibliotekę IronPDF za pomocą menedżera pakietów NuGet lub pliku DLL.
• Dodaj przestrzeń nazw IronPDF na początku pliku kodu.

Konfiguracja aplikacji została zakończona. Następnie dodaj następujący kod do pliku PDF:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.Title = "PDF Generated";
renderer.RenderingOptions.Zoom = 100;

// Margin Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

// Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "Header!";
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

// Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.Title = "PDF Generated";
renderer.RenderingOptions.Zoom = 100;

// Margin Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

// Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "Header!";
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

// Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

' Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40)
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.Title = "PDF Generated"
renderer.RenderingOptions.Zoom = 100

' Margin Settings
renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40

renderer.RenderingOptions.FirstPageNumber = 1

' Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = True
renderer.RenderingOptions.TextHeader.CenterText = "Header!"
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

' Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = True
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial
renderer.RenderingOptions.TextFooter.FontSize = 10
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}"
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"

' HTML content to be converted into a PDF
Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>"

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")

Ten fragment kodu służy do formatowania plików PDF. RenderingOptions jest podstawowym narzędziem do ustawiania różnych właściwości podczas tworzenia dokumentów PDF.

• renderer.RenderingOptions.TextHeader
  • Ten wiersz kodu służy do skonfigurowania nagłówka pliku PDF. Za pomocą tej linii kodu można uzyskać dostęp do większej liczby właściwości nagłówka.
• renderer.RenderingOptions.TextFooter
  • Ten wiersz kodu konfiguruje właściwości stopki, takie jak tekst, prawy i lewy margines stopki, rozmiar czcionki i wiele innych.
• renderer.RenderingOptions.PaperOrientation
  • Ten wiersz kodu umożliwia użytkownikowi ustawienie orientacji strony (poziomej lub pionowej) pliku PDF.
• renderer.RenderingOptions.Title
  • Możemy użyć tego wiersza, aby ustawić tytuł pliku PDF.

W ostatnich wierszach używamy funkcji RenderHtmlAsPdf do utworzenia pliku PDF na podstawie ciągu znaków HTML, ale możemy użyć pliku HTML, aby płynnie przekonwertować go do formatu PDF, zachowując bieżące formatowanie. Jest to bardzo przydatna funkcja IronPDF, która zapewnia pełną swobodę dostosowywania wszystkiego, co dotyczy dokumentów PDF.

Wynik:

Wyjście w formacie PDF z obsługą formatowania