如何在 C# 中應用自定義 PDF 水印

如何使用 IronPDF 在 C# 中為 PDF 新增浮水印

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

IronPDF 只需一行代碼即可在 PDF 上新增自訂水印,並使用 HTML 字串進行完整的樣式控制。 套用可調整不透明度、旋轉和定位的文字或影像水印,以強化文件安全性和品牌。

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

使用 IronPDF 只需一行代碼即可在 PDF 上新增自訂水印。 使用簡單的 3x3 網格系統以 HTML 設定水印的不透明度、旋轉和位置。 本指南說明如何使用個人化的水印來強化 PDF 文件,以達到安全和品牌的目的。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 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.下載 IronPDF C# 庫 2.渲染新的或匯入現有的 PDF 文件

  1. 配置用作浮水印的 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");
$vbLabelText   $csharpLabel

水印 HTML 字串支援所有標準 HTML 元素和 CSS 定義。 包括圖片、文字、自訂字型、顏色和複雜的佈局。 這種靈活性可創造出符合品牌需求的專業水印。 如需進階的樣式選項,請在水印中使用 web 字型和圖示

最終的水印 PDF 是什麼樣子?

輕鬆添加各種格式的影像水印 (PNG、JPG) 以及自訂字型的文字水印。 水印出現在主要內容後方,確保文件的可讀性,同時提供品牌或安全功能。


如何調整水印的不透明度和旋轉度?

水印的預設不透明度為 50%,可依需求調整。 ApplyWatermark 方法包含一個接受 rotation 作為參數的重載。 指定"旋轉:"和"不透明度:"以調整這些參數。

對於複雜的水印情境,請探索我們的戳記功能,以獲得額外的客製化選項。

哪些參數可控制水印外觀?

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

旋轉參數接受的數值單位為度 (0-360),可使用對角線水印,常用於草稿或機密文件。 不透明度參數接受 0 到 100 的值,其中 0 代表完全透明,100 代表完全不透明。 這些參數可精確控制水印的視覺效果。

使用不同的不透明度等級工作

不同的文件類型需要不同的不透明度:

  • 法律文件:使用 20-30% 的不透明度來呈現微妙的水印
  • 草稿文件:使用 40-60% 的不透明度,以便清晰可見
  • 機密文件:使用 30-50% 的不透明度,對角線旋轉
  • 品牌文件:使用 10-25% 的不透明度以達到專業的外觀
// 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);
$vbLabelText   $csharpLabel

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


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

使用 3x3 網格指定水印位置,該網格水平分成 3 列,垂直分成 3 行。 橫向選項有左側、中央和右側; 垂直選項有上層、中層和底層。 此配置可讓每個頁面上有 9 個不同的位置。 請參閱下面的圖片,以獲得視覺上的呈現。

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

使用 IronPdf.Editing 命名空間中的 VerticalAlignmentHorizontalAlignment 枚舉將水印添加到特定位置。 此定位系統與 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");
$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
$vbLabelText   $csharpLabel

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

專業水印的最佳實務

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

1.保持可讀性:確保水印不會干擾文件內容 2.一致的品牌:使用符合品牌準則的公司顏色和字型 3.安全性考量:對於敏感性文件,請結合水印與 IronPDF 加密。 4.效能:對於批次處理,請最佳化水印 HTML 並使用 async 作業

企業應用程式中的水印

對於處理大量 PDF 的企業應用程式,可在 PDF 壓縮的同時實施水印,以最佳化檔案大小。 將水印整合至您的 IronPDF 生成管道,以進行自動化文件處理。

準備好看看您還能做些什麼嗎? 在此查看我們的教學頁面: 編輯 PDFs

常見問題解答

如何在 C# 中添加水印到 PDF?

只需一行代碼,您就可以使用 IronPDF 的 ApplyWatermark 方法為 PDF 添加水印。只需載入您的 PDF 文件,並使用包含水印內容和位置的 HTML 字串呼叫 ApplyWatermark:new IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("Confidential", 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 的全部功能,創建符合品牌要求的專業水印。

Curtis Chau
技術撰稿人

Curtis Chau 擁有電腦科學學士學位(卡爾頓大學),專長於前端開發,精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情,他喜歡使用現代化的架構,並製作結構良好且視覺上吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 也有濃厚的興趣,他喜歡探索整合硬體與軟體的創新方式。在空閒時間,他喜歡玩遊戲和建立 Discord bots,將他對技術的熱愛與創意結合。

準備好開始了嗎?
Nuget 下載 17,527,568 | 版本: 2026.2 剛剛發布