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系列产品最高可享10000元高额减免！更多活动详情可咨询在线客服哦~

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);//将文档保存到DOCXdoc.Save(dataDir + "AnnotationsAtBlockLevel_out.docx", SaveFormat.Docx);

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

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

标签：