Aspose.Words for .NET v19.7最新更新功能示例详解！

Aspose.Words for .NET更新至v19.7，为Markdown格式实现基本的读写器，同时实现了检测SmartArt形状的功能！接下来我们给大家介绍一下新版中引入的公告API的更改，并用示例实际阐述一下。

Aspose.Words for .NET是一种高级Word文档处理API，用于执行各种文档管理和操作任务。API支持生成，修改，转换，呈现和打印文档，而无需在跨平台应用程序中直接使用Microsoft Word。通过集成API，开发人员可以执行的一些基本任务，例如设计具有标准邮件合并字段的全功能MicrosoftWord 告，几种常用格式之间的可靠转换，页面的高保真渲染，所有文档元素的格式化等等。

Aspose.Words for .NET更新至v19.7，为Markdown格式实现基本的读写器，同时实现了检测SmartArt形状的功能！接下来我们给大家介绍一下新版中引入的公告API的更改，并用示例实际阐述一下。>>下载Aspose.Words for .NET最新试用版

Aspose.Words 19.7公共API的更改

▲添加了属性Revision.Group

在Revision类中添加了以下新属性：

////// Gets the revision group. Returns null if the revision does not belong to any group.///////// Revision has no group if revision type is RevisionType.StyleDefinitionChange or/// if the revision is not longer exist in document context (accepted/rejected).///public RevisionGroup Group

使用案例：

Document doc = new Document(@"source.docx");  foreach (Revision revision in doc.Revisions){    string groupText = revision.Group != null        nbsp;"Revision group text: " + revision.Group.Text        : "Revision has no group";      Console.WriteLine("Type: " + revision.RevisionType);    Console.WriteLine("Author: " + revision.Author);    Console.WriteLine("Date: " + revision.DateTime);    Console.WriteLine("Revision text: " + revision.ParentNode.ToString(SaveFormat.Text));    Console.WriteLine(groupText);}

▲为Markdown功能实现了基本的读写器

暂时支持以下Markdown功能：

• 标题
• 成批引用
• 横向规则
• 黑体强调
• 斜体强调

增加了新的公开枚举：

LoadFormat.MarkdownSaveFormat.MarkdownFileFormat.Markdown

添加了新的TxtSaveOptionsBase类：

////// The base class for specifying additional options when saving a document into a text based formats.///public abstract class TxtSaveOptionsBase : SaveOptions

一些成员从TxtSaveOptions类移动到TxtSaveOptionsBase类：

////// Specifies the encoding to use when exporting in text formats. /// Default value isEncoding.UTF8'UTF-8' Charset.///public Encoding Encoding  ////// Specifies the string to use as a paragraph break when exporting in text formats./////////The default value is.///public string ParagraphBreak  ////// Specifies whether the program should attempt to preserve layout of tables when saving in the plain text format./// The default value is false.///public bool PreserveTableLayout  //////Allows to specify whether the page breaks should be preserved during export.///The default value is false.///////// The property affects only page breaks that are inserted explicitly into a document. /// It is not related to page breaks that MS Word automatically inserts at the end of each page.///public bool ForcePageBreaks  ////// Specifies the way headers and footers are exported to the text formats./// Default value is.///public TxtExportHeadersFootersMode ExportHeadersFootersMode

功能的实现主要遵循CommonMark规范。在AW模型中，Markdown功能表示为相应的样式或直接格式。因此，粗体和斜体表示为Font.Bold和Font.Italic。标题是标题1 – 标题6样式的段落。引 是样式名称中带有“引用”的段落。HorizontalRule是具有HorizontalRule形状的段落。

使用案例1：如何生成以下Markdown文档的重点：

Markdown treats asterisks (*) and underscores (_) as indicators of emphasis.  You can write **bold** or *italic* text.   You can also write ***BoldItalic***text.

DocumentBuilder builder = new DocumentBuilder(new Document());builder.Writeln("Markdown treats asterisks (*) and underscores (_) as indicators of emphasis.");builder.Write("You can write ");builder.Font.Bold = true;builder.Write("bold");builder.Font.Bold = false;builder.Write(" or ");builder.Font.Italic = true;builder.Write("italic");builder.Font.Italic = false;builder.Writeln(" text. ");builder.Write("You can also write ");builder.Font.Bold = true;builder.Font.Italic = true;builder.Write("BoldItalic");builder.Font.Bold = false;builder.Font.Italic = false;builder.Write("text.");  builder.Document.Save("EmphasesExample.md");

使用案例2：如何使用标题生成以下Markdown文档：

The following produces headings:# Heading1## Heading2### Heading3#### Heading4##### Heading5###### Heading6# **Bold Heading1**

Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);  // By default Heading styles in Word may have bold and italic formatting.// If we do not want text to be emphasized, set these properties explicitly to false.builder.Font.Bold = false;builder.Font.Italic = false;  builder.Writeln("The following produces headings:");builder.ParagraphFormat.Style = doc.Styles["Heading 1"];builder.Writeln("Heading1");builder.ParagraphFormat.Style = doc.Styles["Heading 2"];builder.Writeln("Heading2");builder.ParagraphFormat.Style = doc.Styles["Heading 3"];builder.Writeln("Heading3");builder.ParagraphFormat.Style = doc.Styles["Heading 4"];builder.Writeln("Heading4");builder.ParagraphFormat.Style = doc.Styles["Heading 5"];builder.Writeln("Heading5");builder.ParagraphFormat.Style = doc.Styles["Heading 6"];builder.Writeln("Heading6");  // Note, emphases are also allowed inside Headings:builder.Font.Bold = true;builder.ParagraphFormat.Style = doc.Styles["Heading 1"];builder.Writeln("Bold Heading1");  doc.Save("HeadingsExample.md");

