如何在 PDF 中添加背景和前景

如何在 PDF 中使用 C# 添加背景和前景覆蓋。

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

<! -- 引言實作示意圖 --> <!--說明:說明程式碼概念的圖表或截圖 -->

IronPDF 可讓您在現有內容後添加背景圖片或 PDF,並在上面覆蓋前景元素。在您的 C# 應用程式中建立水印、信紙、圖章和註解。 此功能可簡化文件自訂,讓您在不修改原始內容結構的情況下,以專業的品牌元素和重要的覆蓋層來強化 PDF。

新增背景,在現有內容後插入圖片或 PDF 文件作為背景層。 將此技術用於信紙、水印或裝飾元素。 它在企業文件中維持一致的品牌形象,使用預先設計的範本建立正式表格,並在主要內容後方加入微妙的安全功能。

Overlay foregrounds 可將文字、圖片或其他內容放在現有 PDF 的上方。 常見用途包括加入"保密"戳記、日期/時間戳記、核准簽名,或在文件內容上方顯眼處加上特定頁面的註解。

背景和前景功能均適用於 IronPDF 中的 PDF。 將這些增強功能套用至單頁、多頁或整個文件,以完全控制您的 PDF 自訂工作流程。

快速入門:為 PDF 文件新增背景

使用 IronPDF 添加背景來增強您的 PDF 文件。 本指南說明如何插入 PDF 作為信紙或水印的背景圖層。 請按照程式碼片段開始。 首先,透過 NuGet 安裝 IronPDF

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    var pdf = new IronPdf.PdfDocument("input.pdf");
    pdf.AddBackgroundPdf("background.pdf");
    pdf.SaveAs("output.pdf");
  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer


如何為我的 PDF 新增背景?

<! -- 說明新增背景範例實作的圖表 --> <!--說明:說明程式碼概念的圖表或截圖 -->

使用 AddBackgroundPdf 方法為新的或現有的 PDF 文件新增背景。 以下範例顯示提供 PdfDocument 物件給方法。 您也可以指定要匯入的檔案路徑,並在一行中加入 PDF 作為背景。這種靈活性同時適用於動態產生的背景和預先存在的範本檔案。

IronPDF 可在添加背景時智能地對內容進行分層。 您的原始 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 上覆蓋前景。 此方法可有效地增加出現在文件內容上方的水印、圖章或註解。

前景覆疊功能支援各種使用情況,從簡單的文字覆疊到複雜的圖形元素。 在建立前景內容時,請使用 CSS 變換和不透明度設定,以達到專業效果。 此技術可與 HTML 轉換為 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。 透過指定 1AddBackgroundPdf 中的第二個參數,我們使用第二頁作為背景。

當您擁有多頁 PDF 範本,並希望將不同頁面作為不同文件部分的背景時,此功能會有所幫助。 例如,企業範本可能會對封面頁、內容頁和附錄採用不同的設計。 頁面選擇可與 IronPDF 頁面處理功能配合使用,以進行全面的文件控制。

所有頁面索引均採用從零開始的索引方式。

如何使用特定頁面作為背景?

: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

使用特定頁面會有什麼結果?


如何將背景或前景套用至特定頁面?

<! -- 輸出顯示在 IronPdf 中指定頁面上套用背景或前景的結果 --> <!--說明:顯示程式碼執行輸出或結果的截圖 -->

使用不同的方法名稱為單一頁面或多個頁面套用背景或前景。 使用 AddBackgroundPdfToPageAddForegroundOverlayPdfToPage 來新增背景和覆蓋前景到特定的 PDF 頁面。 這些方法可針對各頁面佈局不同的專業文件,提供精確的文件增強控制。

對於需要在不同頁面上進行不同處理的複雜文件,可將這些方法與 IronPDF 合併與分割功能結合,以建立複雜的文件工作流程。 這對於封面頁、內容頁和附錄需要不同背景處理的報告生成尤其有效。

