IronPDF pozwala konwertować dokumenty do formatu PDF w aplikacjach C# za pomocą zaledwie kilku linii kodu. Obsługuje płynną konwersję plików HTML do PDF oraz obrazów do PDF na platformach Windows, Linux i macOS.
W tym artykułe pokazano, jak działa konwersja plików PDF przy użyciu IronPDF, biblioteki PDF dla platform .NET i .NET Core. Niezależnie od tego, czy pracujesz w systemie Windows, Linux czy macOS, IronPDF zapewnia obsługę wielu platform dla wszystkich Twoich potrzeb związanych z plikami PDF. Biblioteka oferuje obszerną dokumentację i samouczki, które pomogą Ci szybko rozpocząć pracę.
Niezależnie od tego, czy chcesz generować pliki PDF od podstaw, konwertować strony HTML, obrazy lub istniejące dokumenty do formatu PDF, czy też edytować istniejące pliki PDF, IronPDF oferuje proste interfejsy API do realizacji tych zadań. Biblioteka wykorzystuje silnik renderujący Chrome, aby zapewnić, że konwersje HTML wyglądają dokładnie tak, jak powinny. Pełną listę funkcji można znaleźć na stronie internetowej IronPDF Features Overview.
Zanim zagłębimy się w kod, skonfigurujmy nowy projekt aplikacji konsolowej w języku C#. Jeśli dopiero zaczynasz przygodę z programowaniem w .NET, przydatny może okazać się przewodnik szybkiego startu zawierający dodatkowe wskazówki dotyczące konfiguracji. Programiści F# mogą również korzystać z IronPDF przy zastosowaniu podejścia programowania funkcjonalnego.
Otwórz Visual Studio i utwórz nowy projekt, klikając Plik > Nowy > Projekt.
Menu Plik w programie Visual Studio zapewnia szybki dostęp do podstawowych funkcji zarządzania projektami, od tworzenia nowych projektów po klonowanie repozytoriów z systemów kontroli wersji.
Pojawi się nowe okno. Wybierz szablon Aplikacja konsolowa i kliknij Dalej na dole. Ten szablon jest idealny do nauki podstaw PDF przed przejściem do złożonych typów projektów, takich jak aplikacje Blazor lub ASP.NET MVC.
Szablon aplikacji konsolowej w Visual Studio stanowi punkt wyjścia do tworzenia wielopłatformowych aplikacji wiersza poleceń przy użyciu .NET Core.
W kolejnym oknie nadaj nazwę projektowi i wybierz lokalizację, a następnie kliknij Dalej. Rozważ uporządkowanie projektów w dedykowanym folderze, aby ułatwić dostęp do przykładów kodu i plików demonstracyjnych.
Krok 2: Konfiguracja nowego projektu aplikacji konsolowej z odpowiednimi ustawieniami nazewnictwa i lokalizacji dla aplikacji do konwersji plików PDF.
Wybierz docelowy framework i kliknij Utwórz. W przypadku nowoczesnych aplikacji należy używać platformy .NET 6 lub nowszej, aby uzyskać najlepszą wydajność i wsparcie. Najnowsze wersje oferują lepszą wydajność i funkcje asynchroniczne.
Ostatni krok podczas tworzenia nowej aplikacji konsolowej w Visual Studio, w którym wybiera się docelową platformę. Należy pamiętać, że .NET 5.0 jest oznaczony jako "Out of support" (brak wsparcia) — w bieżących projektach warto rozważyć użycie .NET 6.0 lub .NET 8.0.
Twój projekt jest gotowy. Zainstalujmy IronPDF.
IronPDF oferuje kilka metod instalacji. W tym przypadku użyjemy menedżera pakietów NuGet. Możesz zapoznać się z zaawansowanymi metodami instalacji dla konkretnych scenariuszy, w tym opcjami instalatora Windows oraz konfiguracjami dla systemu Linux.
W programie Visual Studio otwórz menu Narzędzia i najedź kursorem na opcję Menedżer pakietów NuGet.
Kliknij opcję Zarządzaj pakietami NuGet dla rozwiązań.
Menu Narzędzia w programie Visual Studio zapewnia dostęp do funkcji menedżera pakietów NuGet, które są niezbędne do zarządzania bibliotekami zewnętrznymi i zależnościami w projektach .NET.
Pojawi się nowe okno. Kliknij kartę Przeglądaj i wyszukaj "IronPDF".
Wybierz IronPDF i kliknij Instaluj. W przypadku mniejszych wdrożeń warto rozważyć IronPdf.Slim.
Można również zainstalować za pomocą konsoli menedżera pakietów:
Lub pobierz bezpośrednio ze strony IronPDF NuGet. W przypadku kontenerów zapoznaj się z przewodnikiem wdrażania Docker lub uruchom IronPDF jako kontener zdalny.
Przyjrzyjmy się konwersji różnych formatów dokumentów do formatu PDF. IronPDF oferuje szerokie możliwości renderowania w celu dostosowania wyników, w tym niestandardowe logowanie i monitorowanie wydajności.
Konwersja HTML do PDF jest niezwykle prosta dzięki IronPDF. Biblioteka obsługuje zaawansowane funkcje, takie jak nagłówki i stopki, podziały stron oraz niestandardowy CSS. Możesz obsługiwać układy Bootstrap i wdrażać zarządzanie plikami cookie dla treści wymagających uwierzytelnienia.
Oto jak przekonwertować plik HTML na PDF:
using IronPdf;
// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();
// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";
// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;
// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");
// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;
// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");
// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");Imports IronPdf
' Create an instance of the ChromePdfRenderer class.
Dim renderer As New ChromePdfRenderer()
' Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
' Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = True
' Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
' Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___"
' Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024
' Render the HTML file as a PDF document.
Dim pdf = renderer.RenderHtmlFileAsPdf("invoice.html")
' Optional: Add metadata
pdf.MetaData.Author = "Your Company"
pdf.MetaData.Keywords = "invoice, pdf, conversion"
pdf.MetaData.CreationDate = System.DateTime.Now
' Save the PDF document as an output file.
pdf.SaveAs("output.pdf")
' Alternative: Save with compression
pdf.CompressImages(80)
pdf.SaveAs("compressed-output.pdf")Ten kod przeksztalca plik HTML ("invoice.html") w dokument PDF. Tworzac ChromePdfRenderer, korzystasz z silnika Chromium, aby zapewnic dokladna konwersje, zachowujac wyglad swojej strony internetowej. Opcje renderowania pozwalaja ustawic wlasne marginesy i rozmiar papieru. Powstaly PDF jest zapisywany jako "output.pdf" za pomoca prostego wywolania SaveAs. Ten usprawniony proces sprawia, że konwersja HTML do PDF jest prosta w przypadku generowania plików PDF w języku C#.
W przypadku złożonych scenariuszy warto zapoznać się z konwersją adresów URL do formatu PDF, pracą z ciągami znaków HTML lub konwersją plików CSHTML w aplikacjach ASP.NET MVC. Możesz również renderować wykresy JavaScript i obsługiwać aplikacje Angular.
Przykład podstawowego szablonu faktury wyświetlonego w przeglądarce plików PDF, przedstawiający standardowe elementy faktury, w tym dane nadawcy/odbiorcy, wyszczególnione usługi i obliczenia cenowe
Aby ulepszyć generowanie plików PDF, rozważ dodanie numerów stron, spisu treści lub niestandardowych znaków wodnych. Możesz zoptymalizować wynik za pomocą linearyzacji, aby przyspieszyć wyświetlanie stron internetowych.
Przekonwertujmy obrazy na dokumenty PDF. Przy minimalnym nakładzie kodu można konwertować pliki JPEG, PNG, BMP i SVG. Biblioteka obsługuje również zaawansowane funkcje, takie jak rysowanie linii i prostokątów lub dodawanie tekstu i map bitowych do istniejących plików PDF.
IronPDF oferuje kompleksową bibliotekę C# do obsługi plików PDF, która umożliwia konwersję HTML do PDF, zapewnia kompatybilność między platformami oraz oferuje ponad 50 funkcji do manipulacji plikami PDF w aplikacjach .NET.
using IronPdf;
using System.IO;
using System.Linq;
// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));
// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();
// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;
// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);
// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale
// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");
// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");
// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");Imports IronPdf
Imports System.IO
Imports System.Linq
' Enumerate all PNG files from the specified directory.
Dim imageFiles = Directory.EnumerateFiles("assets").Where(Function(f) f.EndsWith(".png"))
' Create an instance of ImageToPdfConverter
Dim imageToPdf = New ImageToPdfConverter()
' Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4
' Set margins for professional appearance
imageToPdf.PaperMargins = New IronPdf.Imaging.PdfPaperMargins(25)
' Control image quality and compression
imageToPdf.ImageQuality = 90 ' 0-100 quality scale
' Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf")
' Alternative: Convert a single image with custom settings
Dim singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png")
singleImagePdf.SaveAs("single-image.pdf")
' Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo"
singleImagePdf.MetaData.Subject = "Brand Assets"
singleImagePdf.MetaData.CreationDate = DateTime.Now
singleImagePdf.SaveAs("logo-with-metadata.pdf")Ten kod pokazuje dwa podejścia: konwersję wielu plików PNG w trybie wsadowym oraz konwersję pojedynczego obrazu. Znajduje wszystkie pliki PNG w folderze zasobow i konwertuje je na PDF za pomoca ImageToPdfConverter.ImageToPdf. Wlasciwosc ImageBehavior kontroluje pozycjonowanie obrazu na stronie. Na koniec, zapisuje PDF za pomoca SaveAs.
Aby uzyskać zaawansowane możliwości obsługi obrazów, zapoznaj się z osadzaniem obrazów z usługi Azure Blob Storage lub pracą z obrazami zakodowanymi w Base64. Można również rasteryzować pliki PDF do obrazów w celu odwrotnej konwersji.
Strona główna biblioteki IronPDF przedstawia kluczowe funkcje, w tym konwersję HTML do PDF, obsługę wielopłatformową .NET Framework oraz widoczny przycisk "Bezpłatna 30-dniowa wersja próbna".
Oprócz podstawowej konwersji HTML i obrazów, IronPDF oferuje wiele zaawansowanych funkcji do kompleksowej pracy z plikami PDF. Biblioteka obsługuje operacje asynchroniczne i przetwarzanie równoległe w scenariuszach wymagających wysokiej wydajności.
IronPDF obsługuje konwersję z różnych formatów:
Po konwersji dokumentów do formatu PDF należy je wzbogacić o:
Aby uzyskać lepszą wydajność aplikacji:
IronPDF zapewnia kompleksową obsługę platform:
W tym artykułe omówiono konwersję plików PDF w języku C# na potrzeby zarządzania dokumentami i udostępniania ich. Dzięki C# i IronPDF możesz łatwo zintegrować funkcje PDF ze swoimi aplikacjami. Od generowania plików PDF po konwersję HTML, obrazów i istniejących dokumentów — IronPDF oferuje wszechstronne możliwości. Przykłady kodu pokazały, jak przy minimalnym wysiłku konwertować zarówno dokumenty HTML, jak i obrazy do formatu PDF.
Siła IronPDF leży w jego wszechstronnych funkcjach:
Jak widać, IronPDF upraszcza złożone zadania związane z plikami PDF, dzięki czemu jest cennym narzędziem dla programistów usprawniającym przetwarzanie dokumentów w aplikacjach .NET. Niezależnie od tego, czy tworzysz aplikacje internetowe, oprogramowanie desktopowe czy usługi w chmurze, IronPDF zapewnia narzędzia do profesjonalnego generowania plików PDF. Zestaw funkcji biblioteki obejmuje tworzenie, edycję, konwersję i zabezpieczanie dokumentów PDF.
Aby pobrać bibliotekę do konwersji plików PDF, odwiedź stronę pakietu NuGet dla IronPDF. Zapoznaj się również z samouczkiem dotyczącym konwersji HTML do PDF za pomocą IronPDF. Aby nauczyć się tego w praktyce, zapoznaj się z naszymi przykładami kodu i obszernymi samouczkami. Programiści korzystający z IronPDF mogą wybierać spośród różnych licencji dostosowanych do ich potrzeb. Dostępna jest bezpłatna wersja próbna. Pełne informacje na temat cen i licencji można znaleźć na stronie Informacje o licencjach IronPDF. Sprawdź dziennik zmian, aby zapoznać się z najnowszymi aktualizacjami i ulepszeniami.
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.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
