如何在 C# 中套用自訂 PDF 水印

如何使用 IronPDF 在 C# 中為 PDF 添加浮水印

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

IronPDF 允許透過單行程式碼,使用 HTML 字串來完全控制樣式,為 PDF 檔案添加自訂浮水印。 透過可調整透明度、旋轉角度及定位的文字或圖片浮水印,強化文件安全性並提升品牌形象。

快速入門:輕鬆套用自訂浮水印

使用 IronPDF 僅需一行程式碼,即可為 PDF 檔案添加自訂浮水印。 透過簡單的 3x3 網格系統,使用 HTML 樣式自訂浮水印的不透明度、旋轉角度及位置。 本指南說明如何為 PDF 文件添加個人化浮水印,以強化安全性並建立品牌形象。

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 請複製並執行此程式碼片段。

    new IronPdf.PdfDocument.FromFile("input.pdf")
        .ApplyWatermark("<h1 style='opacity:0.5;'>Confidential</h1>", IronPdf.PagePosition.TopCenter)
        .SaveAs("output.pdf");
  3. 部署至您的生產環境進行測試

    立即透過免費試用,在您的專案中開始使用 IronPDF

    arrow pointer

添加浮水印的基本步驟有哪些?

  1. 下載適用於 C# 的 IronPDF 函式庫
  2. 渲染新文件或匯入現有 PDF 文件
  3. 設定用作浮水印的 HTML 字串
  4. 使用 ApplyWatermark 方法來實作浮水印
  5. 根據需要自訂浮水印的旋轉角度、透明度及位置

如何在 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")
$vbLabelText   $csharpLabel

水印 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")
$vbLabelText   $csharpLabel

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)
$vbLabelText   $csharpLabel

旋轉與不透明度如何影響最終結果?


如何在 PDF 上定位我的浮水印?

請使用 3x3 網格(水平分為 3 列、垂直分為 3 行)來指定浮水印的位置。 水平對齊選項包括左對齊、居中對齊和右對齊; 垂直選項包括頂部、中部和底部。 此設定可在每個頁面啟用 9 個不同的位置。 請參閱下圖以獲取視覺呈現。

IronPDF 水印對齊網格,顯示 9 種定位選項及其垂直與水平對齊屬性

請使用 VerticalAlignmentHorizontalAlignment 枚舉(位於 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")
$vbLabelText   $csharpLabel

進階定位技術

若需進行複雜的定位設定,請結合浮水印、自訂邊距針對特定頁面的變換功能。 以下是一個在不同位置建立多個浮水印的範例:

// 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
$vbLabelText   $csharpLabel

水印的常見定位模式有哪些?

Professional浮水印的最佳實踐

在為專業文件製作浮水印時,請遵循以下最佳實務:

  1. 保持可讀性:確保浮水印不會干擾文件內容
  2. 品牌一致性:使用符合品牌指南的公司專屬顏色與字型
  3. 安全性考量:針對敏感文件,請將浮水印與 PDF 加密功能結合使用
  4. 效能:針對批次處理,請優化浮水印 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 浮水印。

Curtis Chau
技術撰稿人

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

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

準備開始了嗎?
Nuget 下載 19,014,616 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

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