通过 C# 检测 PDF 文件加密状态

在.NET 平台的文档处理开发中，批量处理 PDF 文件是非常常见的需求。而带密码保护的加密 PDF，会直接导致文档读取、编辑等操作抛出异常，因此提前检测 PDF 是否加密是文档预处理的关键步骤。

本文将分享一种轻量、高效的实现方案，使用Free Spire.PDF for .NET免费组件，仅需几行代码即可完成 PDF 加密状态检测，代码简洁、无需手动解析 PDF 底层格式，适合快速集成到项目中

为什么需要检测 PDF 加密

自动化处理流程：在批量处理 PDF 时，先检测加密状态，避免对加密文件执行读取、提取文本等操作时抛出异常。
用户体验：在应用程序中打开 PDF 前，提前告知用户文件受密码保护。
安全审计：记录系统中哪些 PDF 文件已加密。

准备工作

安装 Free Spire.PDF

通过 NuGet 包管理器安装，包名称为 FreeSpire.PDF。

Install-Package FreeSpire.PDF

该版本为免费版，足以满足基础检测需求。

检测 PDF 是否加密

PdfDocument 类提供了一个静态方法 IsPasswordProtected(string fileName)，只需传入 PDF 文件路径，即可返回布尔值结果。

下面是一个完整的控制台示例，代码将直接输出检测结果：

using Spire.Pdf;

namespace CheckIfPdfIsProtected
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 待检测的 PDF 文件路径
            string pdfPath = "sample.pdf";

            // 核心代码：检测PDF是否加密
            bool isProtected = PdfDocument.IsPasswordProtected(pdfPath);

            // 控制台输出结果
            if (isProtected)
            {
                Console.WriteLine("该PDF文件已加密！");
            }
            else
            {
                Console.WriteLine("该PDF文件未加密！");
            }
        }
    }
}

代码解析

调用静态方法：PdfDocument.IsPasswordProtected(pdfPath) 内部读取 PDF 文件的头部和加密字典，判断是否设置了打开密码或权限密码。
结果处理：返回 true 表示文件已加密（无论是否需要密码才能打开），返回 false 表示未加密。
输出结果：纯控制台输出，方便快速查看。

实际使用中的几个注意点

无需提供密码：该方法只判断是否存在加密，并不尝试解密。即使文件有密码，也不会要求输入密码。
性能：该方法仅读取文件的一小部分元数据，对大多数 PDF 文件都能快速返回结果，适合批量检测。
文件不存在或损坏：如果文件路径无效或 PDF 结构严重损坏，库会抛出异常。建议在实际使用中加入 try-catch 处理。
Free 版本限制：Free Spire.PDF 对 PDF 操作有10 页的页数限制，但 IsPasswordProtected 方法不受此限制，可以放心使用。

扩展：结合解密逻辑

如果需要同时处理解密，可以配合 PdfDocument.LoadFromFile(string fileName, string password) 方法加载加密文件。但注意，如果密码错误会抛出异常，需要先捕获并处理。

if (PdfDocument.IsPasswordProtected(pdfPath))
{
    Console.Write("请输入PDF密码：");
    string pwd = Console.ReadLine();
    
    using (PdfDocument doc = new PdfDocument())
    {
        doc.LoadFromFile(pdfPath, pwd);
        // 密码正确的话，到这里就能正常操作文档了
        // 如果密码错，LoadFromFile 会抛异常
    }
}
else
{
    // 没加密，直接加载
    using (PdfDocument doc = new PdfDocument())
    {
        doc.LoadFromFile(pdfPath);
    }
}

总结

借助 Free Spire.PDF 的 IsPasswordProtected 静态方法，我们能够以极少的代码量判断 PDF 文件的加密状态。该方法稳定、高效，适用于各种 .NET 应用程序（控制台、WinForms、ASP.NET 等）。通过本文的示例代码，你可以快速集成 PDF 加密检测功能，提升程序的健壮性与用户体验。

通过 C# 检测 PDF 文件加密状态