介紹

瀏覽大型 PDF 檔案通常感覺就像大海撈針，尤其是當它們是由大量 Excel 電子表格產生時。 PDF 文件中的書籤提供了在文件相關部分之間跳轉的無縫方式，從而增強了使用者體驗。本詳細指南將引導您完成使用 Aspose.Cells for .NET 將帶有命名目的地的書籤新增至從 Excel 檔案產生的 PDF 的過程。

使用 Aspose.Cells for .NET 的先決條件

在深入研究程式碼之前，必須確保您已設定好所有工具以成功實施。以下是先決條件：

Visual Studio：推薦用於 .NET 開發的 IDE。確保它已在您的系統上安裝並正確配置。
Aspose.Cells for .NET：以程式設計方式操作 Excel 檔案所需的核心程式庫。你可以點此下載。如果您是 Aspose 新手，您可以從免費試用.
.NET Framework：確保您使用的是相容版本的 .NET Framework。 Aspose.Cells 支援多個版本。
基本 C# 知識：對 C# 的基本了解將有助於遵循程式碼。

有了這些元件，您就可以開始建立帶有書籤的 PDF 文件了！

設定你的項目

一旦您的開發環境準備就緒，您就可以繼續在 Visual Studio 中建立一個新的 C# 專案。為了使用 Aspose.Cells 功能，您需要匯入所需的命名空間。

導入所需的命名空間

在 C# 檔案的頂部，加入以下內容 using 語句以確保您的專案可以存取 Aspose.Cells for .NET：

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

這些命名空間提供對基本類別的訪問，可協助您操作 Excel 資料並將其轉換為 PDF。

步驟 1：設定輸入和輸出檔案的目錄

第一步是定義輸入和輸出檔案目錄。這可確保來源 Excel 檔案和產生的 PDF 檔案位於正確的位置。

string sourceDir = "Your Document Directory";  // Excel 檔案的路徑
string outputDir = "Your Document Directory"; // 輸出 PDF 的儲存路徑

這類似於在開始一個專案之前組織您的工作空間。

步驟2：載入Excel工作簿

下一步是載入來源 Excel 檔案。 Aspose.Cells 讓您可以輕鬆地將 Excel 檔案載入到 Workbook 對象，提供對其所有工作表、儲存格和內容的存取。

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

這將打開工作簿並準備進行操作。現在您可以開始提取資料並將其格式化為 PDF。

步驟 3：訪問工作表

現在工作簿已加載，是時候存取書籤相關儲存格所在的工作表了。在此範例中，我們將使用第一個工作表：

Worksheet ws = wb.Worksheets[0]; // 訪問第一個工作表

此步驟為您的書籤建立了畫布。您將引用的書籤的每個單元格都來自此工作表。

步驟 4：建立帶有命名目標的書籤

此時，我們可以開始建立書籤。書籤本質上是提供對文件特定區域的快速存取的連結。在此範例中，我們將為儲存格「C5」建立書籤。

為單一儲存格建立書籤

要建立書籤，您必須先造訪要連結到的儲存格。之後，您將建立一個 PdfBookmarkEntry 並將其與細胞的位置連結起來。

Cell cell = ws.Cells["C5"];
PdfBookmarkEntry bookmarkEntry = new PdfBookmarkEntry();
bookmarkEntry.Text = "Bookmark for C5"; // 書籤的文本
bookmarkEntry.Destination = cell;  // 將書籤連結到單元格
bookmarkEntry.DestinationName = "AsposeCells--" + cell.Name; // 唯一目的地名稱

可以將其視為在文件中標記一個點，只需單擊即可返回該點。您可以將任何文字指派給書籤（如「C5 的書籤」）並將其連結到特定的儲存格。

新增子書籤以增強導航

您可以透過新增從主書籤分支出來的子書籤來增強使用者體驗。這些子書籤可以指向同一工作表內的不同區域或其他工作表。

cell = ws.Cells["G56"];
PdfBookmarkEntry subbookmarkEntry1 = new PdfBookmarkEntry();
subbookmarkEntry1.Text = "Sub-Bookmark 1"; // 第一個子書籤的文本
subbookmarkEntry1.Destination = cell;
subbookmarkEntry1.DestinationName = "AsposeCells--" + cell.Name;

cell = ws.Cells["L4"];
PdfBookmarkEntry subbookmarkEntry2 = new PdfBookmarkEntry();
subbookmarkEntry2.Text = "Sub-Bookmark 2"; // 第二個子書籤的文本
subbookmarkEntry2.Destination = cell;
subbookmarkEntry2.DestinationName = "AsposeCells--" + cell.Name;

這些子書籤充當了瀏覽文件的附加路標，就像書中的章節一樣。

將子書籤分組到主書籤下

為了建立層次結構，您可以在主書籤下方新增這些子書籤。這使得用戶更容易導航到不同的部分。

ArrayList list = new ArrayList();
list.Add(subbookmarkEntry1);
list.Add(subbookmarkEntry2);
bookmarkEntry.SubEntry = list; // 向主書籤加子書籤

這會建立一個樹狀結構，其中每個書籤可以有多個子書籤。

步驟 5：使用書籤儲存 PDF

設定 PDF 儲存選項

在將文件儲存為 PDF 之前，我們需要指定儲存選項並確保包含書籤。我們將使用 PdfSaveOptions 為了這個目的。

PdfSaveOptions opts = new PdfSaveOptions();
opts.Bookmark = bookmarkEntry;  // 將書籤分配給 PDF

這會告訴 Aspose.Cells 產生包含我們剛剛建立的書籤的 PDF。

儲存文件

現在書籤已設置，我們可以將工作簿儲存為 PDF。

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

這將產生帶有可點擊書籤的最終 PDF，允許使用者快速跳到文件的特定部分。

結論

透過遵循這些簡單的步驟，您已經使用 Aspose.Cells for .NET 從 Excel 檔案成功建立了具有書籤和命名目標的 PDF。新增書籤的功能不僅可以增強使用者體驗，還可以使大型文件中的導航更加有效率。無論您正在編寫報告、指南還是演示文稿，為關鍵部分添加書籤都會幫助您的讀者充分利用您的文件。

常見問題解答

什麼是 Aspose.Cells for .NET？

Aspose.Cells for .NET 是一個用於處理 Excel 檔案的強大 API，可讓您以程式設計方式建立、編輯和轉換 Excel 文件。您可以使用此工具輕鬆地處理資料、圖表和格式。

如何免費試用 Aspose.Cells for .NET？

您可以從以下位置下載 Aspose.Cells for .NET 的免費試用版這裡.

Aspose.Cells 可以使用哪些檔案格式？

Aspose.Cells 支援多種檔案格式，包括 XLSX、XLS、CSV、PDF 等。

我可以自動建立 PDF 中的書籤嗎？

是的！透過在您的應用程式中整合 Aspose.Cells，該流程可以完全自動化，從而允許您在工作流程中動態生成帶有書籤的基於 Excel 的 PDF。

在哪裡可以獲得 Aspose.Cells for .NET 的支援？

您可以訪問 Aspose 論壇提出問題或報告問題。