Browse our Products

Aspose.Words for .NET 16.3.0 Release Notes

Major Features

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

  • Further improvements to the speed and public API for plain text extraction.
  • Render OfficeMath formulas to images separately from the document.
  • Shape and OfficeMath can now be saved to SVG.
  • Support for RC4 encryption.

Full List of Issues Covering all Changes in this Release

WORDSNET-10709/asian typography detection/ Chinese wraps to the next line when English and Chinese characters combined in one paragraphBug
WORDSNET-10710/asian typography detection/ A line starts with a punctuation mark in PDFBug
WORDSNET-12471Shape.TextBox doesn’t keep its internal margins on saveBug
WORDSNET-12475Alternate row background color (shading) is not correct in PDFBug
WORDSNET-12775Incorrect shadings applied in rendered PDFBug
WORDSNET-12794Table moves to left in generated PDFBug
WORDSNET-12807Large comment text truncated. SaveAs PDF with MS Word shows more dataBug
WORDSNET-12917Removing content from Cell changes FontBug
WORDSNET-12962/strike through shape anchor/ MS Word to PDF: Extra line is added to the bottom of the imageBug
WORDSNET-12986Docx to Pdf conversion issue with Shape renderingBug
WORDSNET-12998Document.UpdateFields does not update Section fieldBug
WORDSNET-13004Docx to Pdf Conversion modifies Hyperlinks with the Local Path of DocxBug
WORDSNET-13006/tab stops/ Text alignment is lost after DOCM to PDFBug
WORDSNET-13013/asian typography detection/ Docx to Pdf conversion issue with Chinese text renderingBug
WORDSNET-13055Text shape is transformed to text box or frameBug
WORDSNET-13091Text boxes positions are changed after re-saving DocxBug
WORDSNET-13092Image in content control is not rendered in output Doc/PdfBug
WORDSNET-13118Repeating section content control displays wrong data in PDFBug
WORDSNET-13141Document.UpdateFields does not update REF field.Bug
WORDSNET-13146RTF to Pdf conversion issue with PdfImageCompression.JpegBug
WORDSNET-13158Rotated text box (inside GroupShape) are not rotated when saved to PDFBug
WORDSNET-13180One Row Tables within a SDT are ignoredBug
WORDSNET-13191Aspose.Words reads MHTML as a text fileBug
WORDSNET-13200Document.UpdateFields lose the bold formatting of Ref fieldsBug
WORDSNET-13209Shape’s text color is changed from white to black in output PdfBug
WORDSNET-13210Unexpected page breaks appear in output PdfBug
WORDSNET-13223Aspose Words Document save to PDF distorts inserted ShapeBug
WORDSNET-13238Mergefield TableStart inside an IF field are processed although the IF condition is falseBug
WORDSNET-13241Contents are lost after saving Rtf to DocxBug
WORDSNET-13242Aspose.Words.Document hangs while loading OdtBug
WORDSNET-13246Replacement of URL (UNC) is losing \ and breaking links (FieldHyperlink.Address)Bug
WORDSNET-13247FieldHyperlink.Address ignores slashes ("") while replacing hyperlinksBug
WORDSNET-13248The space between the bullet and starting text is not uniformBug
WORDSNET-13257Rtf to Docx conversion issue with table’s borderBug
WORDSNET-13259Chinese text is wrapped incorrectlyBug
WORDSNET-13263Quote fields in the header of Pdf are rendered incorrectlyBug
WORDSNET-13266Some Paragraphs have more left indentation during importing MHTBug
WORDSNET-13268Creating TOC for text with non-BodyText OutlineLevel works unexpectedBug
WORDSNET-13276SVG image is rendered as a blank picture while importing HTML documentBug
WORDSNET-13285X-Axis labels are wrapped up into 2 lines in output Doc/PdfBug
WORDSNET-2159“NullReferenceException” occurs when move to Header/Footer after linking header to previous.Bug
WORDSNET-6882Investigate Run propertiesBug
WORDSNET-10722The document is encrypted using the RC4 CryptoAPI Encryption and this not currently supported.Enhancement
WORDSNET-11086DOCX to HTML margin issue with paragraphs that have hanging indentEnhancement
WORDSNET-11608Implement rendering Dml shadow effect for semi transparent and transparent areas.Enhancement
WORDSNET-12105Take ‘display’ style into account when importing HTML elementsEnhancement
WORDSNET-12219Counter-increment is not producing the expected outputEnhancement
WORDSNET-12221InsertOleObject does not insert default icon and name for html fileEnhancement
WORDSNET-12269Render square shapes with texture as images to preserve the texture source format. // Losing signature quality when converting word to tiffEnhancement
WORDSNET-12449Document.Save removes target="_blank" when saved to HtmlFixedEnhancement
WORDSNET-12511Author property returns incorrect textEnhancement
WORDSNET-12627Incorrect border of a horizontally merged cellEnhancement
WORDSNET-12824Shape.TextBox report incorrect margin for a DML shapeEnhancement
WORDSNET-13102Shapes become invisible after saving Rtf to Doc/Docx/PdfEnhancement
WORDSNET-13227Implement rendering Dml inner shadow effect for semi transparent and transparent areas.Enhancement
WORDSNET-13312REF fields are still being looked up from our IMailMergeDataSourceEnhancement
WORDSNET-4107WMF images are displayed incorrectly after converting to DOC/DOCXEnhancement
WORDSNET-10711Aspose.Words.UnsupportedFileFormatException is thrown while loading documentException
WORDSNET-12801Aspose.Words.UnsupportedFileFormatException is thrown while loading DocException
WORDSNET-12951Aspose.Words.FileCorruptedException is thrown while loading DotException
WORDSNET-13036System.Security.Cryptography.CryptographicException occurs when trying to sign document with pfx certificateException
WORDSNET-13107Aspose.Words.FileCorruptedException is thrown while loading DocxException
WORDSNET-13114Nested IF statements cause error when merge field contains trailing backslashException
WORDSNET-13183System.ArgumentOutOfRangeException occurs during rendering to PDFException
WORDSNET-13186IllegalStateException: This operation requires the node to be inside the main documentException
WORDSNET-13214Aspose.Words.FileCorruptedException is thrown while loading htmlException
WORDSNET-13231Document.Save throws System.IndexOutOfRangeExceptionException
WORDSNET-13237System.InvalidOperationException is thrown while saving Docx to Pdf.Exception
WORDSNET-13244MailMerge.GetRegionsHierarchy throws System.InvalidCastExceptionException
WORDSNET-13253Aspose.Words.FileCorruptedException is thrown while loading Docx.Exception
WORDSNET-13274System.InvalidOperationException occurs when saving DOCX to PDFException
WORDSNET-13283Aspose.Words throws exception when updating fieldsException
WORDSNET-13287Aspose.Words.FileCorruptedException is thrown while loading DocException
WORDSNET-13288Aspose.Words.FileCorruptedException is thrown while loading DocException
WORDSNET-11774Provide API to convert OfficeMath node to pictures (SVG, Raster images)Feature
WORDSNET-11865Support Shape.Title propertyFeature
WORDSNET-12330Provide API to convert Shape and OfficeMath nodes SVGFeature
WORDSNET-12857Provide way to get FolderPath for SystemFontSourceFeature
WORDSNET-12866Provide API to set the Aspect Ratio to ScaleFeature
WORDSNET-12942Support RC4 CryptoAPI encryptionFeature
WORDSNET-12965Support of RC4 encrypted documents created by MS Word 2007/2010/2013Feature
WORDSNET-13228Implement rendering Dml glow effect for semi transparent and transparent areas.Feature
WORDSNET-13229Implement rendering Dml soft edge effect for semi transparent and transparent areas.Feature
WORDSNET-5482Support RC4 CryptoAPI encryption algorithm.Feature
WORDSNET-13178Aspose.Words.Document constructor is very slow on the first callPerformance
WORDSNET-13255Infinite Loop when loading HTML with a specific SVG into Aspose.WordsPerformance
WORDSNET-12611Cells width are not correct in output Docx/PdfRegression

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 16.3.0. 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 a regression and modifies existing behavior is especially important and is documented here.

