如何在PDF上添加背景和覆蓋前景
This article was translated from English: Does it need improvement?
TranslatedView the article in English
添加背景允許您插入影像或另一個 PDF 文件作為背景層，置於現有 PDF 內容之後。這對於建立信箋、浮水印或添加裝飾元素到您的文件中非常有用。
疊加前景允許您在現有 PDF 文件上放置文字、影像或其他內容，有效地疊加它。這通常用於添加註釋、印章、簽名或附加資訊到 PDF 中，而不改變原始內容。
在 IronPDF 中同時提供添加背景和疊加前景的功能，並且可以選擇使用 PDF 作為背景和前景。
如何在PDF上添加背景和覆蓋前景
- 下載 C# 程式庫來新增背景並疊加前景
- 使用新渲染或現有的PDF作為背景或前景
- 使用
添加背景 PDF添加背景的方法 - 使用
添加前景疊加PDF疊加前景的方法 - 指定要在哪些頁面應用背景或前景
立即開始在您的專案中使用IronPDF，並享受免費試用。
查看 IronPDF 上 Nuget 快速安裝和部署。已被下載超過800萬次，它正用C#改變PDF。
請考慮安裝 IronPDF DLL 直接下載並手動安裝到您的專案或GAC表單： IronPdf.zip
添加背景範例
使用 AddBackgroundPdf 方法為新渲染的或現有的 PDF 文件添加背景。以下代碼範例展示了提供方法一個 PdfDocument 對象。然而，你也可以指定文件路徑來自動導入 PDF 並在一行代碼中將其添加為背景。
代碼
:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background.csusing 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")VB C#
輸出 PDF
前景覆蓋範例
與添加背景類似，您可以指定 PDF 文件路徑以導入文檔，並將其覆蓋為主 PDF 的前景。使用 AddForegroundOverlayPdf 方法將前景覆蓋在主 PDF 文檔上。
代碼
:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-foreground.csusing 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")VB C#
輸出 PDF
選擇頁面作為背景或前景
可以選擇將 PDF 的哪一頁用作背景或前景。讓我們以應用背景為例，使用從“添加背景範例部分。我們生成一個兩頁的 PDF，並使用不同的顏色作為背景。通過在 AddBackgroundPdf 方法中指定數字 1 作為第二個參數，我們將第 2 頁用作背景。
提示
所有頁面索引均遵循基於零的索引。
代碼
:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background-page-2.csusing 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")VB C#
輸出 PDF
在指定頁面上應用背景或前景
最後，也可以對單個頁面或多個頁面應用背景或前景。此操作需要使用稍微不同的方法名稱。使用 AddBackgroundPdfToPage 和 AddForegroundOverlayPdfToPage 方法分別將背景和前景覆蓋添加到 PDF 特定頁面上。
提示
所有頁面索引均遵循基於零的索引。
應用於單個頁面
:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-single-page.csusing 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")VB C#
使用AddBackgroundPdfToPageRange和AddForegroundOverlayPdfToPageRange方法分別對多個頁面應用背景和前景。
應用於多個頁面
:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-multiple-pages.csusing 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")VB C#
輸出 PDF
