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

How to Add Watermarks to PDFs in C# Using IronPDF

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. 使用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.下載IronPDF C# 庫

  1. 新建或匯入 PDF 文檔
  2. 配置用作浮水印的 HTML 字串
  3. 使用 ApplyWatermark 方法實現浮水印
  4. 根據需要自訂浮水印旋轉角度、不透明度和位置

如何為我的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 樣式。 包含圖片、文字、自訂字體、顏色和複雜版面。 這種靈活性使得創建符合品牌要求的專業浮水印成為可能。 如需更進階的樣式選項,請在浮水印中使用網頁字體和圖示

最終產生的帶有浮水印的PDF檔案是什麼樣子的?

輕鬆添加各種格式(PNG、JPG)的圖像浮水印和帶有自訂字體的文字浮水印。 水印出現在主要內容後面,既保證了文件的可讀性,也提供了品牌或安全功能。


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

水印預設不透明度為 50%,可依需求進行調整。 ApplyWatermark 方法包含一個重載,接受旋轉作為參數。 指定"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");
$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 命名空間中的VerticalAlignmentHorizo​​ntalAlignment枚舉,向特定位置添加浮水印。 此定位系統與 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.安全注意事項:對於敏感文檔,請將浮水印與PDF 加密結合使用。
4.效能:對於批次處理,優化浮水印 HTML 並使用非同步操作

企業應用程式中的浮水印

對於處理大量 PDF 的企業應用程序,除了PDF 壓縮之外,還可以實施浮水印以優化文件大小。 將浮水印功能整合到PDF 生成流程中,以實現文件自動化處理。

準備好要看看你還能做什麼了嗎? 請造訪我們的教學頁面:編輯 PDF

常見問題解答

如何在 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 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 17,803,474 | 版本: 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想快速取得證據? PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。