如何在 C# 中应用自定义 PDF 水印

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

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

IronPDF通过ApplyWatermark方法向任何PDF添加文本或图像水印,该方法采用HTML字符串,因此您可以通过CSS和3x3对齐网格控制样式、不透明度、旋转和放置。 水印置于页面内容后面,保持文档可读性,同时承载品牌或安全标记。

快速入门:一行代码应用水印

渲染或打开一个PDF,然后使用HTML字符串调用ApplyWatermark。 四参数重载采用HTML、不透明度值和放置标记的HorizontalAlignment对。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 复制并运行这段代码。

    IronPdf.PdfDocument.FromFile("input.pdf")
        .ApplyWatermark("<h1 style='color:red;'>Confidential</h1>", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center)
        .SaveAs("output.pdf");
  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronPDF

    arrow pointer


如何在 PDF 上应用水印?

在新渲染或导入的ApplyWatermark。 该方法接受一个HTML字符串,因此水印可以携带图像、文本、自定义字体、颜色和CSS布局。 下面的示例将一个徽标图像和一个标题组合成一个标记。 水印应用于文档的每一页; 通过此方法不支持每页标记。

如果您需要先构建源文档,请参阅关于创建PDFHTML转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和CSS,包括远程图像和网页字体和图标。 因为标记在页面内容后面渲染,原始文本保持可读性,而水印提供品牌或状态标签。

带水印的PDF是什么样的?


如何调整水印不透明度和旋转?

默认情况下,水印应用50%不透明度。 要更改它,请将rotation:(0到360度)作为命名参数传递。 45度旋转会产生草稿和机密文件上常见的对角线标记。

哪些参数控制不透明度和旋转?

: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

opacity设置它显示的强度。 它们一起调整水印相对于其下方页面的显著性。

旋转和不透明度产生了什么?


Icon Quote related to 旋转和不透明度产生了什么?

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能,比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic related to 旋转和不透明度产生了什么?

Milan Jovanovic

微软MVP

查看案例研究
Icon Quote related to 旋转和不透明度产生了什么?

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本,同时提高生产力,并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle related to 旋转和不透明度产生了什么?

Brent Matzelle

首席技术官,OPYN

查看案例研究
Icon Quote related to 旋转和不透明度产生了什么?

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率,包括创建平面图和改善库存管理。

David Jones related to 旋转和不透明度产生了什么?

David Jones

首席软件工程师,Agorus Build

查看案例研究

如何在 PDF 上定位水印?

IronPDF在3x3网格上放置水印:三个水平列(左、中、右)和三个垂直行(上、中、下),每页提供九个位置。 使用HorizontalAlignment枚举选择位置。 下面的图片将每对枚举映射到其位置。

IronPDF 水印对齐网格,显示 9 种具有垂直和水平对齐属性的定位选项

这些是印章文本和图像功能使用的相同枚举,因此定位在两者之间表现一致。

哪些对齐枚举位置水印?

: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

此调用传递不透明度值,然后是HorizontalAlignment.Right,将标记锚定在右上角。 交换枚举值以将水印移动到九个网格位置中的任意一个。

定位的水印是什么样的?

结论

您已经使用HorizontalAlignment网格锚定了它们。 当单个标记不足时,相同的对齐枚举驱动印章文本和图像功能,用于每个区域覆盖和整页图层。

常见问题解答

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

您可以使用IronPDF的ApplyWatermark方法在PDF中添加水印,仅需一行代码。加载您的PDF文档,通过HTML字符串、一个不透明度值和一个VerticalAlignment / HorizontalAlignment对来调用ApplyWatermark:IronPdf.PdfDocument.FromFile("input.pdf").ApplyWatermark("

Confidential

", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center).SaveAs("output.pdf");

我可以在 PDF 上添加哪些类型的水印?

IronPDF 支持文本和图像水印。您可以使用任何 HTML 内容作为水印,包括带有自定义字体的文本、各种格式的图片(PNG、JPG),甚至带有完整 CSS 风格的复杂布局。水印会显示在主要内容后面,以确保文档的可读性。

我可以自定义水印的位置吗?

是的,IronPDF使用简单的3x3网格进行水印定位。通过IronPdf.Editing命名空间中的VerticalAlignment(Top, Middle, Bottom)和HorizontalAlignment(Left, Center, Right)枚举选择一个位置,这为页面提供了九种标准位置。对齐组合传递给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 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

准备开始了吗?
Nuget 下载 20,088,359 | 版本: 2026.7 刚刚发布
Still Scrolling Icon

还在滚动吗?

想快速获得证据? PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。