使用 Aspose.Words for .NET 在 Word 文件中建立書籤
Contents
[
Hide
]
介紹
瀏覽大型文件可能具有挑戰性，但書籤使其變得輕而易舉！本教學將指導您使用 Aspose.Words for .NET 在 Word 文件中建立書籤。您將逐步學習如何設定文件、添加書籤以及將其另存為 PDF。讓我們開始吧！
先決條件
在投入之前，請確保您具備以下條件：
- Aspose.Words for .NET Library：從以下位址下載並安裝它這裡.
- 開發環境：使用 Visual Studio 或任何與 .NET 相容的 IDE。
- 基本 C# 知識：熟悉 C# 程式設計概念將會很有幫助。
導入命名空間
首先，導入必要的命名空間以使用 Aspose.Words：
using Aspose.Words;
using Aspose.Words.Saving;
第 1 步：設定文件和 DocumentBuilder
建立一個新文件並初始化DocumentBuilder，它允許您添加內容和書籤。
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
第 2 步：建立主書籤
要建立書籤，您需要指定其起點和終點。建立名為「我的書籤」的書籤的方法如下：
builder.StartBookmark("My Bookmark");
builder.Writeln("Text inside the main bookmark.");
StartBookmark：標記書籤的開頭。Writeln：在書籤內加入文字。
第 3 步：建立巢狀書籤
您可以嵌套書籤以更好地組織。以下是在「我的書籤」中加入「嵌套書籤」的方法：
builder.StartBookmark("Nested Bookmark");
builder.Writeln("Text inside the nested bookmark.");
builder.EndBookmark("Nested Bookmark");
- 嵌套可讓您建立層次結構。
EndBookmark：關閉目前書籤。
步驟 4：在嵌套書籤之外添加文本
建立嵌套書籤後，繼續在主書籤中添加內容：
builder.Writeln("Text after the nested bookmark.");
builder.EndBookmark("My Bookmark");
這可確保主書籤包括嵌套書籤和任何附加文字。
步驟 5：設定 PDF 儲存選項
若要在 PDF 中包含書籤，請配置儲存選項：
PdfSaveOptions options = new PdfSaveOptions();
options.OutlineOptions.BookmarksOutlineLevels.Add("My Bookmark", 1);
options.OutlineOptions.BookmarksOutlineLevels.Add("Nested Bookmark", 2);
PdfSaveOptions：定義文件儲存為 PDF 的方式。BookmarksOutlineLevels：設定 PDF 中書籤的層次結構。
第 6 步：儲存文檔
最後，將文件另存為 PDF：
doc.Save(dataDir + "WorkingWithBookmarks.CreateBookmark.pdf", options);
這Save方法以指定的格式和位置儲存文檔，並附帶書籤。
結論
使用 Aspose.Words for .NET 在 Word 文件中建立書籤非常簡單，並且增強了文件導航。無論您是產生報告、電子書還是管理大量文檔，書籤都是非常寶貴的。按照本教學操作，您很快就會擁有一個組織良好、帶有書籤的 PDF！
常見問題解答
我可以建立多個不同等級的書籤嗎？
是的！儲存為 PDF 時，您可以建立多個書籤並定義它們的層次結構。
如何更新書籤的文字？
使用DocumentBuilder.MoveToBookmark導航至書籤並更新文字。
可以刪除書籤嗎？
絕對地！使用Bookmarks.Remove方法透過指定書籤的名稱。
我可以建立 PDF 以外的其他格式的書籤嗎？
是的，Aspose.Words 支援 DOCX、HTML 和 EPUB 等格式的書籤。
如何確保書籤在 PDF 中正確顯示？
定義BookmarksOutlineLevels正確地在PdfSaveOptions以確保書籤包含在 PDF 大綱中。