如何在 C# 中使用 IronPDF 為 PDF 新增浮水印
IronPDF 使用 ApplyWatermark 方法將文字或圖片浮水印新增到任何 PDF 文件中,該方法需要一個 HTML 字串,讓您通過 CSS 來控制樣式、不透明度、旋轉和位置,並使用 3x3 對齊網格。 浮水印位於頁面內容的後面,保持文件的可讀性,同時帶有品牌或安全標記。
快速入門:一行程式碼應用浮水印
渲染或打開 PDF,然後使用 HTML 字串調用 ApplyWatermark。 四參數重載需要 HTML、不透明度值和 VerticalAlignment / HorizontalAlignment 配對,將標記放置在頁面上。
-
使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf
-
複製並運行這段程式碼片段。
IronPdf.PdfDocument.FromFile("input.pdf") .ApplyWatermark("<h1 style='color:red;'>Confidential</h1>", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center) .SaveAs("output.pdf"); -
部署以在您的實時環境中測試
今天就開始在您的專案中使用IronPDF,透過免費試用
最小工作流程 (5步)
- 從NuGet下載IronPDF程式庫
- 渲染新 PDF 或打開現有的 PDF
- 將浮水印寫為 HTML 字串
- 調用
ApplyWatermark方法 - 根據需要調整旋轉、不透明度和對齊
我如何將浮水印應用到我的 PDF?
在新渲染或導入的 PdfDocument 上調用 ApplyWatermark。 該方法接受一個 HTML 字串,因此浮水印可以包含圖像、文字、自訂字體、顏色和 CSS 佈局。 下面的範例將標誌圖像和標題結合成一個標記。 浮水印應用於文件中的每一頁; 該方法不支持每頁標記。
如果您需要先建立源文件,請參閱 建立 PDF 和 HTML 轉為 PDF 的指南。
我可以在浮水印中放入哪些 HTML?
:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-watermark.cs
using IronPdf;
string watermarkHtml = @"
<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>");
// Apply watermark
pdf.ApplyWatermark(watermarkHtml);
pdf.SaveAs("watermark.pdf");
Imports IronPdf
Private watermarkHtml As String = "
<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>"
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>")
' Apply watermark
pdf.ApplyWatermark(watermarkHtml)
pdf.SaveAs("watermark.pdf")
浮水印字串接受任何標準 HTML 和 CSS,包括遠程圖像和網路字體與圖標。 由於標記呈現在頁面內容後面,原始文字保持可讀性,而浮水印提供品牌或狀態標籤。
浮水印的 PDF 看起來像什麼樣子?
我如何調整浮水印的不透明度和旋轉?
浮水印預設以 50% 的不透明度應用。 要更改它,請將 opacity:(0 到 100,0 為透明,100 為完全不透明)和 rotation:(0 到 360 度)作為命名參數傳遞。 45 度旋轉產生在草稿和機密文件上常見的對角標記。
哪些參數控制不透明度和旋轉?
:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-rotation-opacity.cs
using IronPdf;
using IronPdf.Editing;
string watermarkHtml = @"
<img style='width: 200px;' src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>");
// Apply watermark with 45 degrees rotation and 70% opacity
pdf.ApplyWatermark(watermarkHtml, rotation: 45, opacity: 70);
pdf.SaveAs("watermarkOpacity&Rotation.pdf");
Imports IronPdf
Imports IronPdf.Editing
Private watermarkHtml As String = "
<img style='width: 200px;' src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>"
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>")
' Apply watermark with 45 degrees rotation and 70% opacity
pdf.ApplyWatermark(watermarkHtml, rotation:= 45, opacity:= 70)
pdf.SaveAs("watermarkOpacity&Rotation.pdf")
rotation 參數將標記圍繞其中心旋轉,而 opacity 參數設置其顯示的強度。 它們共同調整浮水印在其下方的頁面上的顯著程度。
旋轉和不透明度產生了什麼效果?
如何在 PDF 上定位我的浮水印?
IronPDF 在 3x3 網格上放置浮水印:三個水平列(左、中、右)和三個垂直行(上、中、下),每頁提供九個位置。 使用 VerticalAlignment 和 HorizontalAlignment 套用 IronPdf.Editing 命名空間中的列舉型來選擇一個位置。 下面的圖像將每個列舉型對應到其位置。
這些是 文字和圖像印章功能使用的相同列舉,因此定位在兩者之間一致。
哪些對齊列舉型定位浮水印?
:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark-apply-watermark-top-right.cs
using IronPdf;
using IronPdf.Editing;
string watermarkHtml = @"
<img style='width: 200px;' src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>");
// Apply watermark on the top-right of the document
pdf.ApplyWatermark(watermarkHtml, 50, VerticalAlignment.Top, HorizontalAlignment.Right);
pdf.SaveAs("watermarkLocation.pdf");
Imports IronPdf
Imports IronPdf.Editing
Private watermarkHtml As String = "
<img style='width: 200px;' src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>"
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Watermark</h1>")
' Apply watermark on the top-right of the document
pdf.ApplyWatermark(watermarkHtml, 50, VerticalAlignment.Top, HorizontalAlignment.Right)
pdf.SaveAs("watermarkLocation.pdf")
此呼叫傳遞一個不透明度值,然後是 VerticalAlignment.Top 和 HorizontalAlignment.Right,將標記錨定到右上角。 交換列舉值,可將浮水印移動到九格位置中的任何一個。
定位浮水印的效果是什麼樣子?
總結
您已使用 ApplyWatermark 應用文字和圖片浮水印,調整它們的不透明度和旋轉,並使用 VerticalAlignment / HorizontalAlignment 網格將它們固定。 當單個標記不夠時,相同的對齊列舉型用於每區域疊加和全頁層的 文字和圖像印章功能。
常見問題
如何在 C# 中將浮水印新增到 PDF?
您可以使用 IronPDF 的 ApplyWatermark 方法僅用一行程式碼將浮水印新增到 PDF 中。載入您的 PDF 文件,然後用 HTML 字串、不透明度值以及垂直對齊 / 水平對齊組合調用 ApplyWatermark: IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("
Confidential
", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center).SaveAs("output.pdf");我可以將哪些型別的浮水印新增到我的 PDF?
IronPDF 支持文字和圖像浮水印。您可以使用任何 HTML 內容作為浮水印,包括具有自訂字體的文字、各種格式的圖像 (PNG, JPG),甚至是帶有完整 CSS 樣式的複雜布局。浮水印顯示在主要內容後面,以確保文件可讀性。
我可以自訂浮水印的位置嗎?
可以,IronPDF 使用簡單的 3x3 網格進行浮水印定位。從 IronPdf.Editing 命名空間中選擇帶有垂直對齊 (上、中、下) 和水平對齊 (左、中、右) 列舉的點,從而在頁面上提供九個標準位置。對齊組合作為參數傳遞給 ApplyWatermark 方法。
如何調整浮水印的不透明度和旋轉?
IronPDF 以預設 50% 不透明度應用浮水印,但您可以使用不透明度參數來自訂。ApplyWatermark 方法包括一個重載,接受旋轉和不透明度參數,使您能夠建立半透明或旋轉的浮水印,以增強視覺效果。
我可以將不同的浮水印應用於特定頁面嗎?
目前,IronPDF 將浮水印應用於 PDF 文件中的所有頁面。不支持頁面特定的浮水印。當您使用 ApplyWatermark 方法時,浮水印將出現在 PDF 的每一頁上。
浮水印中支援哪些 HTML 和 CSS 功能?
IronPDF 的浮水印功能支持所有標準 HTML 元素和 CSS 樣式。這包括自訂字體、顏色、網頁字體、圖示和複雜布局。您可以使用標準 HTML 和 CSS 建立符合品牌需求的浮水印。

