如何使用 IronPDF 在 C# 中為 PDF 添加浮水印
IronPDF 允許透過單行程式碼,使用 HTML 字串來完全控制樣式,為 PDF 檔案添加自訂浮水印。 透過可調整透明度、旋轉角度及定位的文字或圖片浮水印,強化文件安全性並提升品牌形象。
快速入門:輕鬆套用自訂浮水印
使用 IronPDF 僅需一行程式碼,即可為 PDF 檔案添加自訂浮水印。 透過簡單的 3x3 網格系統,使用 HTML 樣式自訂浮水印的不透明度、旋轉角度及位置。 本指南說明如何為 PDF 文件添加個人化浮水印,以強化安全性並建立品牌形象。
-
using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf
PM > Install-Package IronPdf -
請複製並執行此程式碼片段。
new IronPdf.PdfDocument.FromFile("input.pdf") .ApplyWatermark("<h1 style='opacity:0.5;'>Confidential</h1>", IronPdf.PagePosition.TopCenter) .SaveAs("output.pdf"); -
部署至您的生產環境進行測試
立即透過免費試用,在您的專案中開始使用 IronPDF
添加浮水印的基本步驟有哪些?
- 下載適用於 C# 的 IronPDF 函式庫
- 渲染新文件或匯入現有 PDF 文件
- 設定用作浮水印的 HTML 字串
- 使用
ApplyWatermark方法來實作浮水印 - 根據需要自訂浮水印的旋轉角度、透明度及位置
如何在 PDF 檔案中加入浮水印?
使用 ApplyWatermark 方法,可對新渲染或現有的 PDF 檔案套用浮水印。 此方法接受 HTML 字串作為浮水印,並支援所有 HTML 功能,包括 CSS 樣式。 以下範例展示了同時使用圖片與文字作為浮水印的情況。 請注意,所有頁面均會顯示浮水印; 不支援頁面專屬的水印。
在處理浮水印之前,請先參閱我們關於建立 PDF 或將 HTML 轉換為 PDF 的指南,以了解使用 IronPDF 生成 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 字串支援所有標準 HTML 元素及 CSS 樣式。 請包含圖片、文字、自訂字型、顏色及複雜版面配置。 此靈活性可讓您建立符合品牌要求的 Professional 浮水印。 如需進階樣式設定,請在浮水印中使用網頁字型與圖示。
最終的水印 PDF 檔案會是什麼樣子?
輕鬆添加各種格式(PNG、JPG)的圖片浮水印,以及使用自訂字體的文字浮水印。 浮水印會顯示於主要內容後方,在確保文件可讀性的同時,提供品牌識別或安全功能。
如何調整浮水印的透明度與旋轉角度?
浮水印預設不透明度為 50%,可依需求進行調整。 ApplyWatermark 方法包含一個接受 rotation 作為參數的重載版本。 請指定 rotation: 和 opacity: 來調整這些參數。
若需處理複雜的水印情境,請探索我們的加蓋功能以獲取更多自訂選項。
哪些參數會影響浮水印的外觀?
: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 參數接受以度為單位的數值(0-360),可設定常應用於草稿或機密文件的對角線浮水印。 opacity 參數接受 0 到 100 之間的數值,其中 0 表示完全透明,100 表示完全不透明。 這些參數可精確控制浮水印的視覺效果。
處理不同不透明度層級
不同類型的文件需要不同的透明度設定:
- 法律文件:請使用 20-30% 的不透明度以呈現細微的水印
- 草稿文件:請使用 40-60% 的不透明度以確保清晰可見
- 機密文件:請使用 30-50% 的不透明度並進行對角線旋轉
- 品牌文件:請使用 10-25% 的不透明度以呈現 Professional 外觀
// Example: Creating a subtle branded watermark
string brandWatermark = @"
<div style='font-family: Arial, sans-serif; color: #cccccc;'>
<img style='width: 150px;' src='company-logo.png'>
<p>© 2024 Company Name</p>
</div>";
pdf.ApplyWatermark(brandWatermark, rotation: 0, opacity: 20);
// Example: Creating a subtle branded watermark
string brandWatermark = @"
<div style='font-family: Arial, sans-serif; color: #cccccc;'>
<img style='width: 150px;' src='company-logo.png'>
<p>© 2024 Company Name</p>
</div>";
pdf.ApplyWatermark(brandWatermark, rotation: 0, opacity: 20);
Imports System
' Example: Creating a subtle branded watermark
Dim brandWatermark As String = "
<div style='font-family: Arial, sans-serif; color: #cccccc;'>
<img style='width: 150px;' src='company-logo.png'>
<p>© 2024 Company Name</p>
</div>"
pdf.ApplyWatermark(brandWatermark, rotation:=0, opacity:=20)
旋轉與不透明度如何影響最終結果?
如何在 PDF 上定位我的浮水印?
請使用 3x3 網格(水平分為 3 列、垂直分為 3 行)來指定浮水印的位置。 水平對齊選項包括左對齊、居中對齊和右對齊; 垂直選項包括頂部、中部和底部。 此設定可在每個頁面啟用 9 個不同的位置。 請參閱下圖以獲取視覺呈現。
請使用 VerticalAlignment 和 HorizontalAlignment 枚舉(位於 IronPdf.Editing 命名空間中),在特定位置添加浮水印。 此定位系統可與 IronPDF 的其他頁面處理功能整合。
定位時應使用哪種對齊枚舉?
: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")
進階定位技術
若需進行複雜的定位設定,請結合浮水印、自訂邊距及針對特定頁面的變換功能。 以下是一個在不同位置建立多個浮水印的範例:
// Example: Adding multiple watermarks with different positions
string dateWatermark = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>";
string confidentialWatermark = "<h2 style='color: red;'>CONFIDENTIAL</h2>";
string pageNumberWatermark = "<p style='font-size: 12px;'>Page {page} of {total}</p>";
// Apply date at top-left
pdf.ApplyWatermark(dateWatermark, 30, VerticalAlignment.Top, HorizontalAlignment.Left);
// Apply confidential mark at center
pdf.ApplyWatermark(confidentialWatermark, 50, VerticalAlignment.Middle, HorizontalAlignment.Center);
// Note: For page numbers, consider using Headers and Footers instead
// Example: Adding multiple watermarks with different positions
string dateWatermark = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>";
string confidentialWatermark = "<h2 style='color: red;'>CONFIDENTIAL</h2>";
string pageNumberWatermark = "<p style='font-size: 12px;'>Page {page} of {total}</p>";
// Apply date at top-left
pdf.ApplyWatermark(dateWatermark, 30, VerticalAlignment.Top, HorizontalAlignment.Left);
// Apply confidential mark at center
pdf.ApplyWatermark(confidentialWatermark, 50, VerticalAlignment.Middle, HorizontalAlignment.Center);
// Note: For page numbers, consider using Headers and Footers instead
' Example: Adding multiple watermarks with different positions
Dim dateWatermark As String = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>"
Dim confidentialWatermark As String = "<h2 style='color: red;'>CONFIDENTIAL</h2>"
Dim pageNumberWatermark As String = "<p style='font-size: 12px;'>Page {page} of {total}</p>"
' Apply date at top-left
pdf.ApplyWatermark(dateWatermark, 30, VerticalAlignment.Top, HorizontalAlignment.Left)
' Apply confidential mark at center
pdf.ApplyWatermark(confidentialWatermark, 50, VerticalAlignment.Middle, HorizontalAlignment.Center)
' Note: For page numbers, consider using Headers and Footers instead
水印的常見定位模式有哪些?
Professional浮水印的最佳實踐
在為專業文件製作浮水印時,請遵循以下最佳實務:
- 保持可讀性:確保浮水印不會干擾文件內容
- 品牌一致性:使用符合品牌指南的公司專屬顏色與字型
- 安全性考量:針對敏感文件,請將浮水印與 PDF 加密功能結合使用
- 效能:針對批次處理,請優化浮水印 HTML 並採用非同步操作
Enterprise應用程式中的浮水印技術
對於處理大量 PDF 檔案的 Enterprise 應用程式,請在實施 PDF 壓縮的同時加入浮水印,以優化檔案大小。 將浮水印功能整合至您的 PDF 生成流程中,以實現文件自動處理。
準備好探索更多可能性了嗎? 請點此查看我們的教學頁面:編輯 PDF
常見問題
如何在 C# 中為 PDF 添加浮水印?
您只需一行程式碼,即可透過 IronPDF 的 ApplyWatermark 方法在 PDF 檔案中加入浮水印。只需載入您的 PDF 文件,並傳入包含浮水印內容與位置的 HTML 字串來呼叫 ApplyWatermark:new IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("機密", IronPdf.PagePosition.TopCenter).SaveAs("output.pdf");
我可以為 PDF 添加哪些類型的浮水印?
IronPDF 同時支援文字與圖片浮水印。您可以使用任何 HTML 內容作為浮水印,包括使用自訂字型的文字、各種格式的圖片(PNG、JPG),甚至包含完整 CSS 樣式的複雜版面配置。浮水印會顯示在主要內容的後方,以確保文件的可讀性。
我可以自訂浮水印的位置嗎?
是的,IronPDF 採用簡單的 3x3 網格系統來定位浮水印。您可以將浮水印放置於 TopCenter、BottomRight 等位置,或頁面上的任何九個標準位置。位置是透過 ApplyWatermark 方法中的參數來指定。
如何調整浮水印的透明度與旋轉角度?
IronPDF 預設以 50% 不透明度套用浮水印,但您可以透過不透明度參數進行自訂。ApplyWatermark 方法包含一個可同時接受旋轉與不透明度參數的重載版本,讓您能建立半透明或旋轉的浮水印,以提升視覺效果。
我可以對特定頁面套用不同的浮水印嗎?
目前,IronPDF 會將浮水印套用至 PDF 文件的所有頁面。不支援針對特定頁面的浮水印。當您使用 ApplyWatermark 方法時,浮水印將會出現在 PDF 的每一頁上。
浮水印支援哪些 HTML 和 CSS 功能?
IronPDF 的浮水印功能支援所有標準 HTML 元素與 CSS 樣式。這包括自訂字型、顏色、網頁字型、圖示以及複雜的版面配置。您可以運用 HTML 和 CSS 的完整功能,建立符合品牌要求的 Professional 浮水印。

