在 Aspose.Cells 中添加带有命名目标的 PDF 书签

介绍

如果您曾经处理过冗长的 PDF 文档，您就会知道浏览一页又一页的信息是多么困难。书签通过提供快速导航点在增强用户体验方面发挥着至关重要的作用。在本教程中，我们将探讨如何在使用 Aspose.Cells for .NET 从 Excel 文件生成的 PDF 中添加带有命名目标的书签。

先决条件

在我们深入讨论细节之前，让我们确保一切准备就绪。要继续本教程，您需要：

  1. Visual Studio：它是 .NET 开发的首选 IDE。请确保您的机器上安装了它。
  2. Aspose.Cells for .NET：您需要有 Aspose.Cells 库。您可以点击下载。如果你想先试用一下，请抓住你的点击此处免费试用.
  3. .NET Framework：确保您已安装兼容版本。Aspose.Cells 支持多个版本的 .NET。
  4. C# 基础知识：掌握 C# 语法将帮助您更好地理解代码片段。 有了工具包中的这些物品，我们就可以创建带有书签的 PDF 文档了！

导入包

首先，我们需要确保我们的项目可以利用 Aspose.Cells 功能。首先在 Visual Studio 中创建一个新的 C# 项目。之后，您需要导入必要的包。您通常会在代码文件的顶部执行此操作：

using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Aspose.Cells.Rendering;
using System.Drawing.Imaging;

你知道这有多简单吗？只需添加几行代码即可解锁一个用于处理 Excel 文件的强大工具包。

步骤 1：设置目录

首先，您需要指定源目录和输出目录。这是您的初始 Excel 文件所在的位置，也是您的 PDF 的保存位置。

string sourceDir = "Your Document Directory"; //例如，“C:\\MyFiles\\”
string outputDir = "Your Document Directory"; //例如，“C:\\MyOutput\\”

将此步骤视为准备工作区。就像画家不会在没有画架或画布的情况下开始工作一样，您不应该在未指定文件位置的情况下开始编码。

步骤 2：加载源 Excel 文件

接下来，我们需要使用工作簿类将您的 Excel 文件加载到内存中。

Workbook wb = new Workbook(sourceDir + "samplePdfBookmarkEntry_DestinationName.xlsx");

加载工作簿就像打开一个充满潜力的文档。它提供对原始 Excel 文件的所有工作表、单元格和格式化功能的访问。

步骤 3：访问工作表

现在我们已经加载了工作簿，让我们访问第一个工作表。我们将引用书签的单元格位于此处。

Worksheet ws = wb.Worksheets[0];

每个艺术家都需要一块画布！在这种情况下，工作表充当您的画布，您将在其中确定哪些单元格将保存书签。

步骤 4：创建书签

访问特定单元格

让我们为特定单元格（例如单元格 C5）创建书签。我们将创建一个书签条目，将其链接到该单元格，并指定一个名称。

Cell cell = ws.Cells["C5"];
PdfBookmarkEntry bookmarkEntry = new PdfBookmarkEntry();
bookmarkEntry.Text = "Text"; //更改为您喜欢的书签名称
bookmarkEntry.Destination = cell;
bookmarkEntry.DestinationName = "AsposeCells--" + cell.Name;

您可以将其视为在文档上贴上便签。标题表示书签指向的内容，而目标（单元格 C5）表示书签将引导您在 PDF 中到达的位置。

添加子书签

我们可以通过添加子书签来增强用户体验。我们现在将访问另外两个单元格（G56 和 L4）并将它们设置为子书签。

cell = ws.Cells["G56"];
PdfBookmarkEntry subbookmarkEntry1 = new PdfBookmarkEntry();
subbookmarkEntry1.Text = "Text1"; //第一个子书签
subbookmarkEntry1.Destination = cell;
subbookmarkEntry1.DestinationName = "AsposeCells--" + cell.Name;
cell = ws.Cells["L4"];
PdfBookmarkEntry subbookmarkEntry2 = new PdfBookmarkEntry();
subbookmarkEntry2.Text = "Text2"; //第二个子书签
subbookmarkEntry2.Destination = cell;
subbookmarkEntry2.DestinationName = "AsposeCells--" + cell.Name;

这些子书签就像书中的章节一样，引导用户找到文档中更具体的内容。

将子书签添加到列表

接下来，我们将把子书签分组到我们之前创建的主书签下。

ArrayList list = new ArrayList();
list.Add(subbookmarkEntry1);
list.Add(subbookmarkEntry2);
bookmarkEntry.SubEntry = list;

这种组织创建了一种简化导航的层次结构——坚持“书签基础”以获得最佳用户体验！

步骤 5：使用书签保存 PDF

创建 PdfSaveOptions

现在是时候创建 PDF 保存选项并包含我们制作的书签了。

PdfSaveOptions opts = new PdfSaveOptions();
opts.Bookmark = bookmarkEntry;

这一步是所有之前准备工作汇集在一起的阶段。你实际上是在说：“我希望我的 PDF 不仅仅是一份平面文档，而是一个交互式指南！”

保存文档

最后，我们将工作簿保存为 PDF 格式，并将书签合并到此操作中。

wb.Save(outputDir + "outputPdfBookmarkEntry_DestinationName.pdf", opts);

就这样，您所有的辛勤工作都将得到回报，您将获得一个结构良好且带有方便书签的 PDF 文档！

结论

恭喜！您已成功使用 Aspose.Cells for .NET 创建了带有书签和命名目标的 PDF。您已学会了如何浏览 Excel 文件、访问特定单元格以及创建可增强用户交互的书签。想象一下，有了这些方便的书签，浏览 PDF 文档将变得多么容易。

常见问题解答

什么是 Aspose.Cells for .NET？

Aspose.Cells 是一个功能强大的处理 Excel 文件的库，允许您以编程方式创建、修改和转换电子表格。

我可以在免费项目中使用 Aspose.Cells 吗？

是的！如果您想在购买许可证之前探索其功能，Aspose 提供免费试用。

如何获得 Aspose.Cells 的许可证？

您可以直接从他们的购买页面.

Aspose.Cells 可以处理哪些类型的文档？

它可以处理各种格式，包括 XLSX、XLS、CSV、PDF 等。

如果我遇到问题，可以去哪里获取帮助？

您可以在Aspose 论坛.

避免在 Aspose.Cells 中输出 PDF 时出现空白页