1. IronPDF
  2. Poradniki
  3. Backgrounds & Foregrounds
How to Add Backgrounds & Foregrounds in PDFs

Jak dodac tlo i nakladke na pierwszym planie w plikach PDF przy uzyciu C

Curtis Chau
Curtis Chau
Zaktualizowano:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF umozliwia dodanie obrazu w tle lub pliku PDF za istniejaca zawartoscia oraz nakladanie elementow na pierwszym planie na wierzch. Tworz znaki wodne, naglowki dokumentow, pieczeci i adnotacje w swoich aplikacjach C#. Ta funkcja usprawnia dostosowywanie dokumentow, pozwalajac wzbogacac pliki PDF o profesjonalne elementy marki i wazne nakladki bez modyfikacji struktury oryginalnej zawartosci.

Dodaj tlo, aby wstawic obrazy lub dokumenty PDF jako warstwe w tle za istniejaca zawartoscia. Uzyj tej techniki do naglowkow dokumentow, znakow wodnych lub elementow dekoracyjnych. Utrzymuje spojnosc marki w dokumentach korporacyjnych, tworzy oficjalne formularze z gotowymi szablonami i dodaje subtelne funkcje zabezpieczen za glowna zawartoscia.

Nakladaj tresci na pierwszym planie, aby umieszczac tekst, obrazy lub inna zawartosc na wierzchu istniejacych plikow PDF. Powszechne zastosowania to dodawanie pieczeci 'POUFNE', pieczeci daty/godziny, podpisow zatwierdzen lub notatek specyficznych dla strony, ktore pojawiaja sie wyraznie nad zawartoscia dokumentu.

Zarowno funkcje tlo, jak i pierwszego planu dzialaja z plikami PDF w IronPDF. Zastosuj te ulepszenia do pojedynczych stron, wielu stron lub calych dokumentow, aby uzyskac pelna kontrole nad przebiegiem dostosowywania plikow PDF.

Szybki start: Dodaj tlo do swoich dokumentow PDF

Ulepsz swoje dokumenty PDF, dodajac tlo przy uzyciu IronPDF. Ten przewodnik pokazuje, jak wstawic pliki PDF jako warstwy tloczenia grafiki lub znaki wodne. Postepuj za przykladem kodu, aby zaczac. Najpierw zainstaluj IronPDF przez NuGet.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

    var pdf = new IronPdf.PdfDocument("input.pdf");
pdf.AddBackgroundPdf("background.pdf");
pdf.SaveAs("output.pdf");

  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Minimalny proces (5 kroków)

  1. Pobierz biblioteke IronPDF z NuGet
  2. Uzyj swiezo wygenerowanego lub istniejacego pliku PDF jako tla lub pierwszego planu.
  3. Uzyj metody AddBackgroundPdf, aby dodac tlo.
  4. Uzyj metody AddForegroundOverlayPdf, aby dodac nakladke na pierwszym planie.
  5. Okresl, na ktorych stronach ma byc zastosowane tlo lub pierwszy plan.


Jak dodac tlo do swojego PDF?

Uzyj metody AddBackgroundPdf, aby dodac tlo do nowego lub istniejacego dokumentu PDF. Poniższy przykład pokazuje, jak przekazac obiekt PdfDocument do metody. Mozesz rowniez okreslic sciezke do pliku, aby zaimportowac i dodac plik PDF jako tlo w jednym wierszu. Ta elastycznosc dziala zarówno z dynamicznie generowanymi tełami, jak i z wczesniej utworzonymi plikami szablonów.

IronPDF inteligentnie naklada zawartosc podczas dodawania teł. Twoj oryginalny tekst PDF i obrazy pozostana widoczne, gdy tlo pojawi sie za nimi. To sprawdza sie szczegolnie dobrze w przypadku przezroczystej lub polprzezroczystej oryginalnej zawartosci, gdyż tlo przelniknie odpowiednio. W przypadku skomplikowanych sytuacji z tlem exploruj funkcjonalnosc niestandardowych znakow wodnych dla pelniejszej kontroli nad przezroczystoscia i pozycjonowaniem.

Jaki jest kompletny kod dodawania tla?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add background
pdf.AddBackgroundPdf(background);

