C#使用iText获取PDF的trailer数据的代码示例

2025-09-24 12:50

本文主要是介绍C#使用iText获取PDF的trailer数据的代码示例,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《C#使用iText获取PDF的trailer数据的代码示例》开发程序debug的时候,看到了PDF有个trailer数据,挺有意思,于是考虑用代码把它读出来,那么就用到我们常用的iText框架了,所...

引言

开发程序debug的时候,看到了PDF有个trailer数据,挺有意思,于是考虑用代码把它读出来,那么就用到我们常用的iText框架了。

实际上,使用 iText 获取 PDF 的 trailer 数据是一个稍微底层一些的操作,但完全可以实现。trailer 是 PDF 文件结构的核心部分,它告诉解析器如何找到文件的关键部分,比如交叉引用表 (xref)、文档信息字典 (/Info) 和文档根对象 (/Root)。

在 iText 中,这个操作被很好地封装了。本文将详细说明能从 trailer 中获得什么信息。

iText 核心概念

  • 高级抽象 vs. 底层访问: iText 提供了高级的类,如 PdfDocumentInfoPdfCatalog,来方便地访问 trailer 指向的内容。例如,pdfDocument.GetDocumentInfo() 会自动找到 trailer 中的 /Info 条目并解析它。
  • 直接访问: 同时,iText 也允许你直接获取 trailer 本身,它是一个 PdfDictionary 对象。这对于需要检查非标准字段或进行底层分析的程序员来说非常有用。

C# 代码示例

这个示例将演示如何打开一个 PDF 文件,并同时使用高级方法和底层方法来检查 trailer 相关的数据。

步骤 1: 确保已安装 iText

请在你的项目中通过 NuGet 包管理器安装 itext

Install-Package itext

步骤 2: C# 代码

using System;
using System.IO;
using iText.Kernel.Pdf;

public class PdfTrailerInspector
{
    public static void InspectPdfTrailer(string filePath)
    {
        if (!File.Exists(filePath))
        {
            Console.WriteLine($"错误:文件不存在 '{filePath}'");
            return;
        }

        try
        {
            // 使用 PdfReader 和 PdfDocument 打开 PDF 文件
            using (var pdfReader = new PdfReader(filePath))
            using (var pdfDocument = new PdfDocument(pdfReader))
            {
                Console.WriteLine($"--- 正在分析文件: {Path.GetFileName(filePath)} ---");

                // --- 方法 1: 使用高级 API 访问 Trailer 指向的内容 (推荐的常规做法) ---
                Console.WriteLine("\n=== 通过高级 API 获取 Trailer 指向的信息 ===");
                
                // GetDocumentInfo() 会读取 trailer 的 /Info 字典
                PdfDocumentInfo docInfo = pdfDocument.GetDocumentInfo();
                Console.WriteLine($"信息字典 (来自 /Info): Creator = {docInfo.GetCreator()}, Producer = {docInfo.GetProducer()}");
                
                // GetCatalog() 会读取 trailer 的 /Root 字典,这是文档的入口点
                PdfCatalog catalog = pdfDocument.GetCatalog();
                Console.WriteLine($"文档目录 (来自 /Root): 页面模式 = {catalog.GetPageMode()}, 页面布局 = {catalog.GetPageLayout()}");

                // --- 方法 2: 直接访问和遍历 Trailer 字典本身 (底层操作) ---
                Console.WriteLine("\n=== 直接访问 Trailer 字典的原始键值对 ===");
                
                // 使用 GetTrailer() 直接获取 Trailer 字典对象
                PdfDictionary trailer = pdfDocument.GetTrailer();

                if (trailer != null)
                {
                    // 遍历 Trailer 字典中的所有条目
                    foreach (var key in trailer.KeySet())
                    {
                        PdfObject value = trailer.Get(key); // 值 (可能是数字、引用等)

                        Console.WriteLine($"键: {key}, 值: {value}, 值的类型: {value.GetType().Name}");
                    }

                    // 你也可以直接获取特定的键
                    Console.WriteLine("\n--- 单独获取 Trailer 中的关键值 ---");
                    PdfObject size = trailer.Get(PdfName.Size);
                    PdfObject root = trailer.Get(PdfName.Root);
                    PdfObject info = trailer.Get(PdfName.Info);
                    PdfObject id = trailer.Get(PdfName.ID);

                    Console.WriteLine($"大小 (Size): {size}");
                    Console.WriteLine($"根对象引用 (Root): {root}");
                    Console.WriteLine($"信息字典引用 (Info): {info}");
                    Console.WriteLine($"文件ID (ID): {id}");
                }
                else
                {
                    Console.WriteLine("无法获取 Trailer 字典。");
                }
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"读取 PDF 时发生错误: {ex.Messagphpe}");
        }
    }