使用案例3：如何使用块引 生成以下Markdown文档：

We support blockquotes in Markdown:>*Lorem*>*ipsum*  The quotes can be of any level and can be nested:>>>Quote level 3>>>>Nested quote level 4>>*Back to first level*> ### Headings are allowed inside Quotes

Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);  builder.Writeln("We support blockquotes in Markdown:");builder.ParagraphFormat.Style = doc.Styles["Quote"];builder.Writeln("Lorem");builder.Writeln("ipsum");builder.ParagraphFormat.Style = doc.Styles["Normal"];builder.Writeln("The quotes can be of any level and can be nested:");Style quoteLevel3 = doc.Styles.Add(StyleType.Paragraph, "Quote2");builder.ParagraphFormat.Style = quoteLevel3;builder.Writeln("Quote level 3");Style quoteLevel4 = doc.Styles.Add(StyleType.Paragraph, "Quote3");builder.ParagraphFormat.Style = quoteLevel4;builder.Writeln("Nested quote level 4");builder.ParagraphFormat.Style = doc.Styles["Quote"];builder.Writeln();builder.Writeln("Back to first level");Style quoteLevel1WithHeading = doc.Styles.Add(StyleType.Paragraph, "Quote Heading 3");builder.ParagraphFormat.Style = quoteLevel1WithHeading;builder.Write("Headings are allowed inside Quotes");  doc.Save("QuotesExample.md");

使用案例4：如何使用水平规则生成以下Markdown文档：

We support Horizontal rules (Thematic breaks) in Markdown:  -----

DocumentBuilder builder = new DocumentBuilder(new Document());  builder.Writeln("We support Horizontal rules (Thematic breaks) in Markdown:");builder.InsertHorizontalRule();  builder.Document.Save("HorizontalRuleExample.md");

使用案例5：如何阅读Markdown文档：

// This is Markdown document that was produced in example of UC3.Document doc = new Document("QuotesExample.md");  // Let's remove Heading formatting from a Quote in the very last paragraph.Paragraph paragraph = doc.FirstSection.Body.LastParagraph;paragraph.ParagraphFormat.Style = doc.Styles["Quote"];  doc.Save("QuotesModifiedExample.md");

▲实现了检测SmartArt形状的功能

将以下新属性添加到Shape类：

////// Returns true if this Shape has a SmartArt object.///public bool HasSmartArt

使用案例：在文档中使用SmartArt计算多个形状。

Document doc = new Document(@"input.docx");  int count = 0;foreach (Shape shape in doc.GetChildNodes(NodeType.Shape, true)){    if (shape.HasSmartArt)        count++;}  Console.WriteLine("The document has {0} shapes with SmartArt.", count);

▲实现了对OpenType字体的支持和对Kerning功能的支持

新的公共属性TextShaperFactory已添加到LayoutOptions类。

public ITextShaperFactory TextShaperFactory { get; set; }

应通过单独的nuget-packages提供ITextShaperFactory的实现。具体实现应创建一个表示字体的文本整形器，并计算文本的整形信息。下面是一个用法示例：

public void Test(){    // Open a document    Document doc = new Document("OpenType.Document.docx");      // When text shaper factory is set, layout starts to use OpenType features.    // An Instance property returns static BasicTextShaperCache object wrapping HarfBuzzTextShaperFactory    doc.LayoutOptions.TextShaperFactory = Aspose.Words.Shaping.HarfBuzz.HarfBuzzTextShaperFactory.Instance;      // Render the document to PDF format    doc.Save("OpenType.Document.pdf");}

▲WORDSNET-11297 – 实现了用于处理链接文本框的公共API

添加了一个用于从文本框中获取父形状的公共属性，以允许客户从链接的TextBox中查找链接的Shape。

////// Determines whether this TextBox can be linked to the target Textbox.///public bool IsValidLinkTarget(TextBox target){}  ////// Returns or sets a TextBox that represents the next TextBox in a sequence of shapes.///public TextBox Next{  get; set;}  ////// Returns a TextBox that represents the previous TextBox in a sequence of shapes.///public TextBox Previous{  get;}  ////// Breaks the forward link for the specified TextBox, if such a link exists.///////// BreakForwardLink() doesn't break all other links in the current sequence of shapes./// For example: 1-2-3-4 sequence and BreakForwardLink at the 2-nd textbox will create/// two sequences 1-2, 3-4.///public void BreakForwardLink(){}  ////// Gets a parent shape for the TextBox.///public Shape Parent{    get { return mParent; }}

使用案例：创建从shape1.TextBox到shape2.TextBox的链接。

TextBox textBox1 = shape1.TextBox;TextBox textBox2 = shape2.TextBox;  if (textBox1.IsValidLinkTarget(textBox2))  textBox1.Next = textBox2;

使用案例：检查shape.TextBox是序列的头部，尾部还是中间。

TextBox textBox = shape.TextBox;  if ((textBox.Next != null) && (textBox.Previous == null)){  //The head of the sequence.}  if ((textBox.Next != null) && (textBox.Previous != null)){  //The Middle of the sequence.}  if ((textBox.Next == null) && (textBox.Previous != null)){  //The Tail of the sequence.}

使用案例：破坏shape.TextBox的链接。

TextBox textBox = shape.TextBox;  // Break a forward linktextBox.BreakForwardLink();  // Break a forward link by setting a nulltextBox.Next = null;  // Break a link, which leads to this textboxif (textBox.Previous != null)  textBox.Previous.BreakForwardLink();

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

标签：