Renamed GetOpaqueRectangleInPixels to GetOpaqueBoundsInPixels in NodeRendererBase

WORDSNET-13230 (Tidy up NodeRendererBase class) has been resolved. We renamed GetOpaqueRectangleInPixels to GetOpaqueBoundsInPixels for names consistency and introduced GetBoundsInPixels method for consistency with other properties.

Reworked public API for PlainTextDocument creation (WORDSNET-13321)

Breaking API changes:

  • All public overloads of static Document.ExtractText methods removed
  • PlaintextDocument class renamed to PlainTextDocument
  • Added 4 public constructors to the PlainTextDocument class with signatures corresponding to the removed static Document.ExtractText methods

Shape and OfficeMath nodes can be saved as SVG

WORDSNET-12330 - (Provide API to convert Shape and OfficeMath nodes SVG) has been resolved.

Starting from 16.3.0 version it is possible to render OfficeMath formulas to image separately from whole document:

Document doc = new Document(@"C:\Temp\in.docx");
OfficeMath math = (OfficeMath)doc.GetChild(NodeType.OfficeMath, 0, true);
math.GetMathRenderer().Save(@"C:\Temp\formula.png", new ImageSaveOptions(SaveFormat.Png));

Also, now it is possible to pass SaveFormat.Svg into ImageSaveOptions, so OfficeMath and Shape nodes now can be save to SVG.

WORDSNET-12866 - Added feature to get-set AspectRatioLocked property of Shape.

Starting from 16.3.0 Version, Aspose.Words supports AspectRatioLocked property of Shape.


Shape shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

// Get/set AspectRatioLocked.
shape.AspectRatioLocked = true;

Plase none:  it is possible to get/set AspectRatioLocked for child shapes (mimic MS Word behavior), but AspectRatioLocked has effect only for top level shapes!

WORDSNET-13146 - Improvement of transparent image rendering to PDFA-1

PDF/A-1 specification prohibits transparency. In order to provide better output AW blends transparent images with white background. Previously images were blended only with PdfImageCompression.Auto. With PdfImageCompression.Jpeg transparent images were rendered by simply stripping alpha channel. Now images are blended for both PdfImageCompression.Auto and PdfImageCompression.Jpeg.