Spire.PDF for .NET 是一个功能强大且易于使用的库，用于在C#中操作PDF文档的书签（也称为大纲）。

C# 使用 Spire.PDF 进行PDF书签操作指南

本指南详细介绍了如何使用Spire.PDF库在C#中进行PDF书签的添加、删除、修改和读取操作。Spire.PDF是一个强大的.NET库，无需安装Adobe Acrobat或其他第三方软件即可处理PDF文档。

Spire.PDF简介

Spire.PDF是一个专业的.NET PDF组件，用于创建、编辑、处理和阅读PDF文档。它支持多种PDF操作功能，包括：

PDF文档合并/拆分
格式转换（如HTML转PDF，PDF转图片等）
打印（包括静默打印）
压缩PDF文档
添加/修改/删除书签
添加注释
安全设置（包括数字签名）
创建与填充表单域
图片插入与提取
文本提取与高亮

该库不依赖Adobe Acrobat，分为商业版和免费版两种版本。免费版支持处理不超过10页的PDF文档。

安装与引用

你可以通过以下两种方式安装Spire.PDF库：

通过NuGet安装（推荐）

在Visual Studio的NuGet包管理器控制台中运行以下命令：

Install-Package Spire.PDF

手动添加DLL引用

从官方下载地址下载Spire.PDF
解压下载的文件
在Visual Studio项目中，右键单击"引用"→"添加引用"→"浏览"
找到并选择解压后的Spire.PDF.dll文件

添加书签

1. 创建新PDF并添加书签

以下代码演示了如何创建一个新的PDF文档并添加书签：

using System;
using Spire.Pdf;
using Spire.Pdf.Bookmarks;
using Spire.Pdf.General;
using System.Drawing;

class Program
{
    static void Main(string[] args)
    {
        // 实例化PdfDocument对象
        PdfDocument pdf = new PdfDocument();
        
        // 添加页面
        PdfPageBase page = pdf.Pages.Add();
        
        // 添加书签
        PdfBookmark bookmark = pdf.Bookmarks.Add("第一页");
        
        // 设置书签所指向的页面和位置（0,0）表示页面的开始位置
        bookmark.Destination = new PdfDestination(page);
        bookmark.Destination.Location = new PointF(0, 0);
        
        // 设置书签的文本格式和颜色
        bookmark.DisplayStyle = PdfTextStyle.Bold;
        bookmark.Color = Color.Black;
        
        // 保存文档
        pdf.SaveToFile("Bookmark.pdf");
        System.Diagnostics.Process.Start("Bookmark.pdf");
    }
}

2. 添加子书签

Spire.PDF支持创建多级书签结构，以下是如何添加子书签的示例：

// 创建PDF文档和页面
PdfDocument pdf = new PdfDocument();
PdfPageBase page = pdf.Pages.Add();

// 添加父书签
PdfBookmark bookmark = pdf.Bookmarks.Add("第一章 热传导");
bookmark.Destination = new PdfDestination(page);
bookmark.Destination.Location = new PointF(0, 0);
bookmark.DisplayStyle = PdfTextStyle.Bold;
bookmark.Color = Color.SeaGreen;

// 添加子书签
PdfBookmark childBookmark = bookmark.Insert(0, "1.1 热传导基本知识");
childBookmark.Destination = new PdfDestination(page);
childBookmark.Destination.Location = new PointF(400, 300);
childBookmark.DisplayStyle = PdfTextStyle.Regular;
childBookmark.Color = Color.Black;

// 保存文档
pdf.SaveToFile("ChildBookmark.pdf");

3. 向现有PDF添加书签

你也可以向现有的PDF文档添加书签：

// 加载现有文档
PdfDocument pdf = new PdfDocument();
pdf.LoadFromFile("示例.pdf");

// 遍历所有页面添加书签
for (int i = 0; i < pdf.Pages.Count; i++)
{
    // 添加书签
    PdfBookmark bookmark = pdf.Bookmarks.Add(string.Format("第{0}章", i + 1));
    
    // 设置书签指向的页面和位置
    bookmark.Destination = new PdfDestination(pdf.Pages[i]);
    bookmark.Destination.Location = new PointF(0, 0);
    
    // 设置书签的文本格式和颜色
    bookmark.DisplayStyle = PdfTextStyle.Bold;
    bookmark.Color = Color.Black;
}

// 保存文档
pdf.SaveToFile("Bookmark2.pdf");

删除书签

1. 按索引删除书签

using System;
using Spire.Pdf;
using Spire.Pdf.Bookmarks;

class Program
{
    static void Main(string[] args)
    {
        // 加载文档
        PdfDocument pdf = new PdfDocument();
        pdf.LoadFromFile("Bookmark.pdf");
        
        // 获取书签集合
        PdfBookmarkCollection bookmarks = pdf.Bookmarks;
        
        // 删除第一个书签
        bookmarks.RemoveAt(0);
        
        // 保存文档
        pdf.SaveToFile("RemoveBookmark.pdf");
        System.Diagnostics.Process.Start("RemoveBookmark.pdf");
    }
}

2. 按名称删除书签

// 加载文档
PdfDocument pdf = new PdfDocument();
pdf.LoadFromFile("Bookmark.pdf");

// 获取书签集合
PdfBookmarkCollection bookmarks = pdf.Bookmarks;

// 遍历书签并删除指定名称的书签
for (int i = bookmarks.Count - 1; i >= 0; i--)
{
    if (bookmarks[i].Title == "要删除的书签名称")
    {
        bookmarks.RemoveAt(i);
    }
}

// 保存文档
pdf.SaveToFile("RemoveBookmarkByName.pdf");

3. 清空所有书签

// 加载文档
PdfDocument pdf = new PdfDocument();
pdf.LoadFromFile("Bookmark.pdf");

// 清空所有书签
pdf.Bookmarks.Clear();

// 保存文档
pdf.SaveToFile("ClearAllBookmarks.pdf");

修改书签

1. 修改现有书签属性

using System;
using Spire.Pdf;
using Spire.Pdf.Bookmarks;
using System.Drawing;

class Program
{
    static void Main(string[] args)
    {
        // 加载文档
        PdfDocument pdf = new PdfDocument();
        pdf.LoadFromFile("Bookmark.pdf");
        
        // 获取书签集合
        PdfBookmarkCollection bookmarks = pdf.Bookmarks;
        
        // 获取第一个书签
        PdfBookmark bookmark = bookmarks[0];
        
        // 修改书签属性
        bookmark.Destination = new PdfDestination(pdf.Pages[1]); // 修改指向的页面
        bookmark.DisplayStyle = PdfTextStyle.Bold; // 修改文本样式
        bookmark.Color = Color.Green; // 修改颜色
        bookmark.Title = "修改后的书签名称"; // 修改标题
        
        // 保存文档
        pdf.SaveToFile("ModifyBookmark.pdf");
        System.Diagnostics.Process.Start("ModifyBookmark.pdf");
    }
}

2. 在现有书签列表中插入新书签

// 加载文档
PdfDocument pdf = new PdfDocument();
pdf.LoadFromFile("Bookmark.pdf");

// 在指定位置插入新书签（此处插入到第三个位置）
PdfBookmark bookmark = pdf.Bookmarks.Insert(2, "新增第三章");

// 设置书签所指向的页面和位置
bookmark.Destination = new PdfDestination(pdf.Pages[1]);
bookmark.Destination.Location = new PointF(0, 300);

// 保存文档
pdf.SaveToFile("InsertBookmark.pdf");

读取书签

以下代码演示如何读取PDF文档中的书签信息：

using System;
using Spire.Pdf;
using Spire.Pdf.Bookmarks;
using System.Text;

class Program
{
    static void Main(string[] args)
    {
        // 实例化PdfDocument对象并加载PDF文件
        PdfDocument doc = new PdfDocument();
        doc.LoadFromFile("test.pdf");
        
        // 获取文档的书签
        PdfBookmarkCollection bookmarks = doc.Bookmarks;
        
        // 创建StringBuilder存储书签信息
        StringBuilder builder = new StringBuilder();
        
        // 遍历书签
        for (int i = 0; i < bookmarks.Count; i++)
        {
            PdfBookmark bookmark = bookmarks[i];
            builder.AppendLine("书签名称: " + bookmark.Title);
            builder.AppendLine("文本样式: " + bookmark.DisplayStyle.ToString());
            builder.AppendLine("颜色: " + bookmark.Color.ToString());
            builder.AppendLine("------------------------");
        }
        
        // 输出书签信息
        Console.WriteLine(builder.ToString());
        
        // 将书签信息保存到文本文件（可选）
        System.IO.File.WriteAllText("BookmarkInfo.txt", builder.ToString());
    }
}

参考代码 C# PDF书签删除，添加(采用Spire.Pdf.dll) www.youwenfan.com/contentzhd/46000.html

完整示例

下面是一个完整的示例，演示了如何添加、修改和删除书签：

using System;
using Spire.Pdf;
using Spire.Pdf.Bookmarks;
using Spire.Pdf.General;
using System.Drawing;
using System.Text;

class Program
{
    static void Main(string[] args)
    {
        // 创建新PDF文档
        PdfDocument pdf = new PdfDocument();
        
        // 添加三页
        for (int i = 0; i < 3; i++)
        {
            PdfPageBase page = pdf.Pages.Add();
            // 在每页添加一些文本
            page.Canvas.DrawString($"第{i+1}页内容", 
                                  new System.Drawing.Font("Arial", 12), 
                                  Brushes.Black, 
                                  new PointF(100, 100));
        }
        
        // 添加书签
        for (int i = 0; i < pdf.Pages.Count; i++)
        {
            PdfBookmark bookmark = pdf.Bookmarks.Add($"第{i+1}章");
            bookmark.Destination = new PdfDestination(pdf.Pages[i]);
            bookmark.Destination.Location = new PointF(0, 0);
            bookmark.DisplayStyle = PdfTextStyle.Bold;
            bookmark.Color = Color.Black;
        }
        
        // 保存初始文档
        pdf.SaveToFile("InitialWithBookmarks.pdf");
        Console.WriteLine("已创建带书签的初始文档");
        
        // 修改第二个书签
        PdfBookmark secondBookmark = pdf.Bookmarks[1];
        secondBookmark.Title = "修改后的第二章";
        secondBookmark.Color = Color.Blue;
        
        // 添加一个子书签到第二个书签
        PdfBookmark childBookmark = secondBookmark.Insert(0, "2.1 子节");
        childBookmark.Destination = new PdfDestination(pdf.Pages[1]);
        childBookmark.Destination.Location = new PointF(0, 200);
        childBookmark.Color = Color.Green;
        
        // 保存修改后的文档
        pdf.SaveToFile("ModifiedBookmarks.pdf");
        Console.WriteLine("已修改书签并添加子书签");
        
        // 删除第一个书签
        pdf.Bookmarks.RemoveAt(0);
        
        // 保存最终文档
        pdf.SaveToFile("FinalWithoutFirstBookmark.pdf");
        Console.WriteLine("已删除第一个书签");
        
        // 读取并显示所有书签
        StringBuilder builder = new StringBuilder();
        builder.AppendLine("最终书签结构:");
        foreach (PdfBookmark bookmark in pdf.Bookmarks)
        {
            DisplayBookmark(bookmark, 0, builder);
        }
        
        Console.WriteLine(builder.ToString());
        System.IO.File.WriteAllText("BookmarkStructure.txt", builder.ToString());
    }
    
    static void DisplayBookmark(PdfBookmark bookmark, int level, StringBuilder builder)
    {
        // 添加缩进以显示层级关系
        string indent = new string(' ', level * 2);
        builder.AppendLine($"{indent}书签: {bookmark.Title}");
        
        // 递归显示子书签
        foreach (PdfBookmark child in bookmark)
        {
            DisplayBookmark(child, level + 1, builder);
        }
    }
}

注意事项

免费版限制：Spire.PDF免费版支持处理不超过10页的PDF文档，并且可能会在生成的文档中添加水印。
性能考虑：处理大型PDF文档时，请注意内存使用和性能。
错误处理：在实际应用中，请添加适当的错误处理机制（try-catch块）来处理可能出现的异常。
书签深度：Spire.PDF支持多级书签嵌套，但过深的嵌套可能会影响某些PDF阅读器的性能。
坐标系统：PDF中的坐标系统原点(0,0)位于页面的左下角，注意设置正确的位置坐标。
保存选项：保存文档时，可以考虑使用不同的保存选项优化输出文件大小和质量。

通过本指南，你应该能够使用Spire.PDF库在C#中有效地进行PDF书签的添加、删除、修改和读取操作。这些功能对于创建结构化的、易于导航的PDF文档非常有用。

C# 使用 Spire.PDF 进行PDF书签操作指南

C# 使用 Spire.PDF 进行PDF书签操作指南

目录

Spire.PDF简介

安装与引用

通过NuGet安装（推荐）

手动添加DLL引用

添加书签

1. 创建新PDF并添加书签

2. 添加子书签

3. 向现有PDF添加书签

删除书签

1. 按索引删除书签

2. 按名称删除书签

3. 清空所有书签

修改书签

1. 修改现有书签属性

2. 在现有书签列表中插入新书签

读取书签

完整示例

注意事项