1. IronPDF
  2. 操作指南
  3. 自定义水印
如何在 C# 中应用自定义 PDF 水印

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

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 只需一行代码即可在 PDF 上添加自定义水印，使用 HTML 字符串实现完全的样式控制。 应用可调节不透明度、旋转和定位的文本或图像水印，以增强文档的安全性和品牌效应。

快速入门：C# PDF编辑——轻松应用自定义水印

使用 IronPDF 添加自定义水印，只需一行代码。 使用简单的 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# 2.渲染新的或导入现有的 PDF 文档
  2. 配置用作水印的HTML字符串
  3. 使用 ApplyWatermark 方法实现水印 5.根据需要自定义水印的旋转、不透明度和位置

如何在 PDF 上应用水印？

使用 ApplyWatermark 方法将水印应用于新渲染的或现有的 PDF。 该方法接受 HTML 字符串作为水印，启用包括 CSS 样式在内的所有 HTML 功能。 下面的示例演示了使用图片和文字作为水印。 请注意，水印适用于所有页面； 不支持特定页面的水印。

在使用水印之前，请查看我们的创建 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");
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 字符串支持所有标准 HTML 元素和 CSS 样式。 包括图像、文本、自定义字体、颜色和复杂布局。 这种灵活性可以创建符合品牌要求的专业水印。 如需高级样式选项，请在水印中使用 web 字体和图标。

最终的水印 PDF 是什么样的？

轻松添加各种格式的图像水印(PNG、JPG)和自定义字体的文本水印。 水印出现在主要内容后面，确保文件的可读性，同时提供品牌或安全功能。

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

水印的默认不透明度为 50%，可根据要求进行调整。 ApplyWatermark 方法包含一个接受旋转作为参数的重载。 指定 "旋转："和 "不透明度："以调整这些参数。

对于复杂的水印场景，请探索我们的打标功能，以获得更多定制选项。

哪些参数控制水印外观？

: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

旋转参数接受的数值单位为度(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);
Imports System

' Example: Creating a subtle branded watermark
Dim brandWatermark As String = "
<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 上定位水印？

使用横向分为 3 列、纵向分为 3 行的 3x3 网格指定水印位置。 水平选项有左侧、中间和右侧； 垂直选项包括顶部、中部和底部。 这种配置可以在每个页面上设置 9 个不同的位置。 请参见下图，以获得直观的说明。

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

使用 IronPdf.Editing 命名空间中的VerticalAlignment和Horizo​​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");
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

高级定位技术

对于复杂的定位要求，请将水印与自定义边距和特定页面转换结合起来。 以下是在不同位置创建多个水印的示例：

// 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
' Example: Adding multiple watermarks with different positions
Dim dateWatermark As String = $"<p style='font-size: 10px;'>Generated: {DateTime.Now:yyyy-MM-dd}</p>"
Dim confidentialWatermark As String = "<h2 style='color: red;'>CONFIDENTIAL</h2>"
Dim pageNumberWatermark As String = "<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.安全考虑因素：对于敏感文档，请将水印与IronPDF加密结合使用。 4.性能：对于批处理，请优化水印 HTML 并使用 async 操作。

企业应用程序中的水印

对于处理大量 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
  立即与工程团队聊天
技术作家

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

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 18,560,885 | 版本: 2026.4 刚刚发布
Still Scrolling Icon

还在滚动吗？

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