pdf.SaveAs("addBackground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Add background
pdf.AddBackgroundPdf(background)

pdf.SaveAs("addBackground.pdf")
$vbLabelText   $csharpLabel

Jak wyglada PDF z tlem?

Jak nakladac pierwszy plan na swoj PDF?

Podobnie jak przy dodawaniu teł, możesz okreslic sciezki do plików PDF, aby importowac dokumenty i nakladac je jako pierwszy plan. Uzyj metody AddForegroundOverlayPdf, aby nakladac pierwszy plan na glownych plikach PDF. Ta metoda efektywnie dodaje znaki wodne, pieczeci lub adnotacje, ktore pojawiaja sie nad zawartoscia dokumentu.

Funkcja nakladki na pierwszym planie wspiera rozne przypadki uzycia, od prostych nakladek tekstowych po zlozone elementy graficzne. Podczas tworzenia zawartosci pierwszego planu uzywaj transformacji CSS i ustawien przezroczystosci dla profesjonalnych rezultatow. Ta technika dziala bezproblemowo z konwersja HTML do PDF, pozwalajac projektowac nakladki uzywajac znanych technologii webowych.

Jaki jest kompletny kod nakladania pierwszego planu?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-foreground.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render foreground
PdfDocument foreground = renderer.RenderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 50%;'>Overlay Watermark</h1>");

// Overlay foreground
pdf.AddForegroundOverlayPdf(foreground);

pdf.SaveAs("overlayForeground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render foreground
Private foreground As PdfDocument = renderer.RenderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 50%;'>Overlay Watermark</h1>")

' Overlay foreground
pdf.AddForegroundOverlayPdf(foreground)

pdf.SaveAs("overlayForeground.pdf")
$vbLabelText   $csharpLabel

Jak wyglada nakladka na pierwszym planie?

Jak wybrac konkretne strony do tła lub pierwszego planu?

Wybierz, ktory z stron PDF ma byc uzyty jako twoje tlo lub pierwszy plan. Uzywając przykladu tła z sekcji 'Przyklad dodawania tła', generujemy dwustronny PDF z roznymi kolorami na tło. Okreslajac 1 jako drugi parametr w AddBackgroundPdf, uzywamy drugiej strony jako tło.

Ta funkcjonalnosc jest przydatna, gdy masz wielostronicowe szablony PDF i chcesz, aby rozne strony byly tlem dla roznych sekcji dokumentu. Na przyklad, szablony korporacyjne moga miec inne wzory dla stron tytulowych, stron zawartosci i dodatkow. Wybór stron działa dobrze z funkcjami manipulacji stronami PDF dla kompleksowej kontroli nad dokumentem.

PoradyWszystkie indeksy stron stosują indeksowanie od zera.

Jak uzyc konkretnej strony jako tło?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background-page-2.cs
using IronPdf;

string backgroundHtml = @"
<div style = 'background-color: cyan; height: 100%;'></div>
<div style = 'page-break-after: always;'></div>
<div style = 'background-color: lemonchiffon; height: 100%;'></div>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf(backgroundHtml);

// Use page 2 as background
pdf.AddBackgroundPdf(background, 1);

pdf.SaveAs("addBackgroundFromPage2.pdf");
Imports IronPdf

Private backgroundHtml As String = "
<div style = 'background-color: cyan; height: 100%;'></div>
<div style = 'page-break-after: always;'></div>
<div style = 'background-color: lemonchiffon; height: 100%;'></div>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf(backgroundHtml)

' Use page 2 as background
pdf.AddBackgroundPdf(background, 1)

pdf.SaveAs("addBackgroundFromPage2.pdf")
$vbLabelText   $csharpLabel

Jakie sa rezultaty uzycia konkretnej strony?

Jak zastosowac tlo lub pierwszy plan do konkretnych stron?

Zastosuj tła lub pierwszy plan do pojedynczych stron lub wielu stron uzywajac roznych nazw metod. Uzyj AddBackgroundPdfToPage i AddForegroundOverlayPdfToPage, aby dodac tła i nakladki pierwszego planu do okreslonych stron PDF. Te metody zapewniaja dokladna kontrole nad ulepszeniami dokumentow dla profesjonalnych dokumentow z roznymi ukladami na stronach.

Dla skomplikowanych dokumentow wymagajacych roznych traktowan na roznych stronach, polacz te metody z funkcjonalnoscia laczenia i dzielenia plikow PDF aby tworzic wyrafinowane przeplywy pracy nad dokumentami. To sprawdza sie szczegolnie dobrze przy generowaniu raportow, gdzie strony tytulowe, strony zawartosci i dodatki wymagaja roznego traktowania tla.

PoradyWszystkie indeksy stron stosują indeksowanie od zera.

Jak zastosowac do pojedynczej strony?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add background
pdf.AddBackgroundPdf(background);

pdf.SaveAs("addBackground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Add background
pdf.AddBackgroundPdf(background)

pdf.SaveAs("addBackground.pdf")
$vbLabelText   $csharpLabel

Jak zastosowac do wielu stron?

Podczas pracy z dokumentami wielostronicowymi, zastosuj tła lub nakladki pierwszego planu do okreslonych zakresow stron. Metoda AddBackgroundPdfToPageRange akceptuje liste indeksow stron dla pelnej elastycznosci wyboru, ktore strony otrzymaja ulepszenia. To podejscie dziala bezproblemowo z numeracja stron i innymi funkcjami organizacji dokumentow.

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-multiple-pages.cs
using IronPdf;
using System.Collections.Generic;

string html = @"<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> This is 3rd Page</p>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Create list of pages
List<int> pages = new List<int>() { 0, 2 };

// Add background to page 1 & 3
pdf.AddBackgroundPdfToPageRange(pages, background);

pdf.SaveAs("addBackgroundOnMultiplePage.pdf");
Imports IronPdf
Imports System.Collections.Generic

Private html As String = "<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> This is 3rd Page</p>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Create list of pages
Private pages As New List(Of Integer)() From {0, 2}

' Add background to page 1 & 3
pdf.AddBackgroundPdfToPageRange(pages, background)

pdf.SaveAs("addBackgroundOnMultiplePage.pdf")
$vbLabelText   $csharpLabel

Jak wyglada rezultat przy wielu stronach?

Najlepsze praktyki i zaawansowane wskazowki

Rozwaz te strategie optymalizacji przy wdrazaniu teł i pierwszego planu w przeplywach pracy nad PDF:

  1. Uwagi dotyczace wydajnosci: Przedrenderuj pliki PDF tla i pierwszego planu i ponownie wykorzystuj je w wielu operacjach dla duzych dokumentow. To poprawia wydajnosc w porownaniu z renderowaniem ich dla kazdego dokumentu.

  2. Zarzadzanie pamiecia: Wlasciwie usuwaj obiekty PdfDocument podczas przetwarzania wielu plikow PDF, aby uniknac wyciekow pamieci. Wdraża te funkcje w ramach using statements dla automatycznego czyszczenia zasobow.

  3. Zarzadzanie szablonami: Stworz biblioteke tla i szablonow pierwszego planu, ktore sa ladowane z dysku, zamiast generowane za kazdym razem. To dobrze wspolgra z funkcjami szablonu PDF dla spojnego stylu dokumentu.

  4. Przezroczystosc i warstwa: Uzywaj CSS przezroczystosci i kolorow RGBA podczas projektowania nakladek na pierwszy plan, aby tworzyc profesjonalne znaki wodne, ktore nie zaslaniaja lezacej pod spodem zawartosci. Testuj rozne poziomy przezroczystosci, aby wywazyc widocznosc i czytelnosc.

Wnioski

Mozliwosci teł i pierwszego planu w IronPDF dostarczaja mocnych narzedzi do wzbogacania dokumentow PDF w aplikacjach C#. Dodaj firmowe naglowki dokumentow, zabezpieczajace znaki wodne lub adnotacje dokumentow, ktore integruja sie bezproblemowo w twoim przebiegu generowania plikow PDF. Aby dowiedziec sie wiecej o zaawansowanych technikach manipulacji PDF, zapoznaj sie z naszymi przewodnikami na temat edycji PDF i podpisow cyfrowych.

Często Zadawane Pytania

How do I add a background image to a PDF in C#?

With IronPDF, you can easily add background images to PDFs using the AddBackgroundPdf method. This method allows you to insert PDF documents as background layers behind existing content, perfect for creating letterheads, watermarks, or decorative elements. IronPDF maintains the visibility of your original content while placing the background behind it.

What's the difference between adding backgrounds and foregrounds to PDFs?

IronPDF provides two distinct methods for PDF enhancement: AddBackgroundPdf places content behind existing elements (useful for letterheads and watermarks), while AddForegroundOverlayPdf places content on top of existing pages (ideal for stamps, signatures, and confidential markings). Both methods work seamlessly with IronPDF's rendering engine.

Can I apply backgrounds to specific pages only?

Yes, IronPDF allows you to specify which pages should receive backgrounds or foregrounds. You can apply these enhancements to single pages, multiple pages, or entire documents, giving you complete control over your PDF customization workflow through IronPDF's flexible API.

What file formats can I use as backgrounds?

IronPDF's AddBackgroundPdf method works with PDF documents as backgrounds. You can either provide a PdfDocument object or specify a file path to import and add a PDF as background. This flexibility in IronPDF allows you to work with both dynamically generated backgrounds and pre-existing template files.

How does transparency work when adding backgrounds?

IronPDF intelligently handles transparency when adding backgrounds. Your original PDF text and images remain visible while the background appears behind them. This works particularly well with transparent or semi-transparent original content, as IronPDF ensures backgrounds show through appropriately while maintaining document readability.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

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ę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.