如何使用IronPDF在C#中为PDF添加水印
IronPDF通过ApplyWatermark方法向任何PDF添加文本或图像水印,该方法采用HTML字符串,因此您可以通过CSS和3x3对齐网格控制样式、不透明度、旋转和放置。 水印置于页面内容后面,保持文档可读性,同时承载品牌或安全标记。
渲染或打开一个PDF,然后使用HTML字符串调用ApplyWatermark。 四参数重载采用HTML、不透明度值和放置标记的HorizontalAlignment对。
-
1Install IronPDF with NuGet Package Manager
-
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");C# -
3部署到您的生产环境中进行测试
通过免费试用立即在您的项目中开始使用IronPDF
最小工作流程(5 个步骤)
- 从 NuGet 下载 IronPDF 库。
- 渲染一个新的PDF或打开一个现有的PDF
- 将水印写为HTML字符串
- 调用
ApplyWatermark方法 - 根据需要调整旋转、不透明度和对齐方式
如何在 PDF 上应用水印?
在新渲染或导入的ApplyWatermark。 该方法接受一个HTML字符串,因此水印可以携带图像、文本、自定义字体、颜色和CSS布局。 下面的示例将一个徽标图像和一个标题组合成一个标记。 水印应用于文档的每一页; 通过此方法不支持每页标记。
如果您需要先构建源文档,请参阅关于创建PDF和HTML转PDF转换的指南。
我可以在水印中放什么HTML?
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度旋转会产生草稿和机密文件上常见的对角线标记。
哪些参数控制不透明度和旋转?
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枚举选择位置。 下面的图片将每对枚举映射到其位置。

这些是印章文本和图像功能使用的相同枚举,因此定位在两者之间表现一致。
哪些对齐枚举位置水印?
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创建符合品牌要求的水印。
What does the default watermark opacity look like in IronPDF?
The default watermark opacity in IronPDF is set to 50%, which provides a balance between visibility and transparency, allowing the underlying document text to remain legible.
Are there specific examples of applying watermarks in IronPDF?
Yes, the provided examples in IronPDF documentation demonstrate applying watermarks with various adjustments, such as changing opacity, rotation, and positioning using the `ApplyWatermark` method.
Can I apply different watermarks to each page in a PDF using IronPDF?
Currently, the `ApplyWatermark` method in IronPDF applies the same watermark to all pages in the document. For unique marks on each page, additional logic would be needed.
Does IronPDF support remote images in watermarks?
Yes, IronPDF supports remote images in watermarks. You can specify URLs in the HTML string used in the `ApplyWatermark` method to include images hosted online.

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。