如何在 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

自定义水印是添加到 PDF 页面的个性化背景图像或文本覆盖。 它用于各种目的,包括以徽标或名称进行品牌推广,使用“机密”等标签增强安全性,确保版权保护,并指示文档状态。 自定义水印可以包括文本、图像或两者,可以选择性或普遍应用,其不透明度可以调整,以实现个性化、安全和语境化的 PDF。

IronPDF 提供了一行代码即可向 PDF 格式文档添加水印。 水印功能接受生成水印的 HTML 字符串,该字符串可以使用所有 HTML 功能以及 CSS 样式。

快速指南:轻松应用自定义水印)

向 PDF 添加自定义水印从未如此简单。 使用 IronPDF,您可以使用一行代码应用水印。 使用简单的 3x3 网格系统,通过 HTML 样式自定义水印的不透明度、旋转和位置。 本指南将帮助您快速使用个性化水印增强您的 PDF 文档,确保安全和品牌。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.PdfDocument.FromFile("input.pdf")
        .ApplyWatermark("<h1 style='opacity:0.5;'>Confidential</h1>", IronPdf.PagePosition.TopCenter)
        .SaveAs("output.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

标题:3(最小工作流程(5 步)

  1. 下载 IronPDF 库以便用于 C#
  2. 渲染新文件或导入现有的 PDF 文档。
  3. 配置用作水印的 HTML 字符串。
  4. 使用 ApplyWatermark 方法实施水印。
  5. 根据需要自定义水印的旋转、不透明度和位置。

应用水印示例

利用 ApplyWatermark 方法将水印应用于新渲染或现有的 PDF。 此方法接收 HTML 字符串作为水印,允许其拥有 HTML 提供的所有功能,包括 CSS 样式。 让我们在下面的示例中同时使用图像和文本作为我们的水印。 请注意,水印将应用于所有页面; 不可能将水印应用于特定页面。

代码

: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

输出 PDF 文件

这是一种非常简单的方法,可以从多种图像格式(如 PNG)中添加图像水印文本以及使用自定义字体的文本水印。

<hr

水印不透明度和旋转

添加默认不透明度为 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");
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

输出 PDF 文件

<hr

PDF 文件上的水印位置

要指定水印位置,请使用一个横向 3 列,纵向 3 行的 3x3 网格。 横向选项为左、中、右,纵向选项为上、中、下。 使用此配置,我们可以在文档的每页上设置 9 个不同的位置。 请参阅下面的图像了解此概念的视觉表示。

class="content-img-align-center">
class="center-image-wrapper"> Watermark location

使用 VerticalAlignmentHorizontalAlignment 枚举在 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")
$vbLabelText   $csharpLabel

输出 PDF 文件

准备好看看您还能做些什么吗? 请查看我们的教程页面:编辑 PDF

常见问题解答

什么是 PDF 中的自定义水印?

自定义水印是添加到 PDF 页面中的个性化背景图像或文本覆盖。它用于品牌推广、安全、版权保护以及显示文档状态。

如何使用 C# 向 PDF 添加水印?

您可以使用 IronPDF 的 ApplyWatermark 方法向 PDF 添加水印。此方法接受 HTML 字符串作为水印,让您可以利用 HTML 功能和 CSS 样式。

我可以仅将水印应用于 PDF 中的某些页面吗?

目前,IronPDF 将水印应用于 PDF 的所有页面。它不支持将水印应用于特定页面。

如何在 PDF 中自定义水印的透明度和旋转?

IronPDF 允许您通过使用接受这些属性参数的 ApplyWatermark 方法的重载来自定义水印的透明度和旋转。

在 C# 中应用自定义水印有哪些步骤?

要应用自定义水印,请下载 IronPDF,渲染或导入 PDF,配置水印的 HTML 字符串,使用 ApplyWatermark 方法,并根据需要调整水印的旋转、透明度和位置。

我如何指定水印在 PDF 页面上的位置?

您可以利用来自 IronPdf.Editing 命名空间的 VerticalAlignmentHorizontalAlignment 枚举,使用 3x3 网格系统设置水印位置,提供水平选项(左、中、右)和垂直选项(上、中、下)。

我可以用作水印的图像格式有哪些?

IronPDF 支持各种图像格式以创建图像水印,例如 PNG。

我可以在 HTML 字符串中使用 CSS 样式化水印吗?

可以,IronPDF 支持用于创建水印的 HTML 字符串中的 CSS 样式,允许进行广泛的自定义。

是否可以将文字和图像组合在一个水印中?

是的,您可以通过正确配置与ApplyWatermark方法一起使用的 HTML 字符串,将文本和图像组合在一个水印中。

我可以从哪里获取适用于 C# 的 IronPDF 库?

您可以从 NuGet 包管理器下载适用于 C# 的 IronPDF 库。

IronPDF 是否兼容 .NET 10?自定义水印功能是否能在 .NET 10 项目中使用?

是的——IronPDF 完全兼容 .NET 10。它支持 .NET 10(以及 .NET 9、8、7、6、Core、Standard 和 Framework)。

Chaknith Bin
软件工程师
Chaknith 在 IronXL 和 IronBarcode 工作。他在 C# 和 .NET 方面有着深厚的专业知识,帮助改进软件并支持客户。他从用户互动中获得的见解有助于更好的产品、文档和整体体验。
准备开始了吗?
Nuget 下载 16,154,058 | 版本: 2025.11 刚刚发布