如何用C#实现PDF加水印与加密？

如何用C#实现PDF加水印与加密？

一、痛点场景与技术选型

当客户突然提出"给合同PDF加水印并加密保护"的需求时，开发者常面临两大难题：如何快速实现复杂PDF操作？如何平衡功能需求与开发成本？

Spire.PDF技术方案优势：

• • 免Office依赖的独立PDF组件库
• • 支持.NET Framework 4.5+ / .NET Core 3.1+
• • 免费版满足基础需求，商业版提供完整功能

免费版 vs 付费版核心差异

功能点	免费版	商业版
处理页数限制	前10页	无限制
加密功能	×	√
水印透明度	固定透明度	可自定义

二、实现原理与技术拆解

2.1 水印底层逻辑

Spire.PDF通过PdfPageBase的Canvas层实现水印绘制，支持基于向量图形的文字渲染和位图叠加两种模式

2.2 安全加密机制

采用AES-128/AES-256加密算法，通过PdfSecurity类实现：

• • 打开密码：文件访问权限
• • 权限密码：操作权限控制
• • 权限限制：打印/复制/注释等操作控制

三、实战代码实现

3.1 文字水印实现

  using Spire.Pdf;
using Spire.Pdf.Graphics;

try 
{
    PdfDocument doc = new PdfDocument();
    doc.LoadFromFile("input.pdf");
    
    //⭕重点提示：使用段落水印实现多行文字
    TextWatermark watermark = new TextWatermark();
    watermark.Text = "CONFIDENTIAL\n2024-07-20"; 
    watermark.Font = new PdfFont(PdfFontFamily.Helvetica, 30f); //`Font`控制字号
    watermark.Color = PdfRGBColor.FromArgb(128, 255, 0, 0); //`Color`设置透明度
    
    //⭕坐标系原点在页面左下角
    watermark.SetTextLayout(new PointF(50, 300)); 
    
    foreach(PdfPageBase page in doc.Pages)
    {
        page.Canvas.SetTransparency(0.5f); //`SetTransparency`控制叠加透明度
        watermark.Draw(page);
    }
    
    doc.SaveToFile("output_watermark.pdf");
}
catch(Exception ex)
{
    Console.WriteLine($"处理失败：{ex.Message}");
}

3.2 图片水印实现

  using Spire.Pdf;
using Spire.Pdf.Graphics;

try
{
    PdfDocument doc = new PdfDocument();
    doc.LoadFromFile("input.pdf");
    
    //⭕重点提示：推荐PNG格式透明背景图
    PdfImage image = PdfImage.FromFile("logo.png");
    ImageWatermark imgWatermark = new ImageWatermark();
    imgWatermark.Image = image;
    
    //⭕按页面尺寸自适应缩放
    imgWatermark.Scaling = 0.2f; //`Scaling`设置缩放比例
    imgWatermark.SetImageLayout(new PointF(100, 100)); 
    
    foreach(PdfPageBase page in doc.Pages)
    {
        page.Canvas.SetTransparency(0.3f);
        imgWatermark.Draw(page);
    }
    
    doc.SaveToFile("output_image_watermark.pdf");
}
catch(Exception ex)
{
    Console.WriteLine($"图片水印失败：{ex.Message}");
}

3.3 PDF加密保护

  using Spire.Pdf.Security;

try
{
    PdfDocument doc = new PdfDocument();
    doc.LoadFromFile("input.pdf");
    
    //⭕重点提示：商业版功能
    PdfSecurity security = doc.Security;
    security.KeySize = PdfEncryptionKeySize.Key128Bit; // 设置128位AES加密
    security.OwnerPassword = "admin@2024"; //权限密码
    security.UserPassword = "user123"; //打开密码
    
    //权限控制参数设置
    security.Permissions = PdfPermissionsFlags.Print 
                         | PdfPermissionsFlags.CopyContent;
    
    doc.SaveToFile("encrypted.pdf");
}
catch(NotSupportedException ex) 
{
    Console.WriteLine("加密功能需要商业版授权");
}

四、FAQ高频问题排查

问题场景	解决方案
水印位置偏移	调整Coordinates参数（原点在左下）
加密后无法打印	检查Permissions是否包含Print
大文件处理报错	检查是否免费版超10页限制

五、版本适配说明

1. 1. 框架支持：

   • • 全版本支持.NET Framework 4.5+
   • • Spire.PDF 8.0+ 支持.NET Standard 2.0（.NET Core 3.1 / .NET 5+）
2. 2. NuGet安装：

   Install-Package Spire.PDF -Version 8.8.0
   

3. 3. 跨平台注意：

   • • Linux环境需安装libgdi+库
   • • Docker部署时需要配置字体目录

建议实际开发前通过NuGet获取最新SDK，并参照官方技术文档（E-iceblue官网）获取最新的API变更说明。