IronPDF Podrecznik Szybki Start

This article was translated from English: Does it need improvement?
Translated
View the article in English

Zainstaluj IronPDF i stworz swoj pierwszy PDF w zaledwie piec minut. Z jego prostym API możesz konwertować HTML, DOCX, obrazy i inne do doskonalych pikselowo PDFow.

1. Wymagania wstępne


2. Zainstaluj IronPDF

Standardowa instalacja IronPDF odbywa sie lokalnie. Jeśli chcesz wdrożyć w Docker/mikrousługach, zapoznaj sie z Podrecznikiem Trybu Zdalnego Silnika.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf
  2. Skopiuj i uruchom ten fragment kodu.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer
Menedzer Pakietow NuGet
Pobieranie DLL

Przejdz do biblioteki NuGet IronPDF:

  1. W Eksploratorze Rozwiązań kliknij prawym przyciskiem na Odwołania
  2. Wybierz 'Manage NuGet Packages' > 'Browse' > Wyszukaj IronPDF
Install-Package IronPdf
  • Pobierz pakiet DLL IronPDF
  • Wypakuj plik ZIP dla swojego systemu operacyjnego do lokalizacji w katalogu Rozwiązanie
  • W Eksploratorze Rozwiązan Visual Studio kliknij prawym przyciskiem myszy na 'Zaleznosci'
  • 'Dodaj Odwolanie do Projektu' > Wybierz 'Przeglądaj', aby dołączyć wszystkie DLLe wyodrebnione z zipa.

Przewodniki specyficzne dla platform


3. Zastosuj Klucz Licencyjny

Gdy kupisz licencje IronPDF lub zdecydujesz sie rozpoczac 30-dniowy okres próbny, klucz licencyjny zostanie wyslany na Twoj e-mail. Skopiuj klucz i dodaj go na początku swojej aplikacji.

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
$vbLabelText   $csharpLabel

4. Stworz Swoj Pierwszy PDF

Dodaj to na początku pliku .cs.

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel
Stworz Pusty PDF
Konwertuj Ciag HTML na PDF
Konwertuj DOCX na PDF

Najprostszym sposobem na stworzenie obiektu PDF jest uzycie tylko szerokosci i wysokosci. Ten konstruktor PdfDocument tworzy pusty plik PDF, gotowy do dostosowania.

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
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")
$vbLabelText   $csharpLabel

Korzystając z metody ChromePdfRenderer.RenderHtmlAsPdf, można przekształcić dowolny kod HTML (w tym HTML5) do formatu PDF przy użyciu wbudowanego silnika Chromium.

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");
using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");
Imports IronPdf

IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")
$vbLabelText   $csharpLabel

Konwertuj dokumenty WORD na PDF za pomocą klasy DocxToPdfRenderer. Możesz renderować pliki DOCX bezpośrednio do konfigurowalnych plików PDF w celu płynnej integracji z aplikacjami .NET.

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")
$vbLabelText   $csharpLabel

5. Bardziej Zaawansowane Przyklady

Oprócz prostego tworzenia i konwersji PDFow, IronPDF oferuje równiez bardziej zaawansowane opcje personalizacji PDFow.

Dodaj Nagłówki i Stopki
Redagowanie Tekstu
Laczenie PDFow

Aby utworzyć nagłówki lub stopki tekstowe, należy utworzyć instancję TextHeaderFooter, dodać tekst i dołączyć go do pliku PDF.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")
$vbLabelText   $csharpLabel

Z łatwością redaguj tekst, używając RedactTextOnAllPages, aby usunąć frazę z całego dokumentu.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")
$vbLabelText   $csharpLabel

Połącz dwa pliki PDF w języku C# za pomocą metody Merge. Użyj ReplaceTextOnAllPages w każdym PdfDocument, nowym lub zaimportowanym, aby zamienić stary tekst na nowy.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")
$vbLabelText   $csharpLabel

Szybkie Rozwiązywanie Problemow

