Aspose.Words for .NET logo

We are pleased to announce our next version Aspose.Words for .NET 18.7. This month’s release contains over 77 useful new features, enhancements and bug fixes. Please check the release notes to get an idea about all new features, enhancements and fixes made in this release. If you are planning to upgrade from older version of Aspose.Words to the current version, we would strongly suggest you to check the Public API and Backward Incompatible Changes section to know what APIs are changed so far.

Here is a look at just a few of the biggest features and API changes in this month’s release.

  • New typed (generic) collections and enumerators were introduced in Aspose.Words.Net public API
  • Added public property HeaderFooterBookmarksExportMode in PdfSaveOptions

Added FontSourceBase.GetAvailableFonts method

  • Added public API for revision groups
  • Introduced new comparison settings
  • A new limo stretch algorithm for VML shapes rendering was developed, which most accurately repeats the output of MS Word (limo-stretched shapes)
  • Public property OutlineOptions.CreateOutlinesForHeadingsInTables added allowing to specify whether or not to create outlines for headings inside tables
  • Public method FontSourceBase.GetAvailableFonts added. It returns the list of fonts available via specific font source
  • Improved rendering of DrawingML shapes with specified parent object extents
  • EffectExtent attributes are now taken into account when calculating the bounding box for DrawingML shapes
  • Improved EMR_ALPHABLEND record handling while rendering metafiles
  • Now hidden shapes inside the group are not visible during rendering
  • Fixed the leading spaces handling while processing EMF+ DrawString records
  • Fixed a bug when grayscale effect was incorrectly applied to metafile
  • Fixed a bug with the graphic frame rendering (invalid frame layout on the page)
  • Fixed rendering of shadow effect for transparent shapes
  • Fixed a bug with rendering of the MathML object if balanceSingleByteDoubleByteWidth property and UseFELayout property are specified
  • Improved rendering of \0 characters
  • Improved column balancing when column has footnotes
  • Improved handling of table grid when layout is changed programmatically
  • Improved table breaking in 2013 mode when it overlaps footer
  • Improved handling of “don’t add space between paragraphs of the same style” option when only one of the paragraphs have this option set
  • Fixed issue when hanging punctuation precedes inline shape
  • Fixed issue when Kinsoku rule is analyzed for shapes

In some cases, Word document has more than one section that contain bookmarks in the header/footer. We have added new feature in this version of Aspose.Words to control how header/footer bookmarks are exported in PDF. Please read the following article for more detail.

Export Bookmarks in Output PDF

Support of Revision Groups

If a document has revisions, MS Word shows the similar revisions in a group in “Reviewing Pane”. We have added support of revision group in this version of Aspose.Words to get the similar revisions e.g. insert, delete etc. We have added RevisionCollection.Groups property, RevisionGroupCollection and RevisionGroup classes in this version to work with revision groups. Please read the following article for more detail.

Access Revision Group

Get the List of Available Fonts

A new feature has been added to get the list of fonts available in Aspose.Words font engine. We have added FontSourceBase.GetAvailableFonts method in Aspose.Words 18.7 that returns the collection of PhysicalFontInfo class. This class specifies information about physical font available. For more detail, please read the following article.

How to Get Available Fonts for Rendering

Introduced new Comparison Settings

MS Word allows to compare documents with comparison settings. You can ignore document formatting, headers footers, fields, footnotes, tables, textboxes, comments and case changes when documents are compared. We have added the “comparison settings” feature in this version of Aspose.Words. Please read the following article for more detail.

Compare Word Documents and Ignore Document Formatting

Enhanced the Load Options for Text File

We have added new TxtLoadOptions class to work with load options of text files in this version of Aspose.Words. New public properties LeadingSpacesOptions and TrailingSpacesOptions have been added in this class to control the way of handling leading and trailing spaces during loading TXT file. Please read the following article for more detail.

How to Handle Leading and Trailing spaces During Loading TXT

We have added new public property TxtLoadOptions.DetectNumberingWithWhitespaces in Aspose.Words 18.7. The LoadOptions.AllowTrailingWhitespaceForListItems is obsolete property now. Use TxtLoadOptions.DetectNumberingWithWhitespaces property instead of it. Please refer to the following article for more detail.

How List Items are Recognized During Loading TXT

Support of Removing Personal Information Setting from Document

We have added new feature to remove personal information from the document. Please read the following article for more detail.

Remove Personal Information from Document

Obsolete Method Document.RemoveUnusedResources() was Removed

Obsolete method RemoveUnusedResources() was removed from Document class. Please use Document.Cleanup() method instead.

Obsolete Method ImageData.SetImage() was Removed

Obsolete method SetImage() was removed from ImageData class. Please use the ImageBytes property to set an image.

Obsolete Property PageSetup.MirrorMargins was Removed

Obsolete property MirrorMargins was removed from PageSetup class. Please use the PageSetup.MultiplePages property to set MultiplePagesType.


Starting from Aspose.Words 18.7, untyped containers like ArrayList have been replaced with typed containers like List. Please read the detail from here:
Public API and Backward Incompatible Changes

Aspose.Words for .NET Resources

The following resources will help you work with Aspose.Words for .NET:

  1. Home page of .NET API.
  2. Install using NuGet Package
  3. Documentation – up-to-date documentation containing Programmer’s Guide, Knowledge Base and much more.
  4. API Reference Guide – detailing the publicly exposed classes, methods, properties, constants & interfaces.
  5. Aspose.Words Product Family Forum – post your technical questions and queries, or any other problem you are facing while working with Aspose.Words APIs.
  6. Enable Blog Subscription – do not limit yourself, you can keep yourself updated with the latest news on Aspose.Words APIs, new features, fixes and other API related topics by subscribing to Aspose.Words blog.
  7. Examples – we have published our code examples on the social coding website Anyone could explore the code examples for learning purposes.