Aspose.Words for .NET使用书签教程——在Aspose.Words中插入和删除书签

Aspose.Words For .Net是一种高级Word文档处理API，用于执行各种文档管理和操作任务。API支持生成，修改，转换，呈现和打印文档，而无需在跨平台应用程序中直接使用Microsoft Word。此外，API支持所有流行的Word处理文件格式，并允许将Word文档导出或转换为固定布局文件格式和最常用的图像/多媒体格式。

接下来我们将进入“使用书签”的介绍，在Aspose.Words中插入和删除书签。

>>Aspose.Words for .NET更新至最新版v19.10，欢迎下载体验

Aspose.Words中的书签

借助Aspose.Words，可以在报告或文档中使用书签将一些数据插入书签或对其内容应用特殊格式。同时还可以使用书签从文档中的特定位置检索文本。使用Aspose.Words使用书签执行的操作与使用Microsoft Word可以执行的操作相同。可以插入新书签，删除，移动到书签，获取或设置书签名称，获取或设置其中包含的文本。

▲插入书签

使用DocumentBuilder.StartBookmark和DocumentBuilder.EndBookmark分别通过标记书签的开始和结束来创建书签。不要忘记将相同的书签名称传递给两个方法。文档中的书签可以重叠并且可以跨越任何范围。保存文档时，格式不正确的书签或名称重复的书签将被忽略。下面的示例将一些文本添加到文档中，并将该文本括在书签中。

下面的示例演示如何创建新书签。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_WorkingWithBookmarks();

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartBookmark("My Bookmark");
builder.Writeln("Text inside a bookmark.");

builder.StartBookmark("Nested Bookmark");
builder.Writeln("Text inside a NestedBookmark.");
builder.EndBookmark("Nested Bookmark");

builder.Writeln("Text after Nested Bookmark.");
builder.EndBookmark("My Bookmark");


PdfSaveOptions options = new PdfSaveOptions();
options.OutlineOptions.BookmarksOutlineLevels.Add("My Bookmark", 1);
options.OutlineOptions.BookmarksOutlineLevels.Add("Nested Bookmark", 2);

dataDir = dataDir + "Create.Bookmark_out.pdf";
doc.Save(dataDir, options);

▲获取书签

有时有必要获取书签集合以遍历书签或出于其他目的。使用任何文档节点公开的Node.Range属性，该属性返回一个Range对象，该对象表示此节点中包含的文档部分。使用此对象检索BookmarkCollection，然后使用集合索引器获取特定的书签。

下例显示了如何从书签集合中获取书签。

// 文档目录的路径。
string dataDir = RunExamples.GetDataDir_WorkingWithBookmarks();

Document doc = new Document(dataDir + "Bookmarks.doc");

//按索引。
Bookmark bookmark1 = doc.Range.Bookmarks[0];
           
//按名称。
Bookmark bookmark2 = doc.Range.Bookmarks["Bookmark2"];

下面的示例显示如何获取或设置书签名称和文本。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_WorkingWithBookmarks();

Document doc = new Document(dataDir + "Bookmark.doc");

//使用Bookmarks集合的索引器获取所需的书签。
Bookmark bookmark = doc.Range.Bookmarks["MyBookmark"];

//获取书签的名称和文本。
string name = bookmark.Name;
string text = bookmark.Text;

//设置书签的名称和文本。
bookmark.Name = "RenamedBookmark";
bookmark.Text = "This is a new bookmarked text.";

下例显示了如何为表格添加书签。

//文档目录的路径。
string dataDir = RunExamples.GetDataDir_WorkingWithBookmarks();
            
//创建空文件
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();

//插入一个单元格
builder.InsertCell();

//调用InsertCell之后在此处开始书签
builder.StartBookmark("MyBookmark");

builder.Write("This is row 1 cell 1");

//插入一个单元格
builder.InsertCell();
builder.Write("This is row 1 cell 2");

builder.EndRow();

//插入一个单元格
builder.InsertCell();
builder.Writeln("This is row 2 cell 1");

//插入一个单元格
builder.InsertCell();
builder.Writeln("This is row 2 cell 2");

builder.EndRow();

builder.EndTable();
// 书签结尾
builder.EndBookmark("MyBookmark");

dataDir = dataDir + "Bookmark.Table_out.doc";
doc.Save(dataDir);

▲在块、单元、行级别上使用书签

书签节点被允许放置在块，单元和行级别上。在加载或保存DOCX，DOC，WML文档时，Aspose.Words会在文档节点结构中保留书签位置。您可以通过使用LoadOptions类的AnnotationsAtBlockLevel和AnnotationsAtBlockLevelAsDefault属性来控制此行为。 如果要以嵌入式书签模式打开文档，请将LoadOptions.AnnotationsAtBlockLevel属性的值设置为false。通过将LoadOptions.AnnotationsAtBlockLevelAsDefault的值设置为false，可以使此行为成为默认行为。

下面的示例显示了如何在块级别插入书签。

LoadOptions options = new LoadOptions();
options.AnnotationsAtBlockLevel = true;
Document doc = new Document(dataDir + "AnnotationsAtBlockLevel.docx", options);
DocumentBuilder builder = new DocumentBuilder(doc);

StructuredDocumentTag sdt = (StructuredDocumentTag)doc.GetChildNodes(NodeType.StructuredDocumentTag, true)[0];

BookmarkStart start = builder.StartBookmark("bm");
BookmarkEnd end = builder.EndBookmark("bm");

sdt.ParentNode.InsertBefore(start, sdt);
sdt.ParentNode.InsertAfter(end, sdt);

//将文档保存到DOCX
doc.Save(dataDir + "AnnotationsAtBlockLevel_out.docx", SaveFormat.Docx);

ASPOSE技术交流QQ群（642018183）已开通，各类资源及时分享，欢迎交流讨论！

如果您对Aspose有任何需求和疑难，记得扫描下方二维码告诉我们哦~