C#代码实现在PDF文件中添加图片水印

为PDF文档添加图片水印：C#与VB.NET实现指南

在数字文档管理中，图片水印是一种常见且有效的版权保护手段。它通常作为背景标识（如Logo或特定图案）嵌入PDF文件中，既能声明所有权，也能在一定程度上防止内容的未授权使用或篡改。

那么，如何通过编程的方式，在C#或VB.NET项目中为PDF文件批量添加这类图片水印呢？接下来，我们将深入探讨几种主流的技术方案。

环境准备

在动手编码之前，需要为你的.NET项目引入一个能够处理PDF的类库。这通常以DLL文件的形式提供。

常见的引入方式有两种：

• 直接下载库文件（DLL），并手动添加到项目的引用中。
• 通过Visual Studio的NuGet包管理器进行在线安装。

完成上述配置后，PDF水印的开发工作就可以正式开始了。

PM> Install-Package Spire.PDF

为PDF添加图片水印

为PDF文档添加图片水印，其核心流程可以概括为以下几个步骤：

1. 创建PDF文档对象，并加载目标PDF文件。
2. 读取将要作为水印的图片文件。
3. 遍历文档中的每一页。
4. 在当前页面上将图片设置为背景（即水印），并精细调整其位置和大小。
5. 将处理后的文档保存为一个新的PDF文件。

下面是一个基于Spire.PDF库的完整示例代码：

using Spire.Pdf;
using System.Drawing;

namespace AddImageWatermark
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 PdfDocument 对象
            PdfDocument document = new PdfDocument();

            // 加载示例 PDF 文档
            document.LoadFromFile(@"C:\Users\Administrator\Desktop\sample.pdf");

            // 加载图片（水印图片）
            Image image = Image.FromFile(@"C:\Users\Administrator\Desktop\logo.png");

            // 获取图片的宽度和高度
            int imgWidth = image.Width;
            int imgHeight = image.Height;
         
            // 遍历 PDF 的每一页
            for (int i = 0; i < document.Pages.Count; i++)
            {
                // 获取当前页面的宽度和高度
                float pageWidth = document.Pages[i].ActualSize.Width;
                float pageHeight = document.Pages[i].ActualSize.Height;

                // 设置背景透明度（0~1，值越小越透明）
                document.Pages[i].BackgroudOpacity = 0.3f;

                // 将图片设置为当前页面的背景（水印）
                document.Pages[i].BackgroundImage = image;

                // 计算并设置图片在页面中的居中位置
                Rectangle rect = new Rectangle(
                    (int)(pageWidth - imgWidth) / 2,
                    (int)(pageHeight - imgHeight) / 2,
                    imgWidth,
                    imgHeight
                );

                document.Pages[i].BackgroundRegion = rect;
            }

            // 保存生成的 PDF 文件
            document.Sa veToFile("AddImageWatermark.pdf");

            // 关闭文档
            document.Close();
        }
    }
}

方法补充

在C#生态中，为PDF添加图片水印主要有几种不同的实现思路，各有侧重。简单来说，追求快速上手可选Spire.PDF；若需要在.NET Core等跨平台环境下进行精细控制并确保最佳兼容性，则推荐iText 7；而对于预算充足、要求工业级稳定性的企业级应用，Aspose.PDF无疑是可靠的选择。

具体区别可以参考下面这个对比表格：

1.Spire.PDF：背景图片水印 (最简单，推荐备选)

这种方式的核心在于利用BackgroundImage属性直接为页面添加背景图片，同时可以轻松设置透明度和位置，API非常直观。

安装 NuGet 包

Install-Package Spire.PDF

背景水印代码示例：基于Spire.PDF的实现思路清晰明了：加载PDF后，遍历其每一页，为每页设置背景图片，并自定义透明度和位置，整个过程一气呵成。

using Spire.Pdf;
using System.Drawing;
class Program
{
    static void Main(string[] args)
    {
        PdfDocument document = new PdfDocument();
        document.LoadFromFile("input.pdf");
        // 加载图片
        Image image = Image.FromFile("watermark.png");
        // 遍历所有页面
        for (int i = 0; i < document.Pages.Count; i++)
        {
            // 设置背景透明度
            document.Pages[i].BackgroudOpacity = 0.3f;
            // 设置背景图片
            document.Pages[i].BackgroundImage = image;
            // 设置背景位置（居中）
            float pageWidth = document.Pages[i].ActualSize.Width;
            float pageHeight = document.Pages[i].ActualSize.Height;
            // 偏移量(相对左下角)居中右上角漂移
            int imgWidth = image.Width;
            int imgHeight = image.Height;
            // 计算居中位置
            int x = (int)((pageWidth - imgWidth) / 2);
            int y = (int)((pageHeight - imgHeight) / 2);
            document.Pages[i].BackgroundRegion = new Rectangle(x, y, imgWidth, imgHeight);
        }
        document.Sa veToFile("output_spire.pdf");
        document.Close();
    }
}

代码说明：这段代码会遍历PDF的每一页，将指定图片作为背景水印居中放置，并通过透明度设置使其不会过度干扰正文阅读。

2.iText 7：PdfCanvas内容层水印 (推荐首选，兼容性最好)

这是基于iText 7库的最佳实践。它通过PdfCanvas在PDF的内容层进行绘制，能确保水印始终显示在文档的最上层，不会被其他内容覆盖。这种方法尤其适合.NET Core等现代跨平台开发场景。

安装 NuGet 包

Install-Package itext7

图片水印代码示例：通过创建PdfCanvas对象，直接在文档的“上层内容流”上绘制水印。这是目前最受推崇的做法，特别是在.NET Core / .NET 5+环境中，它能保证水印的显示优先级和兼容性。

using iText.Kernel.Geom;
using iText.Kernel.Pdf;
using iText.Kernel.Pdf.Canvas;
using iText.Layout;
using iText.IO.Image;
class Program
{
    static void Main(string[] args)
    {
        // 1. 打开 PDF 文档 (只读/写入双重)
        using (PdfDocument pdfDoc = new PdfDocument(new PdfReader("input.pdf"), new PdfWriter("output_itext7.pdf")))
        {
            ImageData imgData = ImageDataFactory.Create("watermark.png");
            // 2. 遍历每一页
            for (int i = 1; i <= pdfDoc.GetNumberOfPages(); i++)
            {
                PdfPage page = pdfDoc.GetPage(i);
                PdfCanvas canvas = new PdfCanvas(page);
                canvas.Sa veState();
                // 设置水印透明度 (PDF 图形状态)
                PdfExtGState gState = new PdfExtGState().SetFillOpacity(0.5f);
                canvas.SetExtGState(gState);
                // 3. 获取页面尺寸 (左下角为原点)
                Rectangle pageSize = page.GetPageSize();
                float x = pageSize.GetWidth() / 2;
                float y = pageSize.GetHeight() / 2;
                // 4. 绘制带旋转和居中的图片
                canvas.AddImage(imgData, x, y, true);
                canvas.RestoreState();
                canvas.Release();
            }
        }
    }
}

代码说明：PdfCanvas提供了底层的绘图指令，让水印能精确地嵌入PDF的图形流中。通过PdfExtGState可以方便地控制水印的透明度等图形状态。

3.Aspose.PDF：PdfFileStamp对象水印 (工业级)

使用PdfFileStamp和Stamp对象来为PDF添加图片图章，是Aspose.PDF库中非常稳定和精准的方法。

安装 NuGet 包

Install-Package Aspose.PDF

图片水印代码示例：通过Stamp对象将图片绑定为水印，可以对其进行高度精细的控制，包括旋转角度、放置的精确坐标以及尺寸大小。

using Aspose.Pdf;
using Aspose.Pdf.Facades;
class Program
{
    static void Main(string[] args)
    {
        // 加载 PDF 文档
        Document doc = new Document("input.pdf");
        // 用于添加图章的 Facade 类
        PdfFileStamp stampPdf = new PdfFileStamp(doc);
        // 创建图章对象并绑定图片
        Aspose.Pdf.Facades.Stamp aStamp = new Aspose.Pdf.Facades.Stamp();
        aStamp.BindImage("watermark.png");
        aStamp.IsBackground = true;          // 作为背景
        aStamp.Rotation = 90;                // 旋转角度
        aStamp.SetOrigin(100, 100);          // 左下角坐标 (单位: 磅)
        aStamp.SetImageSize(200, 200);       // 设置大小
        stampPdf.AddStamp(aStamp);
        stampPdf.Sa ve("output_aspose.pdf");
        stampPdf.Close();
        doc.Close();
    }
}

总结

综上所述，在C#中为PDF文档添加图片水印并非难事。其核心逻辑非常清晰：为文档的每一页设置背景图片，并通过透明度控制来实现水印效果。在这个基础之上，开发者可以根据实际需求，灵活调整水印的位置、大小、透明度，甚至可以扩展实现平铺水印或局部水印等复杂效果。整体而言，这些方法实现成本可控、灵活性高，非常适用于文档版权保护、品牌信息展示以及自动化文档处理等多种实际场景。