    public static void Main(string[] args)
    {
        // 请将 "C:\\path\\to\\your\\document.pdf" 替换为你的 PDF 文件路径
   php     string pdfPath = "C:\\path\\to\\your\\document.pdf"; 
        InspectPdfTrailer(pdfPath);
    }
}

程序运行效果

C#使用iText获取PDF的trailer数据的代码示例

解读 Trailer 的输出

当你运行上面的代码并查看“直接访问 Trailer 字典”部分的输出时,你会看到类似下面的内容:

键: /Size, 值: 2www.chinasem.cn5, 值的类型: PdfNumber
键: /Root, 值: 23 0 R, 值的类型: PdfIndirectReference
键: /Info, 值: 1 0 R, 值的类型: PdfIndirectReference
键: /ID, 值: [<0DDB5968...>, <F3C3B2A6...>], 值的类型: PdfArray

这里是对这些关键条目的解释:

  • /Size: (类型: PdfNumber) 表示 PDF 文件中对象的总数(大约值)。
  • /Root: (类型: PdfIndirectReference) 这是一个间接引用,指向文档的根对象(Catalog 字典)。23 0 R 的意思是“第 23 号对象,第 0 代”。iText 使用这个引用来找到文档的所有页面和其他核心内容。pdfDocument.GetCatalog() 就是帮你完成了这个查找过程。
  • /Info: (类型: PdfIndirectReference) 同样是一个间接引用,指向文档的信息字典(包含作者、标题等元数android据)。1 0 R 指向第 1 号对象。pdfDocument.GetDocumentInfo() 会自动解析这个引用。
  • /ID: (类型: PdfArray) 这是一个包含两个字符串的数组,用于唯一标识该 PDF 文件。第一个字符串在文件创建时生成,并且永不改变。第二个字符串在每次保存文件时都会更新。这对于追踪文件的版本非常有用。
  • /Prev (可选): 如果文件是增量更新的,这个键会指向前一个版本的交叉引用表的位置。
  • /Encrypt (可选): 如果文件被加密,这个键会指向加密字典。

总结

  1. 常规需求: 如果我们只是想获取作者、标题、页面内容等信息,使用 iText 的高级 API(GetDocumentInfo(), GetCatalog(), GetPage() 等)就足够了,它们在后台为你处理了 trailer 的解析。
  2. 底层分析: 如果你需要检查 trailer 的所有原始条目,或者查找可能存在的非标准字段,或者想验证 PDF 结构,那么使用 pdfDocument.GetTrailer() 是最直接和强大的方法。

上面的代码提供了两种,我们可以根据具体需求选择使用。

到此这篇关于C#使用iText获取PDF的trailer数据的代码示例的文章就介绍到这了,更多相关C# iText获取PDF的trailer数据内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多js多支持编程China编程(www.chinasem.cn)!

这篇关于C#使用iText获取PDF的trailer数据的代码示例的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1156009

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本,并kill2.1 进程查看2.2 遇到的

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三

k8s按需创建PV和使用PVC详解

《k8s按需创建PV和使用PVC详解》Kubernetes中,PV和PVC用于管理持久存储,StorageClass实现动态PV分配,PVC声明存储需求并绑定PV,通过kubectl验证状态,注意回收... 目录1.按需创建 PV(使用 StorageClass)创建 StorageClass2.创建 PV

Python版本信息获取方法详解与实战

《Python版本信息获取方法详解与实战》在Python开发中,获取Python版本号是调试、兼容性检查和版本控制的重要基础操作,本文详细介绍了如何使用sys和platform模块获取Python的主... 目录1. python版本号获取基础2. 使用sys模块获取版本信息2.1 sys模块概述2.1.1

一文解析C#中的StringSplitOptions枚举

《一文解析C#中的StringSplitOptions枚举》StringSplitOptions是C#中的一个枚举类型,用于控制string.Split()方法分割字符串时的行为,核心作用是处理分割后... 目录C#的StringSplitOptions枚举1.StringSplitOptions枚举的常用

Redis 基本数据类型和使用详解

《Redis基本数据类型和使用详解》String是Redis最基本的数据类型,一个键对应一个值,它的功能十分强大,可以存储字符串、整数、浮点数等多种数据格式,本文给大家介绍Redis基本数据类型和... 目录一、Redis 入门介绍二、Redis 的五大基本数据类型2.1 String 类型2.2 Hash