所有頁面索引均採用從零開始的索引方式。

如何應用於單一頁面?

: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

我要如何套用至多個頁面?

在處理多頁文件時,請將背景或前景套用至特定的頁面範圍。 AddBackgroundPdfToPageRange 方法接受一個頁面索引清單,可完全彈性地選擇哪些頁面接受增強。 此方法可與 頁面編號 及其他文件組織功能無縫配合。

: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 工作流程中實作背景和前景時,請考慮這些最佳化策略:

1.效能考量:預先渲染背景和前景 PDF,並在大型文件的多個作業中重複使用。 與為每個文件渲染它們相比,這樣可以提高性能。

2.記憶體管理:在處理多個 PDF 時,適當地處置 PdfDocument 物件,以防止記憶體洩漏。 在使用語句中實現這些功能,以進行自動資源清理。

3.範本管理:建立一個從磁碟載入的背景和前台範本庫,而不是每次都產生。這與IronPDF 模板功能配合使用,可達到一致的文件樣式。

4.透明度與分層:在設計前景覆蓋層時使用 CSS 不透明度和 RGBA 顏色,以建立不會遮蔽底層內容的專業水印。 測試不同的不透明度,以平衡可視性與可讀性。

結論

IronPDF 的背景和前景功能為在 C# 應用程式中增強 PDF 文件提供了強大的工具。 新增企業信頭、安全水印或文件註解,無縫整合至 PDF 生成工作流程。 如需更多進階的 PDF 操作技術,請參閱我們的 PDF 編輯 數位簽名 指南。

常見問題解答

如何在 C# 中為 PDF 新增背景圖片?

使用 IronPDF,您可以使用 AddBackgroundPdf 方法輕鬆地為 PDF 添加背景圖片。此方法可讓您在現有內容後插入 PDF 文件作為背景圖層,非常適合製作信頭、水印或裝飾元素。IronPDF 在放置背景的同時,還能保持原始內容的可見度。

在 PDF 中加入背景和前景有什麼不同?

IronPDF 提供兩種不同的 PDF 增強方法:AddBackgroundPdf 將內容置於現有元素之後(對於信頭和水印非常有用),而 AddForegroundOverlayPdf 則將內容置於現有頁面之上(對於印章、簽名和機密標記非常理想)。這兩種方法都能與 IronPDF 的渲染引擎無縫配合。

我可以只在特定頁面上套用背景嗎?

是的,IronPDF 允許您指定哪些頁面應該接收背景或前景。您可以將這些增強功能套用到單頁、多頁或整個文件,透過 IronPDF 靈活的 API,讓您完全控制 PDF 自訂工作流程。

我可以使用哪些檔案格式作為背景?

IronPDF 的 AddBackgroundPdf 方法使用 PDF 文件作為背景。您既可以提供一個 PdfDocument 物件,也可以指定一個檔案路徑來匯入和新增 PDF 作為背景。IronPDF 的這種靈活性使您既可以使用動態生成的背景,也可以使用預先存在的模板文件。

新增背景時,透明度如何運作?

IronPDF 可在添加背景時智能地處理透明度。您的原始 PDF 文本和圖像仍然可見,而背景則顯示在它們後面。這對於透明或半透明的原始內容尤其有效,因為 IronPDF 可確保背景適當地顯示出來,同時維持文件的可讀性。

Curtis Chau
技術撰稿人

Curtis Chau 擁有電腦科學學士學位(卡爾頓大學),專長於前端開發,精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情,他喜歡使用現代化的架構,並製作結構良好且視覺上吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 也有濃厚的興趣,他喜歡探索整合硬體與軟體的創新方式。在空閒時間,他喜歡玩遊戲和建立 Discord bots,將他對技術的熱愛與創意結合。

準備好開始了嗎?
Nuget 下載 17,386,124 | 版本: 2026.2 剛剛發布