如何在PDF上添加背景和覆蓋前景

查克尼思·賓

2023年10月9日

已更新 2025年2月5日

Translated

View the article in English

添加背景允許您將圖片或另一個PDF文件作為背景層插入到現有PDF內容的後面。它對於創建信頭、浮水印或為文件添加裝飾元素非常有用。

將前景覆蓋允許您在現有的PDF上方放置文字、圖像或其他內容，有效地進行覆蓋。這通常用於在不更改原始內容的情況下，向PDF添加註解、印章、簽名或其他資訊。

IronPdf支持添加背景和覆蓋前景，並提供將PDF用作背景和前景的選項。

開始使用 IronPDF

立即在您的專案中使用IronPDF，並享受免費試用。

第一步：

如何在PDF上添加背景和覆蓋前景

從 NuGet 下載 IronPDF Library
使用新渲染或現有的PDF作為背景或前景
使用 AddBackgroundPdf 方法添加背景
使用AddForegroundOverlayPdf方法來覆蓋前景
指定要在哪些頁面應用背景或前景

添加背景範例

利用AddBackgroundPdf方法向新生成或現有的PDF文檔添加背景。下面的代碼示例演示了如何向方法提供一個 PdfDocument 對象。不過，您也可以指定檔案路徑，以自動導入PDF並在單行程式碼中將其添加為背景。

代碼

: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

叠加前景示例

类似于添加背景，您可以指定PDF文件路径以导入文档，并将其作为前景覆盖在主PDF上。使用AddForegroundOverlayPdf方法將前景疊加到主PDF文檔上。

代碼

: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

選擇背景或前景的頁面

可以選擇使用 PDF 的哪一頁作為我們的背景或前景。讓我們以應用背景為例，使用「添加背景範例」部分中的相似程式碼範例。我們生成一個有不同背景顏色的兩頁PDF。在 AddBackgroundPdf 方法中將數字 1 指定為我們的第二個參數，表示我們使用第 2 頁作為背景。

提示

所有頁面索引均遵循基於零的索引。

代碼

: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

在指定頁面上應用背景或前景

最後，也可以對單頁或多頁應用背景或前景。此操作需要使用略有不同的方法名稱。使用AddBackgroundPdfToPage和AddForegroundOverlayPdfToPage方法分別為PDF的特定頁面添加背景和覆蓋前景。

提示

所有頁面索引均遵循基於零的索引。

應用於單個頁面

: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

使用AddBackgroundPdfToPageRange及AddForegroundOverlayPdfToPageRange方法來分別將背景和前景應用於多個頁面。

應用於多個頁面

: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

查克尼思·賓

立即與工程團隊聊天

軟體工程師

Chaknith 是開發者界的夏洛克福爾摩斯。他第一次意識到自己可能有個軟體工程的未來，是在他為了娛樂而參加程式挑戰的時候。他的重點是 IronXL 和 IronBarcode，但他也引以為豪的是，他幫助客戶解決所有產品的問題。Chaknith 利用他與客戶直接對話中獲得的知識，以進一步改進產品。他的實際反饋超越了 Jira 工單，並支持產品開發、文件撰寫和行銷，以提升客戶的整體體驗。不在公司時，他通常在學習機器學習、寫程式和徒步旅行。