1. IronPDF
  2. Guides pratiques
  3. Arrière-plans et Avant-plans
Comment ajouter des arrière-plans et des premiers plans dans les PDFs

How to Add Background and Overlay Foreground on PDFs

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

Ajouter un arrière-plan vous permet d'insérer une image ou un autre document PDF comme couche d'arrière-plan derrière le contenu existant d'un PDF. C'est utile pour créer des en-têtes, des filigranes, ou ajouter des éléments décoratifs à vos documents.

Superposer le premier plan vous permet de placer du texte, des images, ou d'autres contenus au-dessus d'un PDF existant, le superposant efficacement. C'est couramment utilisé pour ajouter des annotations, des tampons, des signatures, ou des informations supplémentaires à un PDF sans modifier le contenu original.

Ajouter un arrière-plan et superposer le premier plan sont tous deux disponibles dans IronPdf avec les options d'utiliser le PDF comme arrière-plan et premier plan.

comme en-tête:2(Démarrage rapide : Ajouter un arrière-plan à vos documents PDF)

Améliorez facilement vos documents PDF en ajoutant un arrière-plan avec IronPDF. Ce guide rapide vous montre comment insérer un PDF comme couche d'arrière-plan, parfait pour les en-têtes ou les filigranes. Suivez l'exemple de code simple pour commencer rapidement et facilement, et transformez vos présentations PDF avec aisance.

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">

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque IronPDF depuis NuGet
  2. Utilisez un PDF fraîchement rendu ou existant comme arrière-plan ou premier plan
  3. Utilisez la méthode AddBackgroundPdf pour ajouter un arrière-plan
  4. Utilisez la méthode AddForegroundOverlayPdf pour superposer un premier plan
  5. Spécifiez quelles pages appliquer l'arrière-plan ou le premier plan


Exemple d'ajout d'arrière-plan

Utilisez la méthode AddBackgroundPdf pour ajouter un arrière-plan à un document PDF nouvellement rendu ou existant. L'exemple de code ci-dessous montre comment fournir la méthode avec un objet PdfDocument. Cependant, vous pouvez également spécifier le chemin du fichier pour importer automatiquement le PDF et l'ajouter comme arrière-plan en une seule ligne de code.

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

PDF de sortie

Exemple de superposition du premier plan

De même que pour l'ajout d'un arrière-plan, vous pouvez spécifier le chemin du fichier PDF pour importer le document et le superposer comme premier plan sur le PDF principal. Utilisez la méthode AddForegroundOverlayPdf pour superposer le premier plan sur le document PDF principal.

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

PDF de sortie

Sélectionner des pages pour l'arrière-plan ou le premier plan

Il est possible de choisir quelle page du PDF utiliser comme votre arrière-plan ou premier plan. Prenons l'exemple de l'application d'un arrière-plan, en utilisant un exemple de code similaire de la section 'Exemple d'ajout d'arrière-plan'. Nous générons un PDF de deux pages avec une couleur différente pour l'utiliser comme arrière-plan. En spécifiant le numéro 1 comme deuxième paramètre dans la méthode AddBackgroundPdf, nous utilisons la 2e page comme arrière-plan.

ConseilsTous les index de page suivent une indexation basée sur zéro.

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

PDF de sortie

Appliquer l'arrière-plan ou le premier plan sur les pages spécifiées

Enfin, il est aussi possible d'appliquer l'arrière-plan ou le premier plan à une seule page ou plusieurs pages. Cette action nécessite d'utiliser un nom de méthode légèrement différent. Utilisez les méthodes AddBackgroundPdfToPage et AddForegroundOverlayPdfToPage pour ajouter l'arrière-plan et superposer le premier plan à une page particulière du PDF, respectivement.

ConseilsTous les index de page suivent une indexation basée sur zéro.

Appliquer sur une seule page

: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

Appliquer sur plusieurs pages

: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

PDF de sortie

Questions Fréquemment Posées

Quels sont les avantages d'ajouter un arrière-plan à un PDF?

Ajouter un arrière-plan à un PDF peut améliorer son apparence en incorporant des images ou d'autres PDF comme couches d'arrière-plan. Cette fonctionnalité est idéale pour créer des documents d'aspect professionnel avec des éléments tels que des en-têtes, des filigranes ou des motifs décoratifs en utilisant IronPDF.

Comment puis-je superposer du texte sur un document PDF existant?

Pour superposer du texte sur un document PDF existant, vous pouvez utiliser la méthode AddForegroundOverlayPdf d'IronPDF. Cela vous permet d'ajouter des annotations, des tampons ou des informations supplémentaires par-dessus le contenu existant sans altérer le PDF original.

Quelles méthodes sont disponibles pour modifier les arrière-plans et superpositions de PDF?

IronPDF fournit des méthodes telles que AddBackgroundPdf pour ajouter des arrière-plans et AddForegroundOverlayPdf pour superposer du contenu sur les PDF. Ces méthodes permettent aux utilisateurs de personnaliser les PDF en ajoutant des couches visuelles.

Comment puis-je appliquer un arrière-plan ou une superposition à des pages spécifiques d'un PDF?

Vous pouvez appliquer un arrière-plan ou une superposition à des pages spécifiques d'un PDF en utilisant des méthodes comme AddBackgroundPdfToPage et AddForegroundOverlayPdfToPage dans IronPDF. Ces méthodes permettent de cibler des pages uniques, tandis que des méthodes de gamme de pages peuvent être utilisées pour plusieurs pages.

Est-il possible d'utiliser un PDF existant comme arrière-plan dans un autre PDF?

Oui, vous pouvez utiliser un PDF existant comme arrière-plan dans un autre PDF en spécifiant son chemin de fichier et en utilisant la méthode AddBackgroundPdf d'IronPDF. Cette fonctionnalité permet une intégration fluide des documents existants en tant qu'arrière-plans.

Comment spécifier quelle page d'un PDF utiliser comme arrière-plan?

Pour spécifier quelle page d'un PDF utiliser comme arrière-plan, vous pouvez fournir l'index de la page comme paramètre dans la méthode AddBackgroundPdf d'IronPDF. Cela vous permet de sélectionner la page exacte que vous souhaitez utiliser à partir du PDF d'arrière-plan.

Puis-je utiliser la même méthode pour appliquer des arrière-plans et des premiers plans?

Non, IronPDF utilise des méthodes différentes pour appliquer des arrière-plans et des premiers plans. Utilisez AddBackgroundPdf pour les arrière-plans et AddForegroundOverlayPdf pour les premiers plans afin d'obtenir l'effet souhaité sur votre PDF.

Comment puis-je améliorer l'apparence d'un PDF avec des éléments décoratifs?

Vous pouvez améliorer l'apparence d'un PDF avec des éléments décoratifs en utilisant la méthode AddBackgroundPdf d'IronPDF pour ajouter des images ou des PDF comme arrière-plans, ou en superposant du texte et des images au premier plan avec AddForegroundOverlayPdf.

IronPDF est-il entièrement compatible avec .NET 10 pour l'utilisation des méthodes d'arrière-plan et de premier plan ?

Oui. IronPDF est entièrement compatible avec .NET 10 et prend en charge nativement des fonctionnalités telles que AddBackgroundPdf , AddForegroundOverlayPdf et les méthodes d'arrière-plan/superposition spécifiques à la page. Il bénéficie des améliorations de performances et d'exécution introduites dans .NET 10 tout en conservant le comportement de son API.

Chaknith Bin
Chaknith Bin
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il a une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, documentation et expérience globale.
Prêt à commencer?
Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir