1. IronPDF
  2. 操作指南
  3. 大纲和书签
如何在C#中使用IronPDF添加PDF书签和大纲

如何在 C# 中使用 IronPDF 添加 PDF 书签和大纲

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

通过 IronPdf，您可以用 C# 在 PDF 文档中添加书签（大纲），创建类似于目录的导航辅助工具。 添加单层或多层书签，提高文档的可用性，帮助用户快速跳转到关键部分。 该功能可在Windows、Linux和macOS环境中无缝运行。

快速入门：在 C# 中向 PDF 添加书签

在 PDF 文档中添加书签，快速开始使用 IronPdf。 本指南演示了如何加载现有 PDF、添加导航书签并保存更新后的文档。 非常适合希望在 C# 项目中增强 PDF 功能的开发人员。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

    var pdf = new IronPdf.PdfDocument("example.pdf");
pdf.Bookmarks.AddBookMarkAtEnd("Chapter 1", 1);
pdf.SaveAs("bookmarked.pdf");

  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronPDF

    arrow pointer

最小工作流程(5 个步骤)

  1. 从 NuGet 下载 IronPDF
  2. 加载现有或呈现新 PDF 文档
  3. 添加单层书签以跳转到关键部分
  4. 为分层组织添加多层书签
  5. 检索和查看书签属性

如何在 C# 中使用 PDF 书签？

在Adobe Acrobat Reader中，大纲(也叫书签)显示在左侧边栏，为跳转到文档的关键部分提供了一种方便的方法。 书签具有交互式目录的功能，使读者能够高效地浏览复杂的文档。

使用 IronPdf，您可以导入 PDF 文档，并对现有大纲执行各种操作，如添加、重新排序、编辑属性和删除书签。 这使您可以完全控制 PDF 文件的组织和结构，类似于您可以 [合并或分割 PDFs](/how-to/合并或分割 PDFs/) 以进行文档管理。

提示所有页面索引均采用从零开始的索引方式。

如何添加单层书签？

在 IronPdf 中添加书签非常简单。 使用 AddBookmarkAtEnd 方法，指定书签名称和相应的页面索引。 该功能与其他 PDF 操作(如添加页眉和页脚或设置自定义页边距)很好地集成在一起，以创建专业文档。 下面是一个示例：

:path=/static-assets/pdf/content-code-examples/how-to/bookmarks-single-layer-bookmark.cs
using IronPdf;

// Create a new PDF or edit an existing document.
PdfDocument pdf = PdfDocument.FromFile("existing.pdf");

// Add a bookmark
pdf.Bookmarks.AddBookMarkAtEnd("NameOfBookmark", 0);

// Add a sub-bookmark
pdf.Bookmarks.AddBookMarkAtEnd("NameOfSubBookmark", 1);

pdf.SaveAs("singleLayerBookmarks.pdf");
$vbLabelText   $csharpLabel

AddBookMarkAtEnd 方法会将书签追加到现有书签列表的末尾。要更精确地控制书签的位置，请使用 AddBookMarkAtStart 将书签插入到列表的开头。每个书签都指向一个特定的页面索引，从而可以在文档内进行精确导航。

单层书签文档

如何创建多层书签层次结构？

IronPDF 允许您以树形结构添加书签，这对于保持大型 PDF 文档的可浏览性特别有用。 当在一个 PDF 文档中处理大量不同日期和地点的试卷、销售报告或收据记录时，该功能非常有价值。 结构化书签可以帮助您分层组织复杂的信息，就像您可以创建用于数据收集的 PDF 表单一样。

AddBookMarkAtEnd 方法返回一个IPdfBookMark对象，允许您添加子书签。 例如，使用 Children.AddBookMarkAtStart("Date1", 0) 或 Children.AddBookMarkAtEnd("Date1", 0) 向"考试"书签添加子书签。 这种嵌套结构创建了一个层次组织，反映了文档的逻辑流程。 以下代码演示了这一概念：

:path=/static-assets/pdf/content-code-examples/how-to/bookmarks-multi-layer-bookmark.cs
using IronPdf;

// Load existing PDF document
PdfDocument pdf = PdfDocument.FromFile("examinationPaper.pdf");

// Assign IPdfBookMark object to a variable
var mainBookmark = pdf.Bookmarks.AddBookMarkAtEnd("Examination", 0);

// Add bookmark for days
var date1Bookmark = mainBookmark.Children.AddBookMarkAtStart("Date1", 1);

// Add bookmark for type of test
var paperBookmark = date1Bookmark.Children.AddBookMarkAtStart("Paper", 1);
paperBookmark.Children.AddBookMarkAtEnd("PersonA", 3);
paperBookmark.Children.AddBookMarkAtEnd("PersonB", 4);

// Add bookmark for days
var date2Bookmark = mainBookmark.Children.AddBookMarkAtEnd("Date2", 5);

// Add bookmark for type of test
var computerBookmark = date2Bookmark.Children.AddBookMarkAtStart("Computer", 5);
computerBookmark.Children.AddBookMarkAtEnd("PersonC", 6);
computerBookmark.Children.AddBookMarkAtEnd("PersonD", 7);

pdf.SaveAs("multiLayerBookmarks.pdf");
$vbLabelText   $csharpLabel

在处理需要详细组织的复杂文档时，这种分层方法尤为重要。 嵌套结构允许用户展开和折叠书签部分，即使在数百页的文档中也能直观地进行导航。

多层书签文档

如何检索和浏览现有书签？

IronPDF 可轻松检索和查看 PDF 文档中的书签。 通过书签树导航变得简单，并无缝访问不同部分。 在处理需要编辑的现有 PDF 文件或在书签部分实现搜索和替换文本等功能时，该功能至关重要。 Consider the multi-layer bookmarks document example above.

"考试"书签有一个 Children 属性，指向"日期1"和"日期2"书签。 "Date1"书签有一个指向"Date2"书签的NextBookmark属性。 此外，"Date1"书签具有一个包含"Paper"书签的Children属性。 这种相互关联的结构允许复杂的导航模式和文档组织。

要检索已打开的 PDF 文档中的所有书签，请使用 GetAllBookmarks 方法。 这提供了所有书签的综合列表，使您能够分析和利用书签结构：

:path=/static-assets/pdf/content-code-examples/how-to/bookmarks-retrieve-bookmark.cs
using IronPdf;

// Load existing PDF document
PdfDocument pdf = PdfDocument.FromFile("multiLayerBookmarks.pdf");

// Retrieve bookmarks list
var mainBookmark = pdf.Bookmarks.GetAllBookmarks();
$vbLabelText   $csharpLabel

合并两个书签名称相同的 PDF 文档可能会破坏书签列表。

警告仅支持从页面索引创建的书签。 来自其他 PDF 元素的书签的页面索引值将设置为 -1。

了解如何在以下文章中从HTML生成PDF时创建目录："使用IronPDF创建目录。"

准备好看看您还能做些什么吗？ 在这里查看我们的教程页面：组织PDF

常见问题解答

如何用 C# 在 PDF 文档中添加书签？

IronPDF 可让您用 C# 在 PDF 文档中轻松添加书签。您可以使用 AddBookmarkAtEnd 方法，通过指定书签名称和页面索引来添加单层书签。例如：pdf.Bookmarks.AddBookMarkAtEnd（"Chapter 1"，1）。这可以创建类似于目录的导航辅助工具，帮助用户快速跳转到关键章节。

AddBookmarkAtEnd 和 AddBookmarkAtStart 方法有什么区别？

IronPDF 提供了两种书签放置方法。AddBookMarkAtEnd 方法会将书签添加到现有书签列表的末尾，而 AddBookMarkAtStart 则会在列表的开头插入书签。这两种方法都会引用特定的页面索引，以便在文档中进行精确导航。

能否创建多层次的分级书签结构？

是的，IronPDF 允许您以树形结构创建多层书签层次结构。这对于组织具有嵌套部分的复杂文档特别有用，类似于您如何组织具有章节和子章节的详细目录。

书签功能是否兼容不同的操作系统？

IronPDF 的书签功能可在 Windows、Linux 和 macOS 环境下无缝运行。无论您的操作系统如何，您都可以添加、编辑和管理 PDF 书签，确保在不同平台上实现一致的功能。

我可以对现有 PDF 书签执行哪些操作？

使用 IronPDF，您可以对现有的 PDF 大纲执行各种操作，包括添加新书签、重新排列书签顺序、编辑书签属性以及删除不需要的书签。这样，您就可以完全控制 PDF 文件的组织和结构。

用户打开 PDF 时如何显示书签？

在 Adobe Acrobat Reader 和类似的 PDF 阅读器中，使用 IronPDF 创建的书签会在左侧边栏显示为轮廓。它们具有交互式目录的功能，允许读者通过点击跳转到特定部分来高效地浏览复杂的文档。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 17,803,474 | 版本: 2026.3 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。