Pytanie: Czy można tworzyć PDF-y w ASP.NET z iText, i czy istnieje lepsza alternatywa? Tak -- iText to długo działająca biblioteka PDF .NET, ale IronPDF oferuje nowoczesne podejście HTML do PDF, które eliminuje potrzebę poznawania niskopoziomowych struktur dokumentów PDF. W niniejszym przewodniku porównano obie biblioteki, podając działające przykłady kodu, aby umożliwić wybór odpowiedniego narzędzia do danego projektu.
iText to port .NET biblioteki Java iText, oferujący programistyczne tworzenie PDF-ów przez swoją klasę dokumentu i manipulację niskopoziomową zawartością PDF. Chociaż potężny, używanie iText wymaga zrozumienia struktury dokumentu PDF, pracy z obiektami dokumentu i ręcznego pozycjonowania elementów przy użyciu współrzędnych i specyfikacji rozmiaru strony. API jest z konieczności rozbudowane — biblioteka ujawnia pełną złożoność specyfikacji PDF, co oznacza, że przed uzyskaniem dopracowanego wyniku trzeba się wiele nauczyć.
IronPDF stosuje inne podejście, skupiając się na konwersji HTML do PDF przy użyciu silnika renderującego Chrome. Programiści mogą generować pliki PDF przy użyciu znanego HTML i CSS, dzięki czemu tworzenie plików PDF jest tak proste, jak projektowanie strony internetowej. IronPDF obsługuje logikę generowania plików PDF w tle, umożliwiając tworzenie dokumentów o nowoczesnym wyglądzie i obsługujących JavaScript. Ponieważ proces renderowania oparty jest na silniku Chromium, każdy układ działający w nowoczesnej przeglądarce zostanie wiernie odwzorowany w pliku PDF — w tym flexbox, grid, czcionki internetowe i treści generowane przez JavaScript.
Praktycznym skutkiem tej różnicy architektonicznej jest to, że iText wynagradza deweloperów, którzy chcą mieć drobiazgową, współrzędną kontrolę nad każdym bajtem w pliku PDF, podczas gdy IronPDF wynagradza deweloperów, którzy chcą szybko produkować wizualnie eleganckie dokumenty, używając umiejętności, które już posiadają. W przypadku większości scenariuszy aplikacji internetowych — faktur, raportów, potwierdzeń zamówień i eksportu danych — podejście oparte na HTML jest szybsze w tworzeniu i łatwiejsze w utrzymaniu.
| Funkcja | iText | IronPDF |
|---|---|---|
| HTML do PDF | Ograniczone (poprzez dodatek XMLWorker) | Pełne renderowanie silnikiem Chrome |
| Obsługa CSS | Częściowe | Pełna obsługa CSS3 |
| Obsługa JavaScript | None | Tak (za pośrednictwem silnika Chrome) |
| Licencjonowanie | AGPL (wymagana licencja komercyjna) | Komercjalne, bez opłat licencyjnych |
| Krzywa uczenia się | Steep (wymagana znajomość API PDF) | Niski (wystarczy znajomość HTML/CSS) |
| Instalacja NuGet | Install-Package iTextSharp | Install-Package IronPdf |
| Zgodność z platformą .NET | .NET Framework, .NET Core | .NET 8, .NET 9, .NET 10, .NET Framework |
Instalacja każdej z bibliotek rozpoczyna się od uruchomienia menedżera pakietów NuGet. Dla iText zauważ, że nowsze wersje iText działają pod licencją AGPL, która wymaga albo open-source'owania twojej aplikacji, albo zakupu licencji komercyjnej:
# Install iTextSharp via Package Manager Console
Install-Package iTextSharpW przypadku IronPDF można zainstalować go za pomocą konsoli NuGet Package Manager Console, interfejsu CLI .NET lub poprzez bezpośrednie wyszukiwanie w interfejsie użytkownika NuGet w Visual Studio:
Po instalacji IronPDF jest gotowy do użycia za pomocą pojedynczego instrukcji using. Do podstawowego generowania plików PDF nie jest wymagana żadna dodatkowa konfiguracja. W przypadku zaawansowanych scenariuszy — takich jak ustawianie klucza licencyjnego, konfigurowanie opcji renderowania lub generowanie plików PDF w środowisku chmury — zapoznaj się z dokumentacją IronPDF. IronPDF obsługuje wdrożenia w systemach Linux, macOS i Windows, w tym środowiska kontenerowe działające w Dockerze lub Kubernetesie, co sprawia, że doskonale nadaje się do nowoczesnych aplikacji ASP.NET natywnych dla chmury.
Najprostszym sposobem na zrozumienie różnicy w API jest stworzenie prostego pliku PDF "Hello World" z wykorzystaniem obu bibliotek obok siebie.
Z iText pracujesz bezpośrednio z klasą Document i PdfWriter:
using iTextSharp.text;
using iTextSharp.text.pdf;
var memoryStream = new MemoryStream();
Document pdfDoc = new Document(PageSize.A4, 25, 25, 25, 15);
PdfWriter writer = PdfWriter.GetInstance(pdfDoc, memoryStream);
pdfDoc.Open();
var paragraph = new Paragraph("Hello World - PDF Document");
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16);
pdfDoc.Add(paragraph);
pdfDoc.Add(new Paragraph("Creating PDF documents with iTextSharp"));
pdfDoc.Close();
// Return as a downloadable file
var pdfBytes = memoryStream.ToArray();Imports iTextSharp.text
Imports iTextSharp.text.pdf
Dim memoryStream As New MemoryStream()
Dim pdfDoc As New Document(PageSize.A4, 25, 25, 25, 15)
Dim writer As PdfWriter = PdfWriter.GetInstance(pdfDoc, memoryStream)
pdfDoc.Open()
Dim paragraph As New Paragraph("Hello World - PDF Document")
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16)
pdfDoc.Add(paragraph)
pdfDoc.Add(New Paragraph("Creating PDF documents with iTextSharp"))
pdfDoc.Close()
' Return as a downloadable file
Dim pdfBytes As Byte() = memoryStream.ToArray()To wymaga znajomości, jak Document, PdfWriter, Paragraph i FontFactory współdziałają -- niebłaha inwestycja w naukę dla deweloperów nowych w generacji PDF.
W przypadku IronPDF równoważne zadanie wykorzystuje znany kod HTML:
using IronPdf;
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(@"
<h1>Hello World - PDF Document</h1>
<p>Creating PDFs with IronPDF is straightforward!</p>
");
var pdfBytes = pdf.BinaryData;Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("
<h1>Hello World - PDF Document</h1>
<p>Creating PDFs with IronPDF is straightforward!</p>
")
Dim pdfBytes = pdf.BinaryDataPodejście IronPDF pozwala na bezpośrednie pisanie kodu HTML, eliminując konieczność pracy z niskopoziomowymi elementami PDF. Klasa ChromePdfRenderer obsługuje całe renderowanie wewnętrznie przy użyciu silnika opartego na Chromium, zapewniając wynik z dokładnością co do piksela.
Dokumenty sformatowane ujawniają największą różnicę między tymi dwiema bibliotekami. Podczas generowania faktur, raportów lub dokumentów firmowych stylizacja oparta na CSS w IronPDF znacznie zmniejsza ilość wymaganego kodu.
using IronPdf;
var html = @"
<style>
body { font-family: Arial, sans-serif; margin: 0; }
.invoice-header { background: #4CAF50; color: white; padding: 20px; }
.invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
.invoice-table th, .invoice-table td {
border: 1px solid #ddd; padding: 8px; text-align: left;
}
.invoice-table th { background-color: #f2f2f2; }
.total { font-size: 18px; font-weight: bold; margin-top: 16px; }
</style>
<div class='invoice-header'>
<h1>Invoice #2024-001</h1>
<p>Due: March 15, 2024</p>
</div>
<table class='invoice-table'>
<tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
<tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
<tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
</table>
<p class='total'>Grand Total: $798</p>
";
var renderer = new ChromePdfRenderer();
var pdfDocument = renderer.RenderHtmlAsPdf(html);
var pdfBytes = pdfDocument.BinaryData;Imports IronPdf
Dim html As String = "
<style>
body { font-family: Arial, sans-serif; margin: 0; }
.invoice-header { background: #4CAF50; color: white; padding: 20px; }
.invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
.invoice-table th, .invoice-table td {
border: 1px solid #ddd; padding: 8px; text-align: left;
}
.invoice-table th { background-color: #f2f2f2; }
.total { font-size: 18px; font-weight: bold; margin-top: 16px; }
</style>
<div class='invoice-header'>
<h1>Invoice #2024-001</h1>
<p>Due: March 15, 2024</p>
</div>
<table class='invoice-table'>
<tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
<tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
<tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
</table>
<p class='total'>Grand Total: $798</p>
"
Dim renderer As New ChromePdfRenderer()
Dim pdfDocument = renderer.RenderHtmlAsPdf(html)
Dim pdfBytes = pdfDocument.BinaryDataOsiągnięcie podobnego wyniku z iText wymaga programistycznego skonstruowania każdego elementu wizualnego:
using iTextSharp.text;
using iTextSharp.text.pdf;
var output = new MemoryStream();
var document = new Document(PageSize.A4);
PdfWriter.GetInstance(document, output);
document.Open();
// Header -- manual font and color setup
var titleFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20,
new BaseColor(255, 255, 255));
var headerParagraph = new Paragraph("Invoice #2024-001", titleFont);
document.Add(headerParagraph);
// Table -- each cell must be created individually
PdfPTable table = new PdfPTable(4);
table.WidthPercentage = 100;
string[] headers = { "Item", "Quantity", "Unit Price", "Total" };
foreach (var h in headers)
{
var cell = new PdfPCell(new Phrase(h,
FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)));
cell.BackgroundColor = new BaseColor(242, 242, 242);
table.AddCell(cell);
}
table.AddCell("PDF License");
table.AddCell("1");
table.AddCell("$599");
table.AddCell("$599");
document.Add(table);
var totalFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14);
document.Add(new Paragraph("Grand Total: $798", totalFont));
document.Close();Imports iTextSharp.text
Imports iTextSharp.text.pdf
Dim output As New MemoryStream()
Dim document As New Document(PageSize.A4)
PdfWriter.GetInstance(document, output)
document.Open()
' Header -- manual font and color setup
Dim titleFont As Font = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20, New BaseColor(255, 255, 255))
Dim headerParagraph As New Paragraph("Invoice #2024-001", titleFont)
document.Add(headerParagraph)
' Table -- each cell must be created individually
Dim table As New PdfPTable(4)
table.WidthPercentage = 100
Dim headers As String() = {"Item", "Quantity", "Unit Price", "Total"}
For Each h As String In headers
Dim cell As New PdfPCell(New Phrase(h, FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)))
cell.BackgroundColor = New BaseColor(242, 242, 242)
table.AddCell(cell)
Next
table.AddCell("PDF License")
table.AddCell("1")
table.AddCell("$599")
table.AddCell("$599")
document.Add(table)
Dim totalFont As Font = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14)
document.Add(New Paragraph("Grand Total: $798", totalFont))
document.Close()Różnica jest wyraźna: IronPDF obsługuje CSS, nowoczesny HTML i JavaScript, podczas gdy iText wymaga ręcznego tworzenia każdego elementu, specyfikacji czcionek i budowy tabeli komórka po komórce. W przypadku aplikacji generujących duże ilości dokumentów i dziesiątki różnych szablonów różnica w objętości kodu z czasem znacznie się kumuluje.
Obie biblioteki obsługują generowanie plików PDF po stronie serwera dla aplikacji ASP.NET. Schemat zwracania pliku PDF jako odpowiedzi w postaci pliku do pobrania jest podobny niezależnie od tego, która biblioteka generuje dane. Kluczowe kwestie, które należy wziąć pod uwagę przy wdrażaniu, to zarządzanie pamięcią, bezpieczeństwo wątków oraz konfiguracja odpowiedzi. Obie biblioteki wykorzystują strumienie w pamięci, dlatego należy upewnić się, że duże pliki PDF nie są przechowywane w pamięci dłużej niż to konieczne. ChromePdfRenderer w IronPDF jest projektowany do tworzenia na żądanie, więc nie ma potrzeby martwić się o wspólny stan między równoczesnymi żądaniami.
using IronPdf;
using Microsoft.AspNetCore.Mvc;
[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
[HttpGet("invoice/{id}")]
public IActionResult GenerateInvoice(int id)
{
var html = BuildInvoiceHtml(id); // your HTML template
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;
var pdf = renderer.RenderHtmlAsPdf(html);
return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
}
private static string BuildInvoiceHtml(int id)
{
return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>";
}
}Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
<ApiController>
<Route("api/[controller]")>
Public Class PdfController
Inherits ControllerBase
<HttpGet("invoice/{id}")>
Public Function GenerateInvoice(id As Integer) As IActionResult
Dim html As String = BuildInvoiceHtml(id) ' your HTML template
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20
Dim pdf = renderer.RenderHtmlAsPdf(html)
Return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
End Function
Private Shared Function BuildInvoiceHtml(id As Integer) As String
Return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>"
End Function
End ClassDla projektów ASP.NET MVC (bez Core), zwróć FileResult w ten sam sposób. IronPDF obsługuje również generowanie plików PDF z adresów URL, co jest pomocne podczas konwersji istniejących stron internetowych zamiast tworzenia ciągów HTML.
Możesz również dodawać nagłówki i stopki, stosować podpisy cyfrowe, ustawiać ochronę hasłem lub łączyć wiele plików PDF za pomocą interfejsów API do edycji dokumentów IronPDF — wszystko to w ramach tego samego pakietu.
Migracja istniejącego projektu iText do IronPDF przebiega według prostego schematu:
Paragraph, PdfPTable i PdfPCell, zbuduj ciąg HTML lub załaduj plik HTML. Twoje istniejące arkusze stylów CSS i widoki częściowe Razor mogą być bezpośrednio wykorzystywane.PdfWriter.GetInstance(doc, stream) na new ChromePdfRenderer().RenderHtmlAsPdf(html).memoryStream.ToArray() na pdf.BinaryData.RenderingOptions i PdfDocument IronPDF.W przypadku zespołów posiadających już szablony HTML (pochodzące z generatorów wiadomości e-mail, widoków Razor lub Builderów raportów) migracja często może zostać zakończona w ciągu kilku godzin, a nie dni. IronPDF może renderować widoki Razor bezpośrednio do formatu PDF w ramach ASP.NET Core, co dodatkowo przyspiesza migrację. Zespoły, które zainwestowały w projektowanie dokumentów oparte na CSS — na przykład wykorzystując arkusze stylów drukowania do kontrolowania podziałów stron i marginesów — przekonają się, że te umiejętności można bezpośrednio przenieść do IronPDF.
Przejrzyj przewodnik migracyjny IronPDF dla szczegółowych wzorców obejmujących szyfrowanie, stemplowanie i inne zaawansowane funkcje iText.
Dla deweloperów rozpoczynających nowe projekty lub migrujących z iText, dotyczą następujące czynniki:
Licencjonowanie: iText używa licencji AGPL dla swoich nowszych wersji, co wymaga albo open-source'owania twojej aplikacji, albo zakupu komercyjnej licencji od iText Group. IronPDF oferuje proste licencjonowanie komercyjne bez zobowiązań open-source. Jeśli Twój projekt jest zamknięty lub komercyjny, samo to rozróżnienie może zadecydować o Twoim wyborze.
Krzywa uczenia się: Podejście IronPDF oparte na HTML oznacza mniej czasu poświęconego na naukę interfejsów API specyficznych dla formatu PDF. Jeśli Twój zespół zna HTML i CSS, generowanie plików PDF za pomocą IronPDF można rozpocząć natychmiast. Nie ma potrzeby zgłębiania systemów współrzędnych PDF, kodowania glifów ani osadzania czcionek — IronPDF zajmuje się tym wszystkim w sposób przejrzysty.
Zakres funkcji: IronPDF wspiera zgodność z PDF/A, wypełnianie formularzy, nakładanie znaków wodnych i więcej -- wszystko z jednej paczki NuGet. Zaawansowane funkcje, takie jak podpisy cyfrowe i scałanie plików PDF, są również dostępne bez dodatkowych zależności.
Ścieżka migracji: Przejście z iText do IronPDF polega na zastąpieniu kodu manipulacji dokumentami szablonami HTML i aktualizacji wywołania renderowania. Jakość wyników jest zazwyczaj wyższa, ponieważ IronPDF wykorzystuje pełny silnik przeglądarki, a wynikowy kod jest znacznie krótszy i łatwiejszy w utrzymaniu.
Aby zapoznać się z informacjami na temat działania silników renderujących pliki PDF oraz tego, co je odróżnia, warto zapoznać się z dokumentacją Mozilli dotyczącą plików PDF oraz zasobami Adobe dotyczącymi specyfikacji plików PDF. Oficjalna strona iText Group zawiera szczegółowy opis warunków licencji AGPL.
Aby rozpocząć korzystanie z IronPDF w projekcie ASP.NET:
Install-Package IronPdfusing IronPdf; do swojego plikuChromePdfRenderer i wywołaj RenderHtmlAsPdf() z twoim HTMLpdf.BinaryData jako FileResult z twojego kontroleraZapoznaj się z poniższymi zasobami, aby dowiedzieć się więcej:
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.
