Jak tworzyć nowe pliki PDF w języku C# za pomocą IronPDF
IronPDF umožwia programistom C# tworzenie nowych dokumentów PDF programowo, używając konstruktora PdfDocument dla pustych PDFów, importując istniejące PDFy z różnych źródeł lub konwertując HTML, obrazy, RTF, Markdown, i XML na format PDF. Niezależnie od tego, czy chodzi o tworzenie raportów biznesowych, generowanie faktur czy tworzenie dynamicznych dokumentów na podstawie treści internetowych, IronPDF zapewnia narzędzia do generowania plików PDF w aplikacjach .NET.
PdfDocument jest spójne we wszystkich wspieranych środowiskach (.NET Framework 4.6.2+, .NET Core 3.1+, .NET 5 i nowsze), chociaż wydajność na starszych środowiskach różni się od poniższych benchmarków.Szybki start: Utwórz swój pierwszy plik PDF w języku C#
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-1.cs
// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);
// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");
// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
Imports IronPdf
' 1. Install IronPDF from NuGet
' 2. Create a blank PDF
Dim pdf As New PdfDocument(270, 270)
' 3. Or convert HTML to PDF
Dim renderer As New ChromePdfRenderer()
Dim pdfFromHtml As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>")
' 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf")
-
Install IronPDF with NuGet Package Manager
-
Skopiuj i uruchom ten fragment kodu.
new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf"); -
Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
Minimalny proces (5 kroków)
- Pobierz IronPDF z NuGet, aby tworzyć nowe pliki PDF
- Użyj konstruktora PdfDocument do stworzenia pustego PDF-a
- Importuj istniejący plik PDF z pliku, adresu URL, tablicy bajtów lub JSON
- Konwertuj wiele formatów do plików PDF, takich jak HTML, RTF, Markdown, obrazy i XML
- Eksportuj dokument PDF
Przykład tworzenia pustego PDF
Istnieje wiele sposobów tworzenia obiektu PDF. Zacznij od najprostszej metody, która wymaga jedynie podania szerokości i wysokości pliku PDF. Ten konstruktor PdfDocument tworzy nowy pusty PDF, gotowy do dostosowania i użycia. Wymiary są podane w punktach (1/72 cała), co pozwala na precyzyjne dopasowanie rozmiaru do różnych zastosowań, takich jak etykiety, wizytówki lub niestandardowe formaty dokumentów.
Dla programistów, którzy potrzebują większej kontroli nad wymiarami stron, IronPDF obsługuje niestandardowe rozmiary papieru oraz różne predefiniowane formaty, w tym rozmiary Letter, A4 i Legal. Możesz ustawić różne orientacje, korzystając z funkcji orientacji strony.
Jakie parametry są wymagane dla pustego pliku PDF?
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs.cs
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
Porównanie tworzenia plików PDF w różnych konfiguracjach
| Metryka | Pusta strona A4 | A4 + metadane | A4 (10 stron) | List | Niestandardowe (270×270) |
|---|---|---|---|---|---|
| Średni czas tworzenia | 266,6 ms | 279,4 ms | 287,2 ms | 262,4 ms | 280,6 ms |
| Rozmiar pliku wyjściowego | 0.60 KB | 3,82 KB | 1,79 KB | 0.60 KB | 0,60 KB |
| Pamięć na wywołanie | 1.62 MB | 1,61 MB | 1,64 MB | 1,61 MB | 1,62 MB |
| Utworzone strony | 1 | 1 | 10 | 1 | 1 |
Na podstawie tych wyników można bezpiecznie wywnioskować, że średni czas tworzenia pozostaje w granicach ~260–290 ms we wszystkich testowanych wariantach. Po utworzeniu pustego pliku PDF można go ulepszyć, dodając nagłówki i stopki, stosując znaki wodne lub wstawiając obrazy.
IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.
Jak zaimportować plik PDF?
Zanim PDF może być modyfikowany lub konwertowany, musi najpierw zostać zaimportowany jako obiekt PdfDocument. Użyj statycznej metody FromFile klasy PdfDocument, aby to osiągnąć. W tej samej klasie obsługiwane jest importowanie plików PDF z JSON, tablic bajtów, strumieni i adresów URL. Ta elastyczność sprawdza się w sytuacjach, w których trzeba połączyć wiele plików PDF, wyodrębnić konkretne strony lub zmodyfikować istniejące dokumenty.
Podczas pracy z plikami PDF przechowywanymi w usługach chmurowych IronPDF integruje się z Azure Blob Storage i innymi platformami chmurowymi. Można ładować pliki PDF ze strumieni pamięci w celu wydajnego przetwarzania bez dostępu do systemu plików.
Jakie metody importu są dostępne?
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-file.cs
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
pdf.SaveAs("export.pdf");
Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
pdf.SaveAs("export.pdf")
Po zaimportowaniu można wykonywać różne operacje, takie jak wyodrębnianie tekstu i obrazów, dodawanie adnotacji lub stosowanie podpisów cyfrowych.
Jak przekonwertować pliki z innych formatów?
Oprócz wspomnianych wcześniej metod uzyskiwania obiektu PdfDocument, można konwertować różne formaty na PDF. Najbardziej zaawansowaną metodą jest konwersja HTML do PDF, która renderuje HTML wraz ze wszystkimi jego zasobami — w tym JavaScript, obrazami, linkami i stylami CSS przy użyciu silnika Chrome. Oprócz HTML można konwertować inne formaty do plików PDF, takie jak obrazy, RTF, Markdown i XML.
Silnik renderujący Chrome IronPDF zapewnia doskonałe konwersje piksel-po-pikselu, które zachowują wizualną dokładność oryginalnej zawartości. Renderer obsługuje nowoczesne standardy internetowe, w tym HTML5, CSS3 i frameworki JavaScript, dzięki czemu nadaje się do konwersji złożonych stron internetowych lub widoków Razor do formatu PDF.
Poniższy fragment kodu pokazuje konwersję HTML do formatu PDF. Konwersja HTML używa silnika renderującego IronPDF, aby utrzymać integralność treści przy zastosowaniu całego stylu. Możesz również konwertować pliki Markdown na PDF, XML na PDF oraz obrazy na PDF.
Jakie opcje renderowania należy skonfigurować?
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-html.cs
using IronPdf;
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800);
renderer.RenderingOptions.WaitFor.RenderDelay(5000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Create a PDF from a URL or local file path
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
// Export to a file or Stream
pdf.SaveAs("url.pdf");
Imports IronPdf
' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800)
renderer.RenderingOptions.WaitFor.RenderDelay(5000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
' Create a PDF from a URL or local file path
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/")
' Export to a file or Stream
pdf.SaveAs("url.pdf")
Jakie formaty można konwertować do PDF?
IronPDF obsługuje konwersję z wielu formatów:
- HTML do PDF: Konwersja ciągów znaków HTML, plików HTML lub adresów URL z pełną obsługą CSS i JavaScript
- Obraz do PDF: Konwersja obrazów JPG, PNG, GIF, BMP i TIFF
- Formaty dokumentów: Konwersja plików DOCX i RTF
- Języki znaczników: Konwersja Markdown i XML
- Strony ASP.NET: Konwersja stron ASPX i Razor
Wygenerowany plik PDF można wyświetlić za pomocą wbudowanej przeglądarki PDF, jak pokazano tutaj. Poniższa ramka iframe wyświetla wynikowy plik PDF.
W przypadku zaawansowanych scenariuszy warto zapoznać się z renderowaniem stron WebGL, obsługą opóźnień JavaScript lub wdrażaniem niestandardowego logowania w celu rozwiązywania problemów związanych z konwersją.
Często Zadawane Pytania
Jak zainstalować bibliotekę, aby rozpocząć tworzenie plików PDF w języku C#?
Zainstaluj IronPDF za pomocą menedżera pakietów NuGet w Visual Studio. Możesz wyszukać „IronPDF” w interfejsie użytkownika menedżera pakietów NuGet lub użyć konsoli menedżera pakietów z poleceniem „Install-Package IronPdf”. Po zainstalowaniu możesz od razu zacząć tworzyć pliki PDF za pomocą konstruktóra PdfDocument lub klasy ChromePdfRenderer.
Jaki jest najszybszy sposób na utworzenie pustego dokumentu PDF?
Najszybszym sposobem na utworzenie pustego pliku PDF za pomocą IronPDF jest użycie konstruktóra PdfDocument z parametrami szerokości i wysokości: new IronPdf.PdfDocument(270, 270).SaveAs('blank.pdf'). Wymiary są określone w punktach (1/72 cała). Można również ustawić niestandardowe rozmiary stron, orientacje oraz dodać metadane, takie jak autor i tytuł.
Czy mogę przekonwertować treść HTML do formatu PDF?
Tak, IronPDF doskonale nadaje się do konwersji HTML na PDF za pomocą klasy ChromePdfRenderer. Wystarczy stworzyć instancję renderer i użyć metody RenderHtmlAsPdf(): var renderer = new IronPdf.ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf('<h1>Hello PDF!</h1>'). To wspiera pełne renderowanie HTML5, CSS3 i JavaScript.
Jakie formaty plików można konwertować do formatu PDF?
IronPDF obsługuje konwersję wielu formatów do PDF, w tym HTML, obrazów (JPG, PNG, GIF, BMP), dokumentów RTF, plików Markdown i XML. Każdy format ma określone metody — na przykład użyj RenderHtmlAsPdf() dla HTML, ImageToPdf() dla obrazów oraz specjalistycznych rendererów dla innych formatów.
Jak dodać niestandardowe metadane do dokumentów PDF?
Po utworzeniu obiektu PdfDocument za pomocą IronPDF należy uzyskać dostęp do właściwości MetaData, aby ustawić informacje niestandardowe: pdf.MetaData.Author = 'Twoje imię i nazwisko'; pdf.MetaData.Title = 'Tytuł dokumentu'; pdf.MetaData.CreationDate = DateTime.Now. Te metadane pomagają w organizacji dokumentów i ułatwiają ich wyszukiwanie.
Czy mogę importować istniejące pliki PDF z różnych źródeł?
IronPDF umożliwia importowanie istniejących plików PDF z różnych źródeł, w tym plików lokalnych, adresów URL, tablic bajtów lub danych JSON. Użyj PdfDocument.FromFile() dla plików lokalnych, FromUrl() dla plików PDF z sieci lub FromBytes() dla danych w postaci tablic bajtów. Umożliwia to pracę z istniejącymi dokumentami PDF i ich modyfikowanie.
Jak dodać wiele stron do dokumentu PDF?
Użyj metody AppendPage() na obiekcie PdfDocument, aby dynamicznie dodawać puste strony. IronPDF obsługuje również wstawianie stron w określonych miejscach, kopiowanie stron z innych plików PDF oraz łączenie wielu dokumentów PDF. Każda nowa strona dziedziczy domyślny rozmiar strony, chyba że określono inaczej.
Jakie rozmiary i orientacje stron są obsługiwane?
IronPDF obsługuje niestandardowe rozmiary papieru określone w punktach, a także predefiniowane formaty, takie jak Letter, A4 i Legal. Można ustawić orientację strony (pionową lub poziomą) oraz tworzyć dokumenty o mieszanych rozmiarach stron. Niestandardowe wymiary zapewniają precyzyjną kontrolę w przypadku specjalistycznych zastosowań, takich jak etykiety lub wizytówki.

