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

如何使用 C# 在 PDF 中添加背景與前景疊加層

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

IronPDF 讓您能在現有內容後方添加背景圖片或 PDF 檔案，並在上方疊加前景元素。您可在 C# 應用程式中建立浮水印、信頭、印章及註解。 此功能可簡化文件自訂流程，讓您在不修改原始內容結構的前提下，透過 Professional 的品牌元素與重要疊加層來強化 PDF 文件。

新增背景功能，可將圖片或 PDF 文件作為背景圖層，置於現有內容之後。 請將此技術應用於信頭、浮水印或裝飾元素。 它能在企業文件中維持品牌形象的一致性，利用預先設計的範本建立官方表單，並在主要內容背後加入細膩的安全功能。

使用疊加前景功能，將文字、圖片或其他內容置於現有 PDF 檔案之上。 常見用途包括在文件內容上方顯眼處添加"機密"標記、日期/時間戳記、核准簽名，或特定頁面的註記。

IronPDF 支援 PDF 檔案的背景與前景功能。 將這些增強功能套用至單一頁面、多個頁面或整個文件，以完全掌控您的 PDF 自訂工作流程。

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

使用 IronPDF 為您的 PDF 文件添加背景，提升文件品質。 本指南說明如何將 PDF 檔案插入作為信頭或浮水印的背景圖層。 請參照程式碼片段開始操作。 首先，請透過 NuGet 安裝 IronPDF。

  1. using 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 變換與不透明度設定以呈現 Professional 效果。 此技術可與 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 檔案，其中背景採用不同的顏色。 透過在 AddBackgroundPdf 中將 1 指定為第二個參數，我們將第二頁用作背景。

此功能適用於您擁有多頁面的範本 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 頁面添加背景及疊加的前景。 這些方法可精確控制Professional文件的增強效果，適用於各頁面版面配置各異的文件。

對於需要在不同頁面採取不同處理方式的複雜文件，請結合這些方法與 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 顏色，以建立 Professional 水印，同時不遮蔽底層內容。 請測試不同的透明度層級，以平衡可見度與可讀性。

結論

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 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 18,926,724 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。