1. IronPDF
  2. 操作指南
  3. 背景和前景
如何在 PDF 中添加背景和前景

How to Add Background and Overlay Foreground on PDFs

Chaknith Bin
Chaknith Bin
更新日期:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

疊加前景讓您將文本、圖像或其他內容放置在現有PDF之上，實現有效的疊加效果。 這通常用於在不更改原始內容的情況下向PDF添加註釋、標籤、簽名或附加信息。

在IronPdf中可以使用PDF作為背景和前景的選項來實現添加背景和疊加前景的功能。

快速入門: 在您的PDF文檔中添加背景

通過IronPDF輕鬆增強您的PDF文檔，添加背景。 這一快速指導向您展示如何將PDF插入為背景層，非常適合信頭紙或水印。 按照簡單的代碼片段，快速且輕鬆地入門，並輕鬆轉變您的PDF演示文稿。

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

簡約工作流程（5步驟）

  1. 從NuGet下載IronPDF庫
  2. 使用新渲染或現有的PDF作為背景或前景
  3. 使用AddBackgroundPdf方法來添加背景
  4. 使用AddForegroundOverlayPdf方法來疊加前景
  5. 指定要應用背景或前景的頁面


添加背景範例

使用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頁作為背景。

提示所有頁碼皆採用0為起始的索引方式。

代码

: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的特定單頁添加背景和疊加前景。

提示所有頁碼皆採用0為起始的索引方式。

應用於單一頁面

: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

應用於多個頁面

: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

常見問題解答

在 PDF 中添加背景有哪些好处？

在 PDF 中添加背景可以通过将图像或其他 PDF 作为背景层来增强其外观。此功能适合创建具有抬头、浮水印或装饰性设计的专业文档，使用 IronPDF。

我如何在现有的 PDF 文档上覆盖文本？

要在现有的 PDF 文档上覆盖文本，您可以使用 IronPDF 的 AddForegroundOverlayPdf 方法。这允许您在现有内容顶部添加注释、印章或附加信息，而不会改变原始 PDF。

有哪些方法可用于修改 PDF 背景和覆盖？

IronPDF 提供了 AddBackgroundPdf 用于添加背景和 AddForegroundOverlayPdf 用于覆盖内容。这些方法允许用户通过添加视觉层自定义 PDF。

我如何在 PDF 中将背景或覆盖应用于特定页面？

您可以使用 IronPDF 的 AddBackgroundPdfToPage 和 AddForegroundOverlayPdfToPage 方法将背景或覆盖应用于 PDF 中的特定页面。这些方法允许对单个页面进行定位，而页面范围方法可用于多个页面。

是否可以在另一个 PDF 中使用现有的 PDF 作为背景？

是的，您可以通过指定其文件路径并使用 IronPDF 的 AddBackgroundPdf 方法，将现有的 PDF 用作另一个 PDF 的背景。此功能允许现有文档无缝集成为背景。

我如何指定要用作背景的 PDF 的页面？

要指定要用作背景的 PDF 的页面，您可以在 IronPDF 的 AddBackgroundPdf 方法中提供页面索引作为参数。这允许您选择要从背景 PDF 中使用的确切页面。

我可以用相同的方法应用背景和前景吗？

不，IronPDF 使用不同的方法来应用背景和前景。使用 AddBackgroundPdf 用于背景，使用 AddForegroundOverlayPdf 用于前景，以达到您在 PDF 上想要的效果。

我如何用装饰元素增强 PDF 的外观？

您可以使用 IronPDF 的 AddBackgroundPdf 方法通过添加图像或 PDF 作为背景，或通过 AddForegroundOverlayPdf 将文本和图像覆盖在前景上，以装饰元素增强 PDF 的外观。

Chaknith Bin
Chaknith Bin
  立即與工程團隊聊天
軟體工程師
Chaknith 在 IronXL 和 IronBarcode 上工作。他對 C# 和 .NET 擁有深厚的專業知識，幫助改進了軟體並支持客戶。他從用戶互動中得到的見解有助於改善產品、文檔和整體體驗。
準備好開始了嗎？
Nuget 下載 16,154,058 | 版本： 2025.11 剛剛發布