C#'da Örnekteki iTextSharp ve IronPDF Kullanarak PDF'ye Baslik ve Altbilgi Ekleyin

C#'te PDF Belgelerine Başlık ve Altbilgi Ekleme

PDF belgelerine başlık ve altbilgi eklemek, profesyonel raporlar, faturalar ve iş belgeleri oluşturmak için gereklidir. Geliştiriciler, PdfPageEventHelper ve OnEndPage metodunu kullanarak iTextSharp çözümleri ararken, modern .NET kütüphanelerinin aynı sonuçları elde etmek için önemli ölçüde daha basit yaklaşımlar sunduğunu göreceklerdir.

Bu kılavuz, iText 7'nin geleneksel yaklaşımını IronPDF'nin özlü API'si ile karşılaştırarak, C# kullanarak PDF dosyalarına başlık ve altbilgi eklemeyi gösterir. Sonunda, yeni bir Document oluşturma işleminden nihai PDF dosyası oluşturulmasına kadar her iki uygulamayı da anlayacak ve projenizin gereksinimlerine en uygun yaklaşımı seçebileceksiniz.

Profesyonel Belgelerde PDF Başlık ve Altbilgiler Neden Önemlidir?

Başlıklar ve altbilgiler, profesyonel PDF belgelerinde kritik işlevler sağlar. Logo görüntüleri aracılığıyla tutarlı marka sunar, sayfa numaraları ile sayfa gezintisini etkinleştirir, önemli meta verileri (tarihler ve belge başlıkları gibi) gösterir ve zaman damgaları ve sürüm bilgileri ile belgenin otantikliğini sağlar.

Kurumsal ortamlarda, başlıklar ve altbilgiler genellikle yasal bir öneme sahiptir. Finansal raporlar, denetim izleme yolları için zaman damgaları gerektirir. Sözleşmeler, tamlığı sağlamak için sayfa numaralandırması gerektirir. İç belgelerde her sayfada gizlilik bildirimleri olması gerekebilir. Bu gereksinimleri programlı bir şekilde karşılamak, sayfa seviyesinde içerik enjeksiyonunu güvenilir bir şekilde yöneten bir PDF kütüphanesi gerektirir.

Başlık ve altbilgi eklemenin programlı olarak başlıca nedenleri şunlardır:

• Denetim uyumu -- her sayfadaki zaman damgaları ve sürüm numaraları düzenleyici gereksinimleri karşılar
• Marka tutarlılığı -- şirket logoları ve stil düzenleri tüm üretilen belgelerde birbiriyle uyumlu olarak uygulanır
• Gezinme -- sayfa numaraları ve bölüm başlıkları okuyucuların bilgiyi hızlı bir şekilde bulmalarını sağlar
• Otantiklik -- yazar adı, oluşturma tarihi ve belge kimliği belgenin bütünlüğü konusunda itirazları önler

C#'te Metin Başlığı ve Altbilgi Nasıl Eklersiniz?

IronPDF, .NET uygulamalarında PDF belgelerine başlık ve altbilgiler eklemek için en doğrudan yaklaşımı sağlar. ChromePdfRenderer sınıfını TextHeaderFooter veya HtmlHeaderFooter ile birleştirerek minimal kodla başlıklar ve alt bilgiler oluşturabilirsiniz; ayrı hücreler oluşturmanıza veya contentbyte nesnesini elle yönetmenize gerek yoktur.

Herhangi bir kod yazmadan önce, IronPDF'i projenize NuGet kullanarak ekleyin:

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

Kütüphane herhangi bir harici bağımlılık gerektirmez ve kurulumdan hemen sonra çalışır. Windows, Linux ve macOS'ta platforma özel yapılandırma gerektirmeden .NET 5, 6, 7, 8 ve 10'u hedefler.

Eski iTextSharp desenlerinde, geliştiriciler başlık ve alt bilgi mantığını elle enjekte etmek için private static void AddContent() gibi yardımcı yöntemler oluşturuyordu. IronPDF, tamamen bu tür şablon kodların gereğini ortadan kaldırır.

İşte bir PDF dosyasına hem metin başlığını hem de altbilgiyi ekleyen tam bir örnek:

using IronPdf;

// Initialize the PDF renderer
var renderer = new ChromePdfRenderer();

// Configure the text header
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Quarterly Sales Report",
    DrawDividerLine = true,
    FontSize = 14
};

// Configure the text footer with page number and date
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "{date}",
    RightText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};

// Set margins to accommodate header and footer
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Generate PDF from HTML content
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Data</h1><p>Content goes here...</p>");
pdf.SaveAs("report-with-headers.pdf");

using IronPdf;

// Initialize the PDF renderer
var renderer = new ChromePdfRenderer();

// Configure the text header
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Quarterly Sales Report",
    DrawDividerLine = true,
    FontSize = 14
};

// Configure the text footer with page number and date
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "{date}",
    RightText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};

// Set margins to accommodate header and footer
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Generate PDF from HTML content
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Data</h1><p>Content goes here...</p>");
pdf.SaveAs("report-with-headers.pdf");

Imports IronPdf

' Initialize the PDF renderer
Dim renderer = New ChromePdfRenderer()

' Configure the text header
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "Quarterly Sales Report",
    .DrawDividerLine = True,
    .FontSize = 14
}

' Configure the text footer with page number and date
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .LeftText = "{date}",
    .RightText = "Page {page} of {total-pages}",
    .DrawDividerLine = True,
    .FontSize = 10
}

' Set margins to accommodate header and footer
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25

' Generate PDF from HTML content
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Sales Data</h1><p>Content goes here...</p>")
pdf.SaveAs("report-with-headers.pdf")

TextHeaderFooter sınıfı, başlık veya alt bilgi alanının sol tarafına, ortasına veya sağına metin yerleştirmek için özellikler sağlar. DrawDividerLine özelliği, başlık veya alt bilginin ana belge içeriğiyle arasında profesyonel bir ayırıcı çizgisi ekler. {page}, {total-pages} ve {date} gibi birleştirilebilir alanlar, PDF oluşturulurken otomatik olarak dinamik değerlerle doldurulur.

IronPDF, kenar boşluklarının hesaplamalarını otomatik olarak gerçekleştirir ve başlıklar ile altbilgilerin belge içeriğinizle çakışmamasını sağlar. TextHeaderFooter sınıfı, size dış bağımlılıklar olmadan tipografi üzerinde kontrol sağlayarak IronSoftware.Drawing.FontTypes'den yazı tipi türlerini destekler.

HTML-Styled Başlıklar ve Altbilgiler Nasıl Eklenir?

Daha sofistike tasarımlar için, IronPDF'nin HtmlHeaderFooter sınıfı tam HTML ve CSS stilinı etkinleştirir. Bu yaklaşım, başlıkların bir resim logosu, karmaşık düzenler veya marka özelinde stilleri içermesi gerektiğinde özellikle değerlidir -- PdfPCell nesnelerini manuel olarak oluşturmadan veya new Phrase yapıcılarını kullanmadan.

using IronPdf;
using System;

var renderer = new ChromePdfRenderer();

// Create an HTML header with logo and styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='width: 100%; font-family: Arial, sans-serif;'>
            <img src='logo.png' style='height: 30px; float: left;' />
            <span style='float: right; font-size: 12px; color: #666;'>
                Confidential Document
            </span>
        </div>",
    MaxHeight = 25,
    DrawDividerLine = true,
    BaseUrl = new Uri(@"C:\assets\").AbsoluteUri
};

// Create an HTML footer with page numbering
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align: center; font-size: 10px; color: #999;'>
            <span>Generated on {date} at {time}</span>
            <br/>
            <span>Page {page} of {total-pages}</span>
        </div>",
    MaxHeight = 20
};

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginBottom = 25;

var pdf = renderer.RenderHtmlAsPdf("<h1>Project Proposal</h1><p>Document content...</p>");
pdf.SaveAs("styled-document.pdf");

using IronPdf;
using System;

var renderer = new ChromePdfRenderer();

// Create an HTML header with logo and styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='width: 100%; font-family: Arial, sans-serif;'>
            <img src='logo.png' style='height: 30px; float: left;' />
            <span style='float: right; font-size: 12px; color: #666;'>
                Confidential Document
            </span>
        </div>",
    MaxHeight = 25,
    DrawDividerLine = true,
    BaseUrl = new Uri(@"C:\assets\").AbsoluteUri
};

// Create an HTML footer with page numbering
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align: center; font-size: 10px; color: #999;'>
            <span>Generated on {date} at {time}</span>
            <br/>
            <span>Page {page} of {total-pages}</span>
        </div>",
    MaxHeight = 20
};

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginBottom = 25;

var pdf = renderer.RenderHtmlAsPdf("<h1>Project Proposal</h1><p>Document content...</p>");
pdf.SaveAs("styled-document.pdf");

Imports IronPdf
Imports System

Dim renderer As New ChromePdfRenderer()

' Create an HTML header with logo and styling
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .HtmlFragment = "
        <div style='width: 100%; font-family: Arial, sans-serif;'>
            <img src='logo.png' style='height: 30px; float: left;' />
            <span style='float: right; font-size: 12px; color: #666;'>
                Confidential Document
            </span>
        </div>",
    .MaxHeight = 25,
    .DrawDividerLine = True,
    .BaseUrl = New Uri("C:\assets\").AbsoluteUri
}

' Create an HTML footer with page numbering
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .HtmlFragment = "
        <div style='text-align: center; font-size: 10px; color: #999;'>
            <span>Generated on {date} at {time}</span>
            <br/>
            <span>Page {page} of {total-pages}</span>
        </div>",
    .MaxHeight = 20
}

renderer.RenderingOptions.MarginTop = 30
renderer.RenderingOptions.MarginBottom = 25

Dim pdf = renderer.RenderHtmlAsPdf("<h1>Project Proposal</h1><p>Document content...</p>")
pdf.SaveAs("styled-document.pdf")

Bu örnek kod, HTML başlıklarının resimleri metinlerle birleştirebileceğini gösterir. BaseUrl özelliği, göreli resim URL'lerini çözmek için kök yolu belirler, böylece şirket logolarını veya diğer grafiklerini dahil etmek kolaylaşır. MaxHeight özelliği, başlığın belirtilen boyutları aşmamasını sağlar, tutarlı belge düzenlerini korur.

HTML başlıklarında ve alt bilgilerinde birleştirilebilir alanlar ({page}, {total-pages}, {url}, {date}, {time}, {html-title}, {pdf-title}) aynı şekilde çalışarak ek kod gerektirmeden dinamik içerik eklemesi sağlar. Çeşitli başlık stillerinin uygulanmasına ilişkin rehberlik için, Başlıklar ve Altbilgiler Nasıl Yapılır Kılavuzuna bakın.

HTML yaklaşımı, markalı belgeler oluştururken parlaklık gösterir. Pazarlama ekipleri, geliştiricilerin doğrudan entegre ettiği HTML şablonları sağlayabilir, onaylanmış tasarımlarının piksel mükemmelliğini garanti eder. font-family, color, background-color ve border gibi CSS özellikleri beklenildiği gibi çalışır ve diğer kütüphanelerde geniş kapsamlı düşük seviyede kod gerektirecek sofistike görsel işlemlere olanak tanır.

Mevcut PDF Belgelerine Başlık Ekleme Nasıl Yapılır?

Yaygın bir gereksinim, zaten var olan PDF dosyalarına başlık ve altbilgiler eklenmesini içerir -- ister yüklenmiş belgeler, birleştirilmiş dosyalar veya diğer sistemler tarafından üretilmiş PDF'ler olsun. IronPDF, bu senaryoya AddHtmlHeaders ve AddHtmlFooters yöntemleri ile yaklaşır.

using IronPdf;

// Load an existing PDF document
var pdf = PdfDocument.FromFile("customer-profile.pdf");

// Define the header to add
var header = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>REVISED COPY - {date}</div>",
    MaxHeight = 20
};

// Define the footer to add
var footer = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: right;'>Page {page}</div>",
    MaxHeight = 15
};

// Apply headers and footers to all pages
pdf.AddHtmlHeaders(header);
pdf.AddHtmlFooters(footer);
pdf.SaveAs("document-with-new-headers.pdf");

using IronPdf;

// Load an existing PDF document
var pdf = PdfDocument.FromFile("customer-profile.pdf");

// Define the header to add
var header = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>REVISED COPY - {date}</div>",
    MaxHeight = 20
};

// Define the footer to add
var footer = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: right;'>Page {page}</div>",
    MaxHeight = 15
};

// Apply headers and footers to all pages
pdf.AddHtmlHeaders(header);
pdf.AddHtmlFooters(footer);
pdf.SaveAs("document-with-new-headers.pdf");

Imports IronPdf

' Load an existing PDF document
Dim pdf = PdfDocument.FromFile("customer-profile.pdf")

' Define the header to add
Dim header As New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align: center;'>REVISED COPY - {date}</div>",
    .MaxHeight = 20
}

' Define the footer to add
Dim footer As New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align: right;'>Page {page}</div>",
    .MaxHeight = 15
}

' Apply headers and footers to all pages
pdf.AddHtmlHeaders(header)
pdf.AddHtmlFooters(footer)
pdf.SaveAs("document-with-new-headers.pdf")

PdfDocument sınıfı, yüklü veya işlenmiş bir PDF'yi temsil eder ve sonradan yapılan değişiklikler için yöntemler sunar. Render etme ve modifikasyon arasındaki bu ayrım, PDF belgelerinin birden fazla işlem aşamasından geçtiği iş akışlarını mümkün kılar. AddHtmlHeaders yöntemi, başlığı otomatik olarak her sayfaya uygular, ancak sayfa dizinleri koleksiyonu geçirerek belirli sayfaları hedefleyebilirsiniz.

Farklı Sayfalara Farklı Başlıklar Nasıl Eklenir?

Bazı belgeler ilk sayfanın farklı bir başlığa (veya hiç başlığa) sahip olmasını gerektirir, sonraki sayfalar ise standart format kullanır. IronPDF, sayfa-dizin-tabanlı başlık uygulaması yoluyla bunu destekler -- void OnEndPage işleyicileri içinde koşulları kontrol etmenize veya döngü sayaçlarını manuel olarak yönetmenize gerek yoktur:

using IronPdf;
using System.Collections.Generic;
using System.Linq;
using System.Text;

var renderer = new ChromePdfRenderer();

// Build multi-page HTML with print page-breaks between pages
var pages = new List<string>
{
    "<section><h1>Title Page</h1><p>Intro text on page 1.</p></section>",
    "<section><h2>Report</h2><p>Detailed report content on page 2.</p></section>",
    "<section><h2>Appendix</h2><p>Appendix content on page 3.</p></section>"
};

var sb = new StringBuilder();
sb.AppendLine("<!doctype html><html><head><meta charset='utf-8'>");
sb.AppendLine("<style>");
sb.AppendLine("  body { font-family: Arial, sans-serif; margin: 20px; }");
sb.AppendLine("  .page-break { page-break-after: always; }");
sb.AppendLine("</style>");
sb.AppendLine("</head><body>");

for (int i = 0; i < pages.Count; i++)
{
    sb.AppendLine(pages[i]);
    if (i < pages.Count - 1)
        sb.AppendLine("<div class='page-break'></div>");
}
sb.AppendLine("</body></html>");

var pdf = renderer.RenderHtmlAsPdf(sb.ToString());

// Create the standard header for pages 2 onwards
var standardHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>Standard Header - Page {page}</div>",
    MaxHeight = 20
};

// Apply to all pages except the first (index 0)
var pageIndices = Enumerable.Range(1, pdf.PageCount - 1).ToList();
pdf.AddHtmlHeaders(standardHeader, 1, pageIndices);
pdf.SaveAs("document-skip-first-page-header.pdf");

using IronPdf;
using System.Collections.Generic;
using System.Linq;
using System.Text;

var renderer = new ChromePdfRenderer();

// Build multi-page HTML with print page-breaks between pages
var pages = new List<string>
{
    "<section><h1>Title Page</h1><p>Intro text on page 1.</p></section>",
    "<section><h2>Report</h2><p>Detailed report content on page 2.</p></section>",
    "<section><h2>Appendix</h2><p>Appendix content on page 3.</p></section>"
};

var sb = new StringBuilder();
sb.AppendLine("<!doctype html><html><head><meta charset='utf-8'>");
sb.AppendLine("<style>");
sb.AppendLine("  body { font-family: Arial, sans-serif; margin: 20px; }");
sb.AppendLine("  .page-break { page-break-after: always; }");
sb.AppendLine("</style>");
sb.AppendLine("</head><body>");

for (int i = 0; i < pages.Count; i++)
{
    sb.AppendLine(pages[i]);
    if (i < pages.Count - 1)
        sb.AppendLine("<div class='page-break'></div>");
}
sb.AppendLine("</body></html>");

var pdf = renderer.RenderHtmlAsPdf(sb.ToString());

// Create the standard header for pages 2 onwards
var standardHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>Standard Header - Page {page}</div>",
    MaxHeight = 20
};

// Apply to all pages except the first (index 0)
var pageIndices = Enumerable.Range(1, pdf.PageCount - 1).ToList();
pdf.AddHtmlHeaders(standardHeader, 1, pageIndices);
pdf.SaveAs("document-skip-first-page-header.pdf");

Imports IronPdf
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text

Dim renderer As New ChromePdfRenderer()

' Build multi-page HTML with print page-breaks between pages
Dim pages As New List(Of String) From {
    "<section><h1>Title Page</h1><p>Intro text on page 1.</p></section>",
    "<section><h2>Report</h2><p>Detailed report content on page 2.</p></section>",
    "<section><h2>Appendix</h2><p>Appendix content on page 3.</p></section>"
}

Dim sb As New StringBuilder()
sb.AppendLine("<!doctype html><html><head><meta charset='utf-8'>")
sb.AppendLine("<style>")
sb.AppendLine("  body { font-family: Arial, sans-serif; margin: 20px; }")
sb.AppendLine("  .page-break { page-break-after: always; }")
sb.AppendLine("</style>")
sb.AppendLine("</head><body>")

For i As Integer = 0 To pages.Count - 1
    sb.AppendLine(pages(i))
    If i < pages.Count - 1 Then
        sb.AppendLine("<div class='page-break'></div>")
    End If
Next
sb.AppendLine("</body></html>")

Dim pdf = renderer.RenderHtmlAsPdf(sb.ToString())

' Create the standard header for pages 2 onwards
Dim standardHeader As New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align: center;'>Standard Header - Page {page}</div>",
    .MaxHeight = 20
}

' Apply to all pages except the first (index 0)
Dim pageIndices = Enumerable.Range(1, pdf.PageCount - 1).ToList()
pdf.AddHtmlHeaders(standardHeader, 1, pageIndices)
pdf.SaveAs("document-skip-first-page-header.pdf")

AddHtmlHeaders içerisinde ikinci parametre, {page} birleştirilebilir alan için başlangıç sayfa numarasını belirtirken, üçüncü parametre başlığı alacak sayfa dizinlerini kabul eder. Bu ayrıntılı kontrol, karmaşık belge düzenlerini karmaşık koşullu mantık olmadan etkinleştirir. Gelişmiş Başlıklar ve Altbilgiler örneği, çift/eşit sayfa ayrımı dahil olmak üzere ek senaryoları kapsar.

Sayfa Numaralarının Ötesinde Dinamik İçerik Nasıl Uygulanır?

Birleştirilebilir alanlar sistemi, render sırasında otomatik olarak dolacak çeşitli dinamik değerleri destekler. Aşağıdaki tablo tüm mevcut alanları ve anlamlarını listeler: