Aspose.Words for .NET 22.9 Release Notes

Major Features

There are 102 improvements and fixes in this regular monthly release. The most notable are:

  • TxtLoadOptions was extended with new AutoNumberingDetection option.
  • Implemented an ability to cache the header/footer shapes to reduce the size of the output PDF file.
  • Added a new feature to get FieldEQ as OfficeMath.
  • Allowed creation of structured document tags of Group type at Row level.

Full List of Issues Covering all Changes in this Release (Reported by .NET Users)

Key Summary Category
WORDSNET-13166 Implement caching of watermarks through frame xObjects New Feature
WORDSNET-17215 Table borders are not correct in PDF New Feature
WORDSNET-5844 Custom Table border style is rendering incorrectly in Fixed Page Formats New Feature
WORDSNET-24126 Inaccurate spacing between shape and next line text in footer New Feature
WORDSNET-24144 Allow creating SDT of Group type on Row level New Feature
WORDSNET-22966 Add feature to render the comments according to preferred language New Feature
WORDSNET-16836 PDF rendition differs from the source document Enhancement
WORDSNET-15408 Conversion from RTF to PDF using Words results in a squished table Enhancement
WORDSNET-7205 Cell borders are getting lost when rendering to PDF Enhancement
WORDSNET-24124 Outset border type is not rendered correctly in presence of cell spacing Enhancement
WORDSNET-5288 Table borders looks incorrectly after converting to PDF Enhancement
WORDSNET-24047 Remove CodePorting attributes from release build Bug
WORDSNET-23903 Text is overlapped after rendering SVG image Bug
WORDSNET-22945 Preserve RestartPageNumbering section property during DOCX HTML roundtrip session Bug
WORDSNET-24220 InvalidOperationException is thrown upon comparing documents Bug
WORDSNET-18559 DOCX to PDF conversion issue with text rendering Bug
WORDSNET-23624 Data label values order is changed upon rendering Bug
WORDSNET-10996 Add possiblity to generate PDF of Minimum Size (Publishing Online) Bug
WORDSNET-23112 Spaces between images are lost Bug
WORDSNET-24242 NullReferenceException when saving AZW3 to stream Bug
WORDSNET-23636 Chart legend is cut of at the bottom Bug
WORDSNET-23645 Data labels values are rendered improperly Bug
WORDSNET-18373 DOCX to PDF conversion issue with line wrapping in the middle of Russian word Bug
WORDSNET-22920 DOCX to PDF conversion breaks words and wraps parts of words to the next line Bug
WORDSNET-18637 DOCX to HTML conversion issue with background color of paragraph Bug
WORDSNET-23943 Abort pdf2word builds by timeout Bug
WORDSNET-20748 Text moves to next line after DOCX to PDF conversion Bug
WORDSNET-24251 OutOfMemoryException is thrown upon importing RTF document Bug
WORDSNET-21064 Fill entire DIV with lightblue background-color during HTML to Word Conversion Bug
WORDSNET-20308 Y-Axis labels are changed after DOCX to PDF conversion Bug
WORDSNET-24177 Page orientation is not preserved after DOCX HTML roundtrip Bug
WORDSNET-24234 NullReferenceException on UpdatePageLayout on document with charts Bug
WORDSNET-24258 Incorrect display of the radical character for the case of subscript as an argument Bug
WORDSNET-23962 Issue with line spacing when converting odt to docx Bug
WORDSNET-22229 Content are lost after DOCX to PDF conversion Bug
WORDSNET-24236 FileCorruptedException on loading DOCX document Bug
WORDSNET-23934 An image is scaled down in AW document model on reading and RTF document Bug
WORDSNET-23748 Incorrect paragraph break font size in AW document model for a WML document Bug
WORDSNET-24000 Text is wrapped improperly upon rendering Bug
WORDSNET-24001 Frame in header lost on conversion to PDF Bug
WORDSNET-24008 AW renders invisible text inside text box Bug
WORDSNET-24009 LayoutCollectorGetStartPageIndex returns incorrect page number for shape in nested table Bug
WORDSNET-24021 StackOverflowException upon loading a HTML document Bug
WORDSNET-24022 Revisions are rendered in wrong places Bug
WORDSNET-23113 Images with SMask bigger than original image are processed incorrectly Bug
WORDSNET-22894 Frame is lost after RTF to PDF conversion Bug
WORDSNET-22815 Issues after Set XML Mapping Bug
WORDSNET-24063 RTL TOC is corrupted after importing PDF document Bug
WORDSNET-24062 RTL content is reversed and has spaces after importing PDF Bug
WORDSNET-23833 LINQ Reporting Engine always considers JSON null literals as string values Bug
WORDSNET-24083 IndexOutOfRangeException is thrown upon rendering document Bug
WORDSNET-24093 Issue with conversion Word to PDF Bug
WORDSNET-23858 ArgumentOutOfRangeException is thrown upon conversion DOCX to HTML Bug
WORDSNET-24107 Blurry text occurs aftet PDF to JPG conversion via PdfFixedRenderer Bug
WORDSNET-20613 Word to pdf files become hundreds of times larger Bug
WORDSNET-23887 Caption Ref present on first para get missing Bug
WORDSNET-24109 Text wrapping is incorrect after rendering Bug
WORDSNET-24116 New style introduced after updating CXP Bug
WORDSNET-24120 Invalid positioning and alignment of elements when appending DOCX documents Bug
WORDSNET-24125 FileCorruptedException is thrown upon loading DOCX document Bug
WORDSNET-24127 Header row is duplicated when use ExtractPages method Bug
WORDSNET-24133 Hidemark handling is not right Bug
WORDSNET-24140 Nested bookmark is removed after setting text of outer bookmark Bug
WORDSNET-18759 DOCX to PDF conversion issue with word wrapping Bug
WORDSNET-24169 SDT to custom XML mapping wrong list numbering Bug
WORDSNET-24174 Floating table position property changes on conversion to docx Bug
WORDSNET-24178 Exception is thrown when converting DOCX to HTML Bug
WORDSNET-24180 Content moved to next page and extra page created Bug
WORDSNET-23669 Header contents do not match on wml to docx conversion Bug
WORDSNET-24186 NullReferenceException is thrown upon rendering document with chart Bug
WORDSNET-24185 NullReferenceException is thrown upon getting ChildNodes from imported StructuredDocumentTagRangeStart Bug
WORDSNET-24181 Incorrect nodes order in AW document model for a wml document Bug
WORDSNET-24190 Paragraph formatting is not the same in the output file Bug
WORDSNET-23787 Incorrect page margins on wml to docx conversion Bug
WORDSNET-23174 IndexOutOfRangeException in LibTiff library code Bug
WORDSNET-24196 IndexOutOfRangeException when converting RTF to PDF Bug
WORDSNET-23030 ZlibException: Bad state Unknown compression method Bug
WORDSNET-23208 InvalidOperationException at PdfObjectStreamParseObject Bug
WORDSNET-24199 ArgumentException because of an empty key in CustomDocumentProperties Bug
WORDSNET-24205 Tr class name cannot be used when AsposeWords is referenced Bug
WORDSNET-24211 Series data is not rendered on the chart area Bug
WORDSNET-24207 Incorrect handling of underline text display for formulas Bug
WORDSNET-24214 Update links in tests and test files to use new wiki Bug
WORDSNET-24218 Embedded SVG fragments are indented incorrectly when saved with PrettyFormat enabled Bug
WORDSNET-24219 Saving docx document to markdown throws exception Bug
WORDSNET-24231 Smart Arts are converted to images Bug
WORDSNET-24275 Cannot save to Azw3 when saving to stream Bug
WORDSNET-18530 Incorrect calculation of NUMPAGES fields in PDF Bug
WORDSNET-24182 Incorrect paragraphs count in AW document model for a WML document Bug

Full List of Issues Covering all Changes in this Release (Reported by Java Users)

Key Summary Category
WORDSNET-24226 DOCX to PDF Text is not alligned properly Bug
WORDSNET-24253 Tab with leader at the end of line is missed upon rendering Bug
WORDSNET-24249 Comparing the document with its exact copy shows a difference Bug
WORDSNET-24230 Thick cell borders are rendered with artifacts Bug
WORDSNET-22351 UpdatePageLayout invalidates PrintDate fields values in Header Footers Bug
WORDSNET-23551 Add an ability to convert EQ field to OfficeMath Bug
WORDSNET-23562 Numbers with decimal point are mistakenly detected as list item upon loading TXT document Bug
WORDSNET-24139 CN-CODE128 font is substituted with Courier New Bug
WORDSNET-24153 FileCorruptedException is thrown upon loading RTF document Bug
WORDSNET-24100 CommentAddReply adds reply as a separate comment instead of reply Bug
WORDSNET-24163 Word to PDF Missing content Bug
WORDSNET-24168 Text wrapping is incorrect after rendering SVG Bug
WORDSNET-24145 CardText merge field is not localized to Italian Bug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 22.9. It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in Aspose.Words which may affect existing code. Any behavior introduced that could be seen as regression and modifies the existing behavior is especially important and is documented here.

Added FieldEQ.AsOfficeMath method

Related issue: WORDSNET-23551

The following public method is added to FieldEQ class:

/// <summary>
/// Returns Office Math object corresponded to the EQ field.
/// </summary>
/// <returns>
/// Returns <c>null</c> if field code is empty or invalid, otherwise an <see cref="OfficeMath"/> instance.
/// </returns>
public OfficeMath AsOfficeMath();

Use Case: Replace EQ field with Office Math.

Document document = new Document(fileName);
FieldEQ fieldEQ = document.Range.Fields.OfType<FieldEQ>().First();

OfficeMath officeMath = fieldEQ.AsOfficeMath();

fieldEQ.Start.ParentNode.InsertBefore(officeMath, fieldEQ.Start);

Use Case: Import Office Math to another document.

Document document = new Document(fileName);
FieldEQ fieldEQ = document.Range.Fields.OfType<FieldEQ>().First();

OfficeMath officeMath = fieldEQ.AsOfficeMath();

Document doc = new Document();
doc.FirstSection.Body.FirstParagraph.AppendChild(doc.ImportNode(officeMath, true));

Added new TxtLoadOptions.AutoNumberingDetection property

Related issue: WORDSNET-23562.

The following public property is added to TxtLoadOptions class:

/// <summary>
/// Gets or sets a boolean value indicating either automatic numbering detection
/// will be performed while loading a document.
/// The default value is <c>true</c>.
/// </summary>
public bool AutoNumberingDetection

Use Case: Explains how to disable automatic numbering detection upon loading TXT document.

// Disable automatic numbering detection.
TxtLoadOptions options = new TxtLoadOptions { AutoNumberingDetection = false };
Document doc = new Document("input.txt", options);

int listItemsCount = 0;
foreach (Paragraph paragraph in doc.GetChildNodes(NodeType.Paragraph, true))
    if (paragraph.IsListItem)

    "The expected number of list items in document with 'AutoNumberingDetection' option disabled is 0." +
    " And the actual is: {0}.", listItemsCount);

// The code produces the following output:
// The expected number of list items in document with 'AutoNumberingDetection' option disabled is 0. And the actual is: 0.

Added PdfSaveOptions.CacheHeaderFooterShapes property

Related issues: WORDSNET-13166, WORDSNET-20613, WORDSNET-10996

The following public property is added to PdfSaveOptions class:

/// <summary>
/// Gets or sets a value determining whether or not to cache shapes placed in header and footer of document.
/// </summary>
/// <remarks>
/// <para> Default value is <c>false</c> and shapes are not cached.</para>
/// <para> When the value is <c>true</c> shapes graphics are written to the PDF document as an xObject.</para>
/// <para> Some shapes are not supported for caching(shapes with fields, bookmarks, HRefs).</para>
/// </remarks>
public bool CacheHeaderFooterShapes
   get { return mCacheHeaderFooterShapes; }
   set { mCacheHeaderFooterShapes = value; }

The new property allows you to cache the header/footer shapes and reduce the size of PDF output file.

Use Case:

Document doc = new Document(fileName);
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.CacheHeaderFooterShapes= true;
doc.Save(outputFileName, saveOptions);

Allowed creation of structured document tags of Group type at Row level

Related issue: WORDSNET-24144

You can now create SdtType.Group structured document tags at the MarkupLevel.Row level.

Use Case:

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

// Insert a table.
Table table = builder.StartTable();

// Create a Group structured document tag at the Row level.
StructuredDocumentTag groupSdt = new StructuredDocumentTag(doc, SdtType.Group, MarkupLevel.Row);
groupSdt.IsShowingPlaceholderText = false;

// Create a child row of the structured document tag.
Row row = new Row(doc);

// Append a cell.
Cell cell = new Cell(doc);


// Insert cell contents.
builder.Write("Some text 1");

// Insert text after the table.
builder.Write("Some text 2");

doc.Save(dir + "Out.docx");