Problem Rozwiązanie
Brak Visual C++ Runtime Zainstaluj Visual C++ Redistributable - wymagana zarowno wersja x86, jak i x64 dla silnika Chrome
Licencja nie jest rozpoznawana Zweryfikuj z właściwościa IronPdf.License.IsLicensed. Upewnij sie, ze licencja jest zastosowana przed jakakolwiek operacja IronPDF
Wolne pierwsze renderowanie Wyczekaj IronPdf.Installation.Initialize() podczas uruchamiania, aby wstepnie zainicjowac silniki renderowania
Zaleznosci Linux/Docker Ustaw Installation.LinuxAndDockerDependenciesAutoConfig = true dla automatycznej instalacji zalezności

Kolejne kroki


Często Zadawane Pytania

Jak skonfigurować IronPdfEngine do zdalnego generowania plików PDF?

Aby skonfigurować IronPdfEngine do zdalnego generowania plików PDF, zainstaluj pakiet IronPdf.Slim z NuGet i skonfiguruj ustawienia połączenia za pomocą klasy IronPdfConnectionConfiguration. Ta konfiguracja pozwala na zdalne połączenie aplikacji z instancją IronPdfEngine.

Jakie są główne zalety korzystania z IronPdfEngine w mojej aplikacji?

Wykorzystanie IronPdfEngine w aplikacji pozwala na zdalne wykonywanie zadań związanych z plikami PDF, co pomaga uniknąć problemów z kompatybilnością na konkretnych platformach, zwłaszcza na starszych systemach i platformach mobilnych. Eliminuje to również potrzebę korzystania ze środowiska uruchomieniowego .NET podczas wykonywania zadań.

Dłączego warto wybrać IronPdfEngine zamiast natywnej biblioteki PDF?

Możesz wybrać IronPdfEngine do zdalnego uruchamiania funkcji PDF wymagających dużej wydajności, co zmniejsza problemy z kompatybilnością z różnymi systemami operacyjnymi i poprawia wydajność dzięki wykorzystaniu renderera identycznego z Chrome do konwersji HTML na PDF.

Czy IronPdfEngine obsługuje skalowanie horyzontalne?

Nie, IronPdfEngine obecnie nie obsługuje skalowania poziomego, co oznacza, że nie można rozłożyć obciążenia na wiele instancji ze względu na sposób obsługi plików PDF w pamięci serwera.

Czy IronPdfEngine może działać na różnych systemach operacyjnych?

IronPdfEngine jest przeznaczony do działania w systemach Linux przy użyciu kontenerów Docker. Pliki binarne są jednak specyficzne dla danej platformy, dlatego należy upewnić się, że używana jest wersja odpowiednia dla danego systemu operacyjnego.

Co mam zrobić, jeśli moje pliki PDF wyglądają inaczej po użyciu IronPdfEngine?

Wyniki w formacie PDF mogą się nieznacznie różnić ze względu na różne zachowania systemów operacyjnych. Aby zminimalizować różnice, upewnij się, że używasz właściwego obrazu Docker i sprawdź, czy nie ma żadnych ustawień specyficznych dla systemu operacyjnego, które mogłyby wpłynąć na renderowanie.

Jak upewnić się, że moja aplikacja korzysta z właściwej wersji IronPdfEngine?

Aby zapewnić kompatybilność, każda wersja IronPDF wymaga odpowiedniej wersji IronPdfEngine. Należy pamiętać o jednoczesnej aktualizacji obu komponentów, aby uniknąć problemów związanych z różnicami między wersjami.

Jakie są ograniczenia związane z używaniem IronPdfEngine w systemie Windows?

Podczas korzystania z IronPdfEngine w systemie Windows potrzebne są kontenery Linux dla Docker i należy upewnić się, że port serwera jest dostępny. Pliki binarne są specyficzne dla platformy i wymagane jest przejście na kontenery Linux.

Jak skonfigurować IronPDF, aby połączyć się ze zdalnym serwerem IronPdfEngine?

Aby skonfigurować IronPDF dla serwera zdalnego, należy użyć metody Installation.ConnectToIronPdfHost z IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, podając adres IP serwera i szczegóły dotyczące portu.

Jakiego pakietu powinienem użyć, aby zminimalizować rozmiar aplikacji podczas korzystania z IronPdfEngine?

Należy użyć pakietu IronPdf.Slim z NuGet, ponieważ zawiera on tylko komponenty niezbędne do uruchomienia IronPDF z IronPdfEngine, co zmniejsza rozmiar aplikacji.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,926,724 | Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.