在 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];

每個藝術家都需要一塊畫布！在這種情況下，工作表充當畫布，您將在其中確定哪些單元格將保存書籤。

第四步：創建書籤

存取特定單元格

讓我們為特定單元格（假設為單元格 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 中出現空白頁