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

如何使用 C# 進行 PDF編輯：在 PDF 中新增背景和前景疊加層

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

IronPDF可讓您在現有內容後新增背景影像或 PDF 文件，並在其上方疊加前景元素。在您的 C# 應用程式中建立浮水印、信箋、圖章和註釋。 此功能簡化了文件自訂，讓您無需修改原始內容結構，即可使用專業的品牌元素和重要疊加層來增強 PDF。

新增背景，將影像或 PDF 文件作為背景圖層插入現有內容後面。 將此技術用於信紙、浮水印或裝飾元素。 它可在公司文件中保持一致的品牌形象，使用預先設計的範本建立正式表格，並在主要內容背後添加巧妙的安全功能。

疊加前景，將文字、圖像或其他內容放置在現有 PDF 的上方。 常見用途包括新增"機密"印章、日期/時間戳記、批准簽名或頁面特定註釋，這些內容會醒目地顯示在文件內容上方。

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

快速入門：為您的 PDF 文件添加背景

使用IronPDF為您的 PDF 文件新增背景，增強其美觀度。 本指南展示如何將 PDF 檔案插入為信箋或浮水印的背景圖層。 請按照以下程式碼片段開始操作。 首先，透過NuGet安裝IronPDF 。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/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

最簡工作流程(5個步驟)

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


如何為我的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，背景顏色各不相同。 透過將 1 指定為 AddBackgroundPdf 中的第二個參數，我們將使用第二頁作為背景。

當您有多頁範本 PDF 並且希望將不同的頁面作為不同文件部分的背景時，此功能非常有用。 例如，企業範本的封面、內容頁和附錄可能採用不同的設計。 頁面選擇功能與PDF 頁面操作功能搭配使用，可實現全面的文件控制。

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

如何將特定頁面設定為背景？

: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

使用特定頁面會產生什麼結果？

如何為特定頁面套用背景或前景？

使用不同的方法名稱，為單一頁面或多個頁面套用背景或前景。 使用 AddBackgroundPdfToPage 和 AddForegroundOverlayPdfToPage 為特定 PDF 頁面新增背景和疊加前景。 這些方法可以精確控制頁面佈局各異的專業文件的增強效果。

對於需要在不同頁面上進行不同處理的複雜文檔，可以將這些方法與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

如何申請多個頁面？

處理多頁文件時，可為特定頁面範圍套用背景或前景。 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 對象，以防止記憶體洩漏。 在 using 語句中實作這些功能，以進行自動資源清理。

3.模板管理：建立一個背景和前景模板庫，從磁碟加載模板，而不是每次都生成。這與PDF 範本功能搭配使用效果很好，可以實現文件樣式的一致性。

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
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 18,135,201 | 版本： 2026.4 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 變成 PDF。