1. IronPDF
  2. Anleitungen
  3. Hintergründe & Vordergründe
Hintergründe & Vordergründe in PDFs hinzufügen

How to Add Background and Overlay Foreground on PDFs

Chaknith Bin
Chaknith Bin
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Das Hinzufügen eines Hintergrunds ermöglicht es Ihnen, ein Bild oder ein anderes PDF-Dokument als Hintergrundebene hinter den vorhandenen Inhalt eines PDFs einzufügen. Es ist nützlich für das Erstellen von Briefköpfen, Wasserzeichen oder das Hinzufügen dekorativer Elemente zu Ihren Dokumenten.

Die Überlagerung des Vordergrunds ermöglicht es Ihnen, Text, Bilder oder andere Inhalte auf ein bestehendes PDF zu legen, um es effektiv zu überlagern. Dies wird häufig verwendet, um Anmerkungen, Stempel, Unterschriften oder zusätzliche Informationen zu einem PDF hinzuzufügen, ohne den Originalinhalt zu verändern.

Das Hinzufügen eines Hintergrunds und die Überlagerung des Vordergrunds sind beide in IronPdf verfügbar, mit den Optionen, PDF als Hintergrund und Vordergrund zu nutzen.

als-überschrift:2(Schnellstart: Hintergrund zu Ihren PDF-Dokumenten hinzufügen)

Verbessern Sie Ihre PDF-Dokumente einfach, indem Sie einen Hintergrund mit IronPDF hinzufügen. Dieser schnelle Leitfaden zeigt Ihnen, wie Sie ein PDF als Hintergrundebene einfügen, perfekt für Briefköpfe oder Wasserzeichen. Befolgen Sie den einfachen Codeausschnitt, um schnell und mühelos zu beginnen, und verwandeln Sie Ihre PDF-Präsentationen mit Leichtigkeit.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

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

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie die IronPDF-Bibliothek von NuGet herunter
  2. Verwenden Sie ein frisch gerendertes oder vorhandenes PDF als Hintergrund oder Vordergrund
  3. Verwenden Sie die AddBackgroundPdf-Methode, um einen Hintergrund hinzuzufügen
  4. Verwenden Sie die AddForegroundOverlayPdf-Methode, um einen Vordergrund zu überlagern
  5. Geben Sie an, auf welche Seiten der Hintergrund oder Vordergrund angewendet werden soll


Hintergrundbeispiel hinzufügen

Verwenden Sie die AddBackgroundPdf-Methode, um einem neu gerenderten oder vorhandenen PDF-Dokument einen Hintergrund hinzuzufügen. Das untenstehende Codebeispiel zeigt die Bereitstellung der Methode mit einem PdfDocument-Objekt. Sie können jedoch auch den Dateipfad angeben, um das PDF automatisch zu importieren und es in einer einzigen Codezeile als Hintergrund hinzuzufügen.

Code

: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

Ausgangs-PDF

Vordergrundüberlagerungsbeispiel

Ähnlich wie beim Hinzufügen eines Hintergrunds können Sie den PDF-Dateipfad angeben, um das Dokument zu importieren und es als Vordergrund über das Haupt-PDF zu überlagern. Verwenden Sie die AddForegroundOverlayPdf-Methode, um den Vordergrund auf das Haupt-PDF-Dokument zu überlagern.

Code

: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

Ausgangs-PDF

Seiten für Hintergrund oder Vordergrund auswählen

Es ist möglich zu wählen, welche Seite des PDFs als Hintergrund oder Vordergrund verwendet werden soll. Nehmen wir das Anwenden eines Hintergrunds als Beispiel, indem wir ein ähnliches Codebeispiel aus dem 'Hintergrundbeispiel hinzufügen'-Abschnitt verwenden. Wir erstellen ein zweiseitiges PDF mit einer anderen Farbe, um es als Hintergrund zu verwenden. Indem wir die Zahl 1 als unseren zweiten Parameter in der AddBackgroundPdf-Methode angeben, verwenden wir die zweite Seite als Hintergrund.

TippsAlle Seitenindizes folgen der nullbasierten Indizierung.

Code

: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

Ausgangs-PDF

Hintergrund oder Vordergrund auf bestimmten Seiten anwenden

Schließlich ist es auch möglich, Hintergrund oder Vordergrund auf eine einzelne Seite oder mehrere Seiten anzuwenden. Diese Aktion erfordert die Verwendung eines leicht anderen Methodennamens. Verwenden Sie die AddBackgroundPdfToPage und AddForegroundOverlayPdfToPage-Methoden, um Hintergrund und Vordergrundüberlagerung auf eine einzelne bestimmte Seite des PDFs hinzuzufügen.

TippsAlle Seitenindizes folgen der nullbasierten Indizierung.

Auf einer einzelnen Seite anwenden

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-single-page.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 to page 1
pdf.AddBackgroundPdfToPage(0, background);

pdf.SaveAs("addBackgroundOnASinglePage.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 to page 1
pdf.AddBackgroundPdfToPage(0, background)

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

Auf mehreren Seiten anwenden

: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

Ausgangs-PDF

Häufig gestellte Fragen

Was sind die Vorteile, einen Hintergrund zu einem PDF hinzuzufügen?

Das Hinzufügen eines Hintergrunds zu einem PDF kann sein Erscheinungsbild verbessern, indem Bilder oder andere PDFs als Hintergrundschichten eingebunden werden. Dieses Feature ist ideal zur Erstellung professionell aussehender Dokumente mit Elementen wie Briefköpfen, Wasserzeichen oder dekorativen Designs mit IronPDF.

Wie kann ich Text auf ein bestehendes PDF-Dokument überlagern?

Um Text auf ein bestehendes PDF-Dokument zu überlagern, können Sie die Methode AddForegroundOverlayPdf von IronPDF verwenden. Dies ermöglicht es Ihnen, Anmerkungen, Stempel oder zusätzliche Informationen auf dem bestehenden Inhalt hinzuzufügen, ohne das Original-PDF zu verändern.

Welche Methoden stehen zur Verfügung, um PDF-Hintergründe und -Vordergründe zu verändern?

IronPDF bietet Methoden wie AddBackgroundPdf zum Hinzufügen von Hintergründen und AddForegroundOverlayPdf zum Überlagern von Inhalten auf PDFs. Diese Methoden erlauben es Benutzern, PDFs durch visuelle Ebenen anzupassen.

Wie kann ich einen Hintergrund oder eine Überlagerung auf bestimmte Seiten in einem PDF anwenden?

Sie können einen Hintergrund oder eine Überlagerung auf bestimmte Seiten eines PDFs anwenden, indem Sie Methoden wie AddBackgroundPdfToPage und AddForegroundOverlayPdfToPage in IronPDF verwenden. Diese Methoden ermöglichen das Zielen einzelner Seiten, während Methoden für Seitenbereiche für mehrere Seiten verwendet werden können.

Ist es möglich, ein bestehendes PDF als Hintergrund in einem anderen PDF zu verwenden?

Ja, Sie können ein bestehendes PDF als Hintergrund in einem anderen PDF verwenden, indem Sie seinen Dateipfad angeben und die Methode AddBackgroundPdf von IronPDF verwenden. Dieses Feature ermöglicht eine nahtlose Integration bestehender Dokumente als Hintergründe.

Wie gebe ich an, welche Seite eines PDFs als Hintergrund verwendet werden soll?

Um anzugeben, welche Seite eines PDFs als Hintergrund verwendet werden soll, können Sie den Seitenindex als Parameter in der Methode AddBackgroundPdf in IronPDF angeben. Dies ermöglicht es Ihnen, die genaue Seite auszuwählen, die Sie aus dem Hintergrund-PDF verwenden möchten.

Kann ich dieselbe Methode verwenden, um Hintergründe und Vordergründe anzuwenden?

Nein, IronPDF verwendet verschiedene Methoden für die Anwendung von Hintergründen und Vordergründen. Verwenden Sie AddBackgroundPdf für Hintergründe und AddForegroundOverlayPdf für Vordergründe, um den gewünschten Effekt auf Ihr PDF zu erzielen.

Wie kann ich das Erscheinungsbild eines PDFs mit dekorativen Elementen verbessern?

Sie können das Erscheinungsbild eines PDFs mit dekorativen Elementen verbessern, indem Sie die Methode AddBackgroundPdf von IronPDF verwenden, um Bilder oder PDFs als Hintergründe hinzuzufügen, oder indem Sie Text und Bilder im Vordergrund mit AddForegroundOverlayPdf überlagern.

Ist IronPDF vollständig kompatibel mit .NET 10 hinsichtlich der Verwendung von Hintergrund- und Vordergrundmethoden?

Ja. IronPDF ist vollständig kompatibel mit .NET 10 und unterstützt Funktionen wie AddBackgroundPdf , AddForegroundOverlayPdf sowie seitenbezogene Hintergrund-/Overlay-Methoden standardmäßig. Es profitiert von den in .NET 10 eingeführten Leistungs- und Laufzeitverbesserungen und behält gleichzeitig das gewohnte API-Verhalten bei.

Chaknith Bin
Chaknith Bin
  Jetzt mit dem Ingenieurteam chatten
Software Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat umfassende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Einblicke aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentationen und einem insgesamt besseren Erlebnis bei.
Bereit anzufangen?
Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht