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

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

Chaknith Bin
Chaknith Bin
已更新:
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 功能的开发人员。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件：

  1. 使用 NuGet 包管理器安装 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 操作（如[添加页眉和页脚](/how-to/headers-and-footers/)或[设置自定义页边距](/how-to/custom-margins/)）很好地集成在一起，以创建专业文档。 下面是一个示例： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/bookmarks-single-layer-bookmark.cs ``` `AddBookMarkAtEnd` 方法将书签添加到现有书签列表的末尾。要对书签位置进行更多控制，请使用 `AddBookMarkAtStart` 在列表的开头插入书签。每个书签都会引用一个特定的页面索引，从而实现文档内的精确导航。 #### 单层书签文档

如何创建多层书签层次结构？ --> <！--说明：显示代码执行输出或结果的截图 --> IronPDF 允许您以树形结构添加书签，这对于保持大型 PDF 文档的可浏览性特别有用。 当在一个 PDF 文档中处理大量不同日期和地点的试卷、销售报告或收据记录时，该功能非常有价值。 结构化书签可以帮助您分层组织复杂的信息，就像您可以[创建用于数据收集的 PDF 表单](/how-to/create-forms/)一样。 `AddBookMarkAtEnd`方法返回一个**IPdfBookMark**对象，允许您添加子书签。 例如，使用 `Children.AddBookMarkAtStart("Date1", 0)` 或 `Children.AddBookMarkAtEnd("Date1", 0)` 向 "Examination "书签添加子书签。 这种嵌套结构创建了一个层次组织，反映了文档的逻辑流程。 以下代码演示了这一概念： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/bookmarks-multi-layer-bookmark.cs ``` 在处理需要详细组织的复杂文档时，这种分层方法尤为重要。 嵌套结构允许用户展开和折叠书签部分，即使在数百页的文档中也能直观地进行导航。 #### 多层书签文档

如何检索和浏览现有书签？ <！--说明：显示 PDF 文档中书签导航工作原理的流程图 --> IronPDF 可轻松检索和查看 PDF 文档中的书签。 通过书签树导航变得简单，并无缝访问不同部分。 在处理需要编辑的[现有 PDF 文件](/how-to/metadata/)或在书签部分实现[搜索和替换文本](/how-to/find-replace-text/)等功能时，该功能至关重要。 Consider the multi-layer bookmarks document example above. Examination "书签有一个 `Children` 属性，指向 "Date1 "和 "Date2 "书签。 Date1 "书签具有指向 "Date2 "书签的 `NextBookmark` 属性。 此外，"Date1 "书签有一个 `Children` 属性，其中包含 "Paper "书签。 这种相互关联的结构允许复杂的导航模式和文档组织。 要检索打开的 PDF 文档中的所有书签，请使用 `GetAllBookmarks` 方法。 这提供了所有书签的综合列表，使您能够分析和利用书签结构： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/bookmarks-retrieve-bookmark.cs ``` [{i:(合并两个具有相同书签名称的 PDF 文档会破坏书签列表。

警告仅支持通过页面索引创建的书签。 来自其他 PDF 元素的书签的页面索引值将设置为 `-1`.
了解如何在以下文章中从HTML生成PDF时创建目录："[使用IronPDF创建目录](/how-to/table-of-contents/)。" 准备好看看您还能做些什么吗？ 在这里查看我们的教程页面：[组织PDF](https://ironpdf.com/tutorials/organize-pdfs-complete-tutorial/)

常见问题解答

如何用 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 创建的书签会在左侧边栏显示为轮廓。它们具有交互式目录的功能，允许读者通过点击跳转到特定部分来高效地浏览复杂的文档。

Chaknith Bin
Chaknith Bin
  立即与工程团队聊天
软件工程师
Chaknith 在 IronXL 和 IronBarcode 工作。他在 C# 和 .NET 方面有着深厚的专业知识，帮助改进软件并支持客户。他从用户互动中获得的见解有助于更好的产品、文档和整体体验。
准备开始了吗？
Nuget 下载 17,012,929 | 版本: 2025.12 刚刚发布