IronPDF Podrecznik Szybki Start
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
- .NET Framework 4.6.2+ LUB .NET Core 3.1+ LUB .NET 5+
- Visual C++ Redistributable (dla Windows).
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.
-
1Install IronPDF with NuGet Package Manager
-
2Skopiuj i uruchom ten fragment kodu.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
Przejdz do biblioteki NuGet IronPDF:
- W Eksploratorze Rozwiązań kliknij prawym przyciskiem na Odwołania
- Wybierz 'Manage NuGet Packages' > 'Browse' > Wyszukaj 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";Imports IronPdf
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"4. Stworz Swoj Pierwszy PDF
Dodaj to na początku pliku .cs.
using IronPdf;Imports IronPdfNajprostszym sposobem na stworzenie obiektu PDF jest uzycie tylko szerokosci i wysokosci. Ten PdfDocument konstruktor tworzy pusty PDF, gotowy do dostosowania.
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")Uzywajac metody ChromePdfRenderer.RenderHtmlAsPdf, mozna przeksztalcic dowolny HTML (wlacznie z HTML5) na PDF przy uzyciu wbudowanego silnika Chromium.
using IronPdf;
IronPdf.ChromePdfRenderer
.StaticRenderHtmlAsPdf("<p>Hello World</p>")
.SaveAs("string-to-pdf.pdf");Konwertuj dokumenty Word na PDF za pomoca klasy DocxToPdfRenderer, mozna renderowac pliki DOCX bezposrednio do dostosowywalnych PDF, co umozliwia bezproblemowa integracje z aplikacjami .NET.
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")5. Bardziej Zaawansowane Przyklady
Oprócz prostego tworzenia i konwersji PDFow, IronPDF oferuje równiez bardziej zaawansowane opcje personalizacji PDFow.
Tworz naglowki lub stopki tekstowe, inicjujac TextHeaderFooter, dodajac swoj tekst i dołączając go do 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")Redaguj tekst z latwoscia, uzywajac RedactTextOnAllPages, aby usunac fraze z calego dokumentu.
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")Polacz dwa pliki PDF w C# za pomoca metody Merge. Uzyj ReplaceTextOnAllPages na dowolnym PdfDocument, nowym lub zaimportowanym, aby zamienic 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");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")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ń.
Dlaczego 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 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ęczników.
