如何使用IronPDF在C#中为PDF添加水印
IronPDF通过ApplyWatermark方法向任何PDF添加文本或图像水印,该方法采用HTML字符串,因此您可以通过CSS和3x3对齐网格控制样式、不透明度、旋转和放置。 水印置于页面内容后面,保持文档可读性,同时承载品牌或安全标记。
快速入门:一行代码应用水印
渲染或打开一个PDF,然后使用HTML字符串调用ApplyWatermark。 四参数重载采用HTML、不透明度值和放置标记的HorizontalAlignment对。
-
使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf
-
复制并运行这段代码。
IronPdf.PdfDocument.FromFile("input.pdf") .ApplyWatermark("<h1 style='color:red;'>Confidential</h1>", 50, IronPdf.Editing.VerticalAlignment.Top, IronPdf.Editing.HorizontalAlignment.Center) .SaveAs("output.pdf"); -
部署到您的生产环境中进行测试
通过免费试用立即在您的项目中开始使用IronPDF
最小工作流程(5 个步骤)
- 从 NuGet 下载 IronPDF 库。
- 渲染一个新的PDF或打开一个现有的PDF
- 将水印写为HTML字符串
- 调用
ApplyWatermark方法 - 根据需要调整旋转、不透明度和对齐方式
如何在 PDF 上应用水印?
在新渲染或导入的ApplyWatermark。 该方法接受一个HTML字符串,因此水印可以携带图像、文本、自定义字体、颜色和CSS布局。 下面的示例将一个徽标图像和一个标题组合成一个标记。 水印应用于文档的每一页; 通过此方法不支持每页标记。
如果您需要先构建源文档,请参阅关于创建PDF和HTML转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")
水印字符串接受任何标准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")
opacity设置它显示的强度。 它们一起调整水印相对于其下方页面的显著性。
旋转和不透明度产生了什么?
如何在 PDF 上定位水印?
IronPDF在3x3网格上放置水印:三个水平列(左、中、右)和三个垂直行(上、中、下),每页提供九个位置。 使用HorizontalAlignment枚举选择位置。 下面的图片将每对枚举映射到其位置。
这些是印章文本和图像功能使用的相同枚举,因此定位在两者之间表现一致。
哪些对齐枚举位置水印?
: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")
此调用传递不透明度值,然后是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创建符合品牌要求的水印。

