如何用C#使用iTextSharp添加PDF水印

在C#项目开发中，经常需要对生成的PDF文件添加水印来标识版权、状态等信息，iTextSharp是一款功能强大的PDF处理库，能够轻松实现各类PDF操作，其中添加水印是其实用功能之一。本文将详细介绍使用iTextSharp为PDF添加水印的具体实现方法。

iTextSharp环境准备

首先需要引入iTextSharp库，可通过NuGet包管理器搜索iTextSharp安装，也可以手动下载对应版本的DLL文件添加到项目引用中。安装完成后，在代码文件中添加对应的命名空间引用：

using iTextSharp.text;
using iTextSharp.text.pdf;
using System.IO;

添加文字水印实现

文字水印是最常见的水印类型，可设置水印内容、字体、颜色、旋转角度、透明度等属性，以下是为PDF每页添加倾斜文字水印的完整代码：

public void AddTextWatermark(string sourcePdfPath, string outputPdfPath, string watermarkText)
{
    // 读取原始PDF文件
    PdfReader pdfReader = new PdfReader(sourcePdfPath);
    // 创建输出文件流
    FileStream outputStream = new FileStream(outputPdfPath, FileMode.Create);
    // 创建PDF写入器
    PdfStamper pdfStamper = new PdfStamper(pdfReader, outputStream);
    
    // 设置水印字体，这里使用系统自带的宋体，也可加载自定义字体
    BaseFont baseFont = BaseFont.CreateFont(@"C:WindowsFontssimsun.ttc,0", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
    // 获取PDF总页数
    int pageCount = pdfReader.NumberOfPages;
    
    for (int i = 1; i <= pageCount; i++)
    {
        // 获取当前页的内容字节，允许在已有内容上方添加内容
        PdfContentByte contentByte = pdfStamper.GetOverContent(i);
        // 设置透明度，0为完全透明，1为完全不透明
        PdfGState gState = new PdfGState();
        gState.FillOpacity = 0.3f;
        contentByte.SetGState(gState);
        // 设置字体和字号
        contentByte.SetFontAndSize(baseFont, 40);
        // 设置水印颜色为浅灰色
        contentByte.SetColorFill(BaseColor.LIGHT_GRAY);
        // 保存当前画布状态
        contentByte.SaveState();
        // 将画布原点移动到页面中心
        contentByte.ConcatCTM(1, 0, 0, 1, pdfReader.GetPageSize(i).Width / 2, pdfReader.GetPageSize(i).Height / 2);
        // 旋转画布45度，让水印呈倾斜状态
        contentByte.ConcatCTM(0.707f, 0.707f, -0.707f, 0.707f, 0, 0);
        // 绘制水印文字，设置居中显示
        contentByte.BeginText();
        contentByte.ShowTextAligned(Element.ALIGN_CENTER, watermarkText, 0, 0, 0);
        contentByte.EndText();
        // 恢复画布状态
        contentByte.RestoreState();
    }
    
    // 关闭资源
    pdfStamper.Close();
    pdfReader.Close();
    outputStream.Close();
}

添加图片水印实现

除了文字水印，有时候需要使用图片作为水印，比如企业logo，实现逻辑和文字水印类似，以下是添加图片水印的代码：

public void AddImageWatermark(string sourcePdfPath, string outputPdfPath, string watermarkImagePath)
{
    PdfReader pdfReader = new PdfReader(sourcePdfPath);
    FileStream outputStream = new FileStream(outputPdfPath, FileMode.Create);
    PdfStamper pdfStamper = new PdfStamper(pdfReader, outputStream);
    
    // 读取水印图片
    Image watermarkImage = Image.GetInstance(watermarkImagePath);
    // 设置图片大小
    watermarkImage.ScaleToFit(200, 200);
    // 设置图片透明度
    PdfGState gState = new PdfGState();
    gState.FillOpacity = 0.2f;
    
    int pageCount = pdfReader.NumberOfPages;
    for (int i = 1; i <= pageCount; i++)
    {
        PdfContentByte contentByte = pdfStamper.GetOverContent(i);
        contentByte.SetGState(gState);
        // 设置图片位置为页面中心
        watermarkImage.SetAbsolutePosition(
            (pdfReader.GetPageSize(i).Width - watermarkImage.ScaledWidth) / 2,
            (pdfReader.GetPageSize(i).Height - watermarkImage.ScaledHeight) / 2
        );
        // 将图片添加到页面
        contentByte.AddImage(watermarkImage);
    }
    
    pdfStamper.Close();
    pdfReader.Close();
    outputStream.Close();
}

方法调用示例

完成上述方法定义后，可在主程序中调用对应方法实现水印添加，示例如下：

class Program
{
    static void Main(string[] args)
    {
        string sourcePath = @"D:test.pdf";
        string textWatermarkOutput = @"D:test_text_watermark.pdf";
        string imageWatermarkOutput = @"D:test_image_watermark.pdf";
        
        // 调用文字水印添加方法
        AddTextWatermark(sourcePath, textWatermarkOutput, "内部资料 禁止外传");
        // 调用图片水印添加方法
        AddImageWatermark(sourcePath, imageWatermarkOutput, @"D:logo.png");
        
        Console.WriteLine("水印添加完成");
    }
}

注意事项

• 使用iTextSharp操作PDF时，需要确保原始PDF文件没有被其他进程占用，否则会抛出文件访问异常。
• 添加中文字体时，必须保证字体文件存在且路径正确，同时设置编码为BaseFont.IDENTITY_H才能正常显示中文，避免出现乱码。
• 水印的透明度、位置、大小等参数可根据实际需求调整，若需要添加多个水印，可在循环中添加多次绘制逻辑。
• 操作完成后要及时关闭PdfStamper、PdfReader和文件流，避免资源泄露。

C#iTextSharpPDF水印PDF操作修改时间：2026-06-14 13:51:33