IronPDF upraszcza tworzenie nagłówków i stopek PDF poprzez konfigurację oparte na właściwościach oraz natywne wsparcie HTML, podczas gdy iText wymaga wdrożenia z PdfPageEventHelper z ręcznym obliczaniem współrzędnych dla dokładnego pozycjonowania.
Podczas tworzenia profesjonalnych dokumentów PDF — raportów biznesowych, faktur, dokumentacji technicznej — spójne nagłówki i stopki świadczą o jakości i wzmacniają wizerunek marki. Deweloperzy, którzy pracowali z iText, znają wyzwanie: dodawanie nagłówków i stopek oznacza pisanie obsługi zdarzeń strony, obliczanie współrzędnych i zarządzanie czcionkami na niskim poziomie. IronPDF stosuje zasadniczo inne podejście, pozwalając opisać to, co chcesz, zamiast określać każdy piksel. W niniejszym przewodniku omówiono obie biblioteki, aby umożliwić podjęcie świadomej decyzji dotyczącej kolejnego projektu.
Zanim przejdziemy do porównań, oto jak dodać IronPDF do projektu .NET 10. Użyj interfejsu CLI platformy .NET lub konsoli menedżera pakietów NuGet w programie Visual Studio:
dotnet add package IronPdf
# Or in the NuGet Package Manager Console:
# Install-Package IronPdfPo instalacji dodaj jednorazowe wywołanie klucza licencyjnego podczas uruchamiania aplikacji:
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"Pakiet IronPDF NuGet jest przeznaczony dla platformy .NET 8+ i zawiera wbudowany silnik Chromium, dzięki czemu nie są wymagane żadne dodatkowe zależności środowiskowe. Dostępna jest bezpłatna licencja próbna, dzięki czemu można przetestować IronPDF w swoim środowisku przed podjęciem ostatecznej decyzji.
Praca z iText wymaga wdrożenia klasy PdfPageEventHelper i nadpisania metody OnEndPage, aby dodać nagłówki i stopki. Podejście to wymaga bezpośredniej manipulacji obiektem PdfContentByte i precyzyjnych obliczeń współrzędnych. W odróżnieniu od nowoczesnych rozwiązań HTML do PDF, event-driven architektura iText wymaga głębokiego zrozumienia struktury PDF i systemów współrzędnych.
Układ współrzędnych zaczyna się od lewego dolnego rogu strony, co jest sprzeczne z tym, jak większość programistów postrzega układy stron. Jest to bezpośrednia konsekwencja sposobu, w jaki specyfikacja PDF definiuje przestrzeń współrzędnych strony. Za każdym razem, gdy zmienia się rozmiar strony — na przykład przy przejściu z formatu A4 na Letter — konieczne jest ponowne obliczenie każdej wartości współrzędnych. Dodanie podkreślenia pod nagłówkiem, wyśrodkowanie tekstu lub wyrównanie stopki do prawego marginesu wymaga podania konkretnych wartości liczbowych.
public class HeaderFooterEvent : PdfPageEventHelper
{
private readonly Font headerFont = new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD);
private readonly Font footerFont = new Font(Font.FontFamily.HELVETICA, 10);
public override void OnEndPage(PdfWriter writer, Document document)
{
PdfContentByte cb = writer.DirectContent;
// Add header text -- requires precise Y coordinate calculation
float headerY = document.PageSize.Height - 30;
ColumnText.ShowTextAligned(cb, Element.ALIGN_CENTER,
new Phrase("Company Report", headerFont),
document.PageSize.Width / 2, headerY, 0);
// Draw underline manually
cb.MoveTo(40, headerY - 5);
cb.LineTo(document.PageSize.Width - 40, headerY - 5);
cb.Stroke();
// Add footer with page number
string footerText = $"Page {writer.PageNumber}";
ColumnText.ShowTextAligned(cb, Element.ALIGN_RIGHT,
new Phrase(footerText, footerFont),
document.PageSize.Width - 40, 30, 0);
// Add date on left side
ColumnText.ShowTextAligned(cb, Element.ALIGN_LEFT,
new Phrase(DateTime.Now.ToString("MM/dd/yyyy"), footerFont),
40, 30, 0);
}
}
// Usage
PdfWriter writer = PdfWriter.GetInstance(document, stream);
writer.PageEvent = new HeaderFooterEvent();Imports iTextSharp.text
Imports iTextSharp.text.pdf
Public Class HeaderFooterEvent
Inherits PdfPageEventHelper
Private ReadOnly headerFont As Font = New Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)
Private ReadOnly footerFont As Font = New Font(Font.FontFamily.HELVETICA, 10)
Public Overrides Sub OnEndPage(writer As PdfWriter, document As Document)
Dim cb As PdfContentByte = writer.DirectContent
' Add header text -- requires precise Y coordinate calculation
Dim headerY As Single = document.PageSize.Height - 30
ColumnText.ShowTextAligned(cb, Element.ALIGN_CENTER,
New Phrase("Company Report", headerFont),
document.PageSize.Width / 2, headerY, 0)
' Draw underline manually
cb.MoveTo(40, headerY - 5)
cb.LineTo(document.PageSize.Width - 40, headerY - 5)
cb.Stroke()
' Add footer with page number
Dim footerText As String = $"Page {writer.PageNumber}"
ColumnText.ShowTextAligned(cb, Element.ALIGN_RIGHT,
New Phrase(footerText, footerFont),
document.PageSize.Width - 40, 30, 0)
' Add date on left side
ColumnText.ShowTextAligned(cb, Element.ALIGN_LEFT,
New Phrase(DateTime.Now.ToString("MM/dd/yyyy"), footerFont),
40, 30, 0)
End Sub
End Class
' Usage
Dim writer As PdfWriter = PdfWriter.GetInstance(document, stream)
writer.PageEvent = New HeaderFooterEvent()To ręczne pozycjonowanie staje się bardziej skomplikowane w przypadku różnych orientacji stron, niestandardowych rozmiarów papieru lub różnych wymagań dotyczących marginesów. W przypadku systemów produkcyjnych wymagających zgodności z PDF/A lub podpisów cyfrowych podejście ręczne powoduje znaczne obciążenie związane z utrzymaniem.
Powyższy kod pokazuje ręczną pracę wymaganą -- obliczasz dokładne współrzędne, zarządzasz czcionkami oddzielnie i obsługujesz renderowanie poprzez DirectContent. Każda zmiana projektu oznacza edycję stałych liczbowych rozrzuconych po całym procedurze obsługi zdarzeń.
Kiedy pojawia się zmiana w projekcie — przesunięcie logo, dostosowanie rozmiaru czcionki, przesunięcie daty do środka — programista musi prześledzić przesunięcia pikseli, aby zrozumieć, co należy zmienić. Nie ma warstwy wizualnej; sam kod jest jedyną specyfikacją układu. To sprawia, że przekazywanie zadań między programistami jest podatne na błędy i wydłuża czas potrzebny na wprowadzenie nawet drobnych zmian wizualnych.
IronPDF zmienia proces tworzenia nagłówków i stopek dzięki intuicyjnemu API. Zamiast implementować obsługę zdarzeń, możesz skonfigurować nagłówki i stopki poprzez proste ustawienia właściwości w ChromePdfRenderer. Takie podejście jest zgodne z nowoczesnymi praktykami programistycznymi w środowisku .NET i znacznie skraca czas potrzebny na opanowanie nowych umiejętności.
using IronPdf;
var renderer = new ChromePdfRenderer();
// Configure text header with multiple properties
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
CenterText = "Company Report",
LeftText = "CONFIDENTIAL",
RightText = DateTime.Now.ToString("MMMM yyyy"),
DrawDividerLine = true,
FontSize = 12,
FontFamily = "Arial",
Spacing = 5
};
// Configure text footer with dynamic placeholders
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
LeftText = "{date} {time}",
CenterText = "© 2024 Company Name",
RightText = "Page {page} of {total-pages}",
DrawDividerLine = true,
FontSize = 10,
Spacing = 10
};
// Set margins to ensure proper spacing
renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginBottom = 25;
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("report.pdf");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
' Configure text header with multiple properties
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "Company Report",
.LeftText = "CONFIDENTIAL",
.RightText = DateTime.Now.ToString("MMMM yyyy"),
.DrawDividerLine = True,
.FontSize = 12,
.FontFamily = "Arial",
.Spacing = 5
}
' Configure text footer with dynamic placeholders
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
.LeftText = "{date} {time}",
.CenterText = "© 2024 Company Name",
.RightText = "Page {page} of {total-pages}",
.DrawDividerLine = True,
.FontSize = 10,
.Spacing = 10
}
' Set margins to ensure proper spacing
renderer.RenderingOptions.MarginTop = 30
renderer.RenderingOptions.MarginBottom = 25
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("report.pdf")Opcje renderowania w IronPDF zapewniają precyzyjną kontrolę nad generowaniem plików PDF, zachowując jednocześnie czytelność kodu. To podejście oparte na właściwościach ułatwia utrzymywanie i modyfikowanie nagłówków oraz stopek bez konieczności zagłębiania się w niskopoziomową manipulację plikami PDF.
Różnica jest od razu widoczna — IronPDF automatycznie obsługuje pozycjonowanie, marginesy i renderowanie, zapewniając jednocześnie wbudowane symbole zastępcze dla treści dynamicznych. Silnik renderujący biblioteki w przeglądarce Chrome zapewnia idealną jakość obrazu, która odpowiada podglądowi HTML.
| Funkcja | iText | IronPDF |
|---|---|---|
| Metoda realizacji | Klasa PdfPageEventHelper | Właściwości RenderingOptions |
| Złożoność kodu | Ręczne obliczenia współrzędnych | Proste przypisywanie właściwości |
| Numery stron | Ręczne śledzenie za pomocą writer.PageNumber | Wbudowany symbol zastępczy {page} |
| Obsługa HTML | Ograniczone, wymaga XMLWorker | Wbudowana obsługa nagłówków HTML |
| Zarządzanie marginesami | Obliczenia ręczne | Automatyczne dostosowanie |
| Treści dynamiczne | Wymagana niestandardowa implementacja | Wstępnie zdefiniowane symbole zastępcze |
| Pierwsza strona inna | Złożona logika warunkowa | Właściwość FirstPageNumber |
| Krzywa uczenia się | Steep | Stopniowe |
Numeracja stron jest standardowym wymogiem dla dokumentów PDF. Z iText musisz ręcznie śledzić bieżący numer strony i całkowitą liczbę stron, co często wymaga podejścia dwufazowego, aby uzyskać dokładne obliczenia całkowitej liczby stron:
// iTextSharp approach with complete page numbering
public class CompleteHeaderFooterEvent : PdfPageEventHelper
{
private readonly PdfTemplate totalPageCount;
private readonly Font normalFont = new Font(Font.FontFamily.HELVETICA, 10);
public CompleteHeaderFooterEvent(PdfWriter writer)
{
// Create placeholder for total page count
totalPageCount = writer.DirectContent.CreateTemplate(30, 16);
}
public override void OnEndPage(PdfWriter writer, Document document)
{
PdfPTable footerTable = new PdfPTable(3);
footerTable.TotalWidth = document.PageSize.Width - document.LeftMargin - document.RightMargin;
footerTable.SetWidths(new float[] { 1, 1, 1 });
PdfPCell leftCell = new PdfPCell(new Phrase(DateTime.Now.ToString("dd/MM/yyyy"), normalFont));
leftCell.Border = Rectangle.NO_BORDER;
leftCell.HorizontalAlignment = Element.ALIGN_LEFT;
PdfPCell centerCell = new PdfPCell(new Phrase("Confidential", normalFont));
centerCell.Border = Rectangle.NO_BORDER;
centerCell.HorizontalAlignment = Element.ALIGN_CENTER;
PdfPCell rightCell = new PdfPCell();
rightCell.Border = Rectangle.NO_BORDER;
rightCell.HorizontalAlignment = Element.ALIGN_RIGHT;
Chunk pageNum = new Chunk($"Page {writer.PageNumber} of ", normalFont);
rightCell.AddElement(pageNum);
rightCell.AddElement(Image.GetInstance(totalPageCount));
footerTable.AddCell(leftCell);
footerTable.AddCell(centerCell);
footerTable.AddCell(rightCell);
footerTable.WriteSelectedRows(0, -1, document.LeftMargin,
document.PageSize.GetBottom(document.BottomMargin), writer.DirectContent);
}
public override void OnCloseDocument(PdfWriter writer, Document document)
{
ColumnText.ShowTextAligned(totalPageCount, Element.ALIGN_LEFT,
new Phrase(writer.PageNumber.ToString(), normalFont), 0, 0, 0);
}
}Imports System
Imports iTextSharp.text
Imports iTextSharp.text.pdf
' iTextSharp approach with complete page numbering
Public Class CompleteHeaderFooterEvent
Inherits PdfPageEventHelper
Private ReadOnly totalPageCount As PdfTemplate
Private ReadOnly normalFont As Font = New Font(Font.FontFamily.HELVETICA, 10)
Public Sub New(writer As PdfWriter)
' Create placeholder for total page count
totalPageCount = writer.DirectContent.CreateTemplate(30, 16)
End Sub
Public Overrides Sub OnEndPage(writer As PdfWriter, document As Document)
Dim footerTable As New PdfPTable(3)
footerTable.TotalWidth = document.PageSize.Width - document.LeftMargin - document.RightMargin
footerTable.SetWidths(New Single() {1, 1, 1})
Dim leftCell As New PdfPCell(New Phrase(DateTime.Now.ToString("dd/MM/yyyy"), normalFont))
leftCell.Border = Rectangle.NO_BORDER
leftCell.HorizontalAlignment = Element.ALIGN_LEFT
Dim centerCell As New PdfPCell(New Phrase("Confidential", normalFont))
centerCell.Border = Rectangle.NO_BORDER
centerCell.HorizontalAlignment = Element.ALIGN_CENTER
Dim rightCell As New PdfPCell()
rightCell.Border = Rectangle.NO_BORDER
rightCell.HorizontalAlignment = Element.ALIGN_RIGHT
Dim pageNum As New Chunk($"Page {writer.PageNumber} of ", normalFont)
rightCell.AddElement(pageNum)
rightCell.AddElement(Image.GetInstance(totalPageCount))
footerTable.AddCell(leftCell)
footerTable.AddCell(centerCell)
footerTable.AddCell(rightCell)
footerTable.WriteSelectedRows(0, -1, document.LeftMargin, document.PageSize.GetBottom(document.BottomMargin), writer.DirectContent)
End Sub
Public Overrides Sub OnCloseDocument(writer As PdfWriter, document As Document)
ColumnText.ShowTextAligned(totalPageCount, Element.ALIGN_LEFT, New Phrase(writer.PageNumber.ToString(), normalFont), 0, 0, 0)
End Sub
End ClassTen wzorzec wymaga utworzenia obiektu szablonu PDF jako symbolu zastępczego, a następnie uzupełnienia całkowitej liczby stron po zamknięciu dokumentu. Dwufazowa natura operacji jest nieoczywista dla osób nieobeznanych z wnętrznościami iText, a błędne ustawienia skutkują nieprawidłowymi liczbami stron w finalnym PDF.
IronPDF obsługuje numerację stron dzięki wbudowanym symbolom zastępczym i automatycznej obsłudze numerów stron:
using IronPdf;
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
LeftText = "{date} {time}",
CenterText = "Confidential -- Internal Use Only",
RightText = "Page {page} of {total-pages}",
DrawDividerLine = true,
FontSize = 10,
FontFamily = "Calibri",
Spacing = 8
};
// Skip numbering on cover page
renderer.RenderingOptions.FirstPageNumber = 0;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginTop = 30;
var pdf = renderer.RenderHtmlAsPdf(htmlContent);Imports IronPdf
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
.LeftText = "{date} {time}",
.CenterText = "Confidential -- Internal Use Only",
.RightText = "Page {page} of {total-pages}",
.DrawDividerLine = True,
.FontSize = 10,
.FontFamily = "Calibri",
.Spacing = 8
}
' Skip numbering on cover page
renderer.RenderingOptions.FirstPageNumber = 0
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.MarginTop = 30
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)Wbudowane symbole zastępcze obsługują {page}, {total-pages}, {date}, {time}, {html-title}, {pdf-title}, i {url}. Nie ma potrzeby stosowania skomplikowanej obróbki końcowej ani renderowania dwuetapowego. Biblioteka oblicza wewnętrzną liczbę stron i automatycznie wstawia ją w każdym miejscu zastępczym.
W przypadku układów zawierających logo firmowe, stylizowaną typografię lub uporządkowane tabele nagłówki HTML zapewniają znacznie większą elastyczność niż nagłówki tekstowe. IronPDF wyróżnia się tutaj dzięki natywnej obsłudze nagłówków i stopek HTML:
using IronPdf;
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
HtmlFragment = @"
<div style='width: 100%; display: flex; justify-content: space-between; align-items: center; padding: 10px 0;'>
<img src='logo.png' style='height: 40px;'>
<div style='text-align: center;'>
<h2 style='margin: 0; color: #2c3e50;'>Annual Report 2024</h2>
<p style='margin: 0; font-size: 12px; color: #7f8c8d;'>Financial Performance & Strategic Overview</p>
</div>
<div style='text-align: right; font-size: 11px; color: #95a5a6;'>
Document ID: AR-2024-001<br>
Classification: Public
</div>
</div>",
MaxHeight = 80,
DrawDividerLine = true,
BaseUrl = new Uri(System.IO.Path.GetFullPath("assets/")).AbsoluteUri
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
HtmlFragment = @"
<table style='width: 100%; font-size: 10px; color: #34495e;'>
<tr>
<td style='width: 33%; text-align: left;'>Generated: {date} at {time}</td>
<td style='width: 34%; text-align: center;'>Page {page} of {total-pages}</td>
<td style='width: 33%; text-align: right;'>Annual Report 2024</td>
</tr>
</table>",
MaxHeight = 30,
DrawDividerLine = true
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("annual-report.pdf");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
.HtmlFragment = "
<div style='width: 100%; display: flex; justify-content: space-between; align-items: center; padding: 10px 0;'>
<img src='logo.png' style='height: 40px;'>
<div style='text-align: center;'>
<h2 style='margin: 0; color: #2c3e50;'>Annual Report 2024</h2>
<p style='margin: 0; font-size: 12px; color: #7f8c8d;'>Financial Performance & Strategic Overview</p>
</div>
<div style='text-align: right; font-size: 11px; color: #95a5a6;'>
Document ID: AR-2024-001<br>
Classification: Public
</div>
</div>",
.MaxHeight = 80,
.DrawDividerLine = True,
.BaseUrl = New Uri(System.IO.Path.GetFullPath("assets/")).AbsoluteUri
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
.HtmlFragment = "
<table style='width: 100%; font-size: 10px; color: #34495e;'>
<tr>
<td style='width: 33%; text-align: left;'>Generated: {date} at {time}</td>
<td style='width: 34%; text-align: center;'>Page {page} of {total-pages}</td>
<td style='width: 33%; text-align: right;'>Annual Report 2024</td>
</tr>
</table>",
.MaxHeight = 30,
.DrawDividerLine = True
}
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("annual-report.pdf")
Z iText, osiągnięcie nagłówków HTML wymaga dodania rozszerzenia XMLWorker i napisania skomplikowanego kodu do analizy. Ograniczona obsługa CSS przez bibliotekę utrudnia tworzenie nowoczesnych układów, które działają niezawodnie na różnych formatach papieru. Obrazy, układy elastyczne i czcionki internetowe wymagają rozwiązań, które znacznie zwiększają złożoność kodu.
Wiele profesjonalnych dokumentów wymaga innego nagłówka na stronie tytułowej — dużego logo na stronie tytułowej, a następnie kompaktowego nagłówka na kolejnych stronach. IronPDF obsługuje ten wzorzec poprzez warunkowy kod HTML i CSS:
using IronPdf;
var renderer = new ChromePdfRenderer();
string firstPageHeader = @"
<div style='text-align: center; padding: 20px 0;'>
<img src='logo-large.png' style='height: 80px; margin-bottom: 10px;'>
<h1 style='margin: 0; color: #2c3e50;'>2024 Annual Report</h1>
<h3 style='margin: 5px 0; color: #7f8c8d;'>Fiscal Year Ending December 31, 2024</h3>
</div>";
string subsequentPageHeader = @"
<div style='display: flex; justify-content: space-between; align-items: center;'>
<img src='logo-small.png' style='height: 30px;'>
<span>Annual Report 2024</span>
<span>Page {page}</span>
</div>";
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
HtmlFragment = $@"
<style>
.first-page {{display: none;}}
.other-pages {{display: block;}}
@page:first {{
.first-page {{display: block;}}
.other-pages {{display: none;}}
}}
</style>
<div class='first-page'>{firstPageHeader}</div>
<div class='other-pages'>{subsequentPageHeader}</div>",
MaxHeight = 100
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("report-with-cover.pdf");Takie podejście pozwala zachować definicję nagłówka w jednym miejscu, co ułatwia jednoczesną aktualizację zarówno okładki, jak i nagłówków wewnątrz publikacji. Można również zapoznać się z asynchronicznym renderowaniem plików PDF w scenariuszach wymagających dużej przepustowości.
Wydajność ma kluczowe znaczenie podczas generowania dużych dokumentów lub jednoczesnego przetwarzania wielu plików PDF. Silnik renderujący IronPDF dla przeglądarki Chrome zapewnia kilka korzyści w przypadku obciążeń produkcyjnych:
PdfContentByteusing IronPdf;
public async Task GenerateReportsAsync(List<ReportData> reports)
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
CenterText = "Monthly Report",
DrawDividerLine = true
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
RightText = "Page {page} of {total-pages}",
DrawDividerLine = true
};
// Disable JavaScript if not required for faster rendering
renderer.RenderingOptions.EnableJavaScript = false;
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
var tasks = reports.Select(async report =>
{
string html = await GenerateHtmlAsync(report);
return await renderer.RenderHtmlAsPdfAsync(html);
});
PdfDocument[] pdfs = await Task.WhenAll(tasks);
}Imports IronPdf
Public Async Function GenerateReportsAsync(reports As List(Of ReportData)) As Task
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "Monthly Report",
.DrawDividerLine = True
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
.RightText = "Page {page} of {total-pages}",
.DrawDividerLine = True
}
' Disable JavaScript if not required for faster rendering
renderer.RenderingOptions.EnableJavaScript = False
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
Dim tasks = reports.Select(Async Function(report)
Dim html As String = Await GenerateHtmlAsync(report)
Return Await renderer.RenderHtmlAsPdfAsync(html)
End Function)
Dim pdfs As PdfDocument() = Await Task.WhenAll(tasks)
End FunctionModel licencjonowania IronPDF oferuje przyjazne dla komercyjne warunki w porównaniu do licencji AGPL iText, która wymaga otwartego kodu źródłowego twojej aplikacji, chyba że kupisz oddzielną komercyjną licencję iText. W przypadku systemów produkcyjnych IronPDF zapewnia:
Dla programistów obeznanych z systemem obsługi zdarzeń strony iText, występuje okres dostosowawczy, ale dokumentacja i przykłady IronPDF czynią to zarządzalnym. Możliwość użycia CSS do stylizacji i HTML do układu otwiera możliwości, które wymagałyby rozbudowanego własnego kodu w iText. Dokumentacja obejmuje:
Professional dokument layout requires precise margin control. IronPDF upraszcza to dzięki pomiarom w milimetrach — naturalnej jednostce dla układów drukarskich:
using IronPdf;
var renderer = new ChromePdfRenderer();
// Set margins in millimeters
renderer.RenderingOptions.MarginTop = 25.4; // 1 inch
renderer.RenderingOptions.MarginBottom = 25.4;
renderer.RenderingOptions.MarginLeft = 19.05; // 0.75 inch
renderer.RenderingOptions.MarginRight = 19.05;
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
CenterText = "Internal Report",
DrawDividerLine = true,
Spacing = 5
};
// Use print CSS media type for accurate page layout
// See MDN reference: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("margin-report.pdf");Imports IronPdf
Dim renderer As New ChromePdfRenderer()
' Set margins in millimeters
renderer.RenderingOptions.MarginTop = 25.4 ' 1 inch
renderer.RenderingOptions.MarginBottom = 25.4
renderer.RenderingOptions.MarginLeft = 19.05 ' 0.75 inch
renderer.RenderingOptions.MarginRight = 19.05
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "Internal Report",
.DrawDividerLine = True,
.Spacing = 5
}
' Use print CSS media type for accurate page layout
' See MDN reference: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("margin-report.pdf")Porównaj to z podejściem iText opartym na współrzędnych, gdzie musisz obliczyć położenia względem granicy strony i ręcznie zweryfikować, czy zawartość się nie nakłada na nagłówki lub stopki.
Dodawanie nagłówków i stopek do dokumentów PDF nie musi wiązać się ze skomplikowaną obsługą zdarzeń i obliczeniami współrzędnych. Podczas gdy podejście iText oferuje szczegółową kontrolę przez zdarzenia strony i bezpośrednią manipulację zawartością, IronPDF zapewnia bardziej intuicyjne rozwiązanie z konfiguracją opartą na właściwościach i natywną obsługą HTML.
Wybór staje się oczywisty, gdy weźmie się pod uwagę szybkość tworzenia oprogramowania, łatwość konserwacji oraz prostotę tworzenia profesjonalnie wyglądających dokumentów. Podejście IronPDF do nagłówków i stopek stanowi przykład nowoczesnego tworzenia plików PDF — wydajnego, a jednocześnie przystępnego. Dla zespołów, które stawiają na czystą architekturę i łatwy w utrzymaniu kod, API IronPDF dobrze wpisuje się w praktyki programistyczne .NET.
Główne zalety dla systemów produkcyjnych obejmują:
Zacznij od zainstalowania IronPDF za pośrednictwem NuGet, a następnie skorzystaj z przewodnika szybkiego startu, aby w ciągu kilku minut stworzyć swój pierwszy nagłówek i stopkę. Kiedy będziesz gotowy do przejścia do środowiska produkcyjnego, zapoznaj się z opcjami licencyjnymi, aby znaleźć plan odpowiadający Twoim wymaganiom wdrożeniowym. Jeśli napotkasz jakiekolwiek trudności podczas integracji, zespół wsparcia technicznego służy pomocą.
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.
