What's new in Aspose.Words for .NET

[ ]

This page describes the most interesting new Aspose.Words features introduced in recent releases.

Aspose.Words for .NET 21.9

Aspose.Words 21.9 expands the list-level formatting control.

The API is enhanced for more flexible and convenient development:

Aspose.Words for .NET 21.5, 21.6, 21.7, 21.8

Aspose.Words 21.5 improves Mail Merge and Structure Document Tag functionality, as well as working with fields.

Aspose.Words 21.6 enhances formatting and filling options and also improves document display capabilities.

Aspose.Words 21.7 expands rendering and conversion options, as well as provides an ability to work with framesets.

Aspose.Words 21.8 improves rendering and language export features, and enhances the ability to work with field update callback.

The API is enhanced for more flexible and convenient development.


Setting Charts Fill and Stroke Formatting

An ability to set fill and stroke formatting for chart series, data points, and markers has been implemented. Using the provided options, you can easily customize any of the charts as you wish.

Control the Fill Texture of Any Object

A new public method PresetTextured has been added to the Fill class to work with textures. Now it is very easy to get and apply a texture to the fill of any object. Now it is very easy to get and apply a texture to the fill of any object.

Rendering of OOXML Ink

Rendering of OOXML Ink (InkML subset) has been implemented. A new public property ImlRenderingMode and a new enumeration ImlRenderingMode have been added to control the mode of Ink rendering.

Prior to this version, Aspose.Words could only render fallback shapes for OOXML Ink objects, i.e. InkML was not actually processed and a simple pre-rendered image was used instead. And now OOXML Ink content part can be rendered directly.

Control the Maximum Number of Characters per Line

A new public property MaxCharactersPerLine has been introduced to control the maximum number of characters per line in the output document of TXT format.

Rendering to PDF/A-2

Rendering to PDF/A-2 format has been implemented by adding new values to the PdfCompliance enumeration. PDF/A-2 is based on the PDF-1.7 format and removes significant limitations of PDF/A-1 like prohibited transparency and prohibited object compression.

Work with Patterns

A simple way to get and apply a pattern to the fill of any fillable objects in a document has been presented. For this purpose, the Patterned method with two overloads and the Pattern property have been added to the Fill class and the PatternType enumeration has been added to the Drawing namespace.

Insert GIF into the Document Model

The ability to insert a GIF image into the document model using the InsertImage method has been introduced. Please note that saving a document to a format different from DOCX, DOTX, DOCM, DOTM, FOPC causes the conversion of GIF images to PNG.


A new overload of the InsertHtml method with extended options has been implemented to make this operation more flexible.

Mail Merge and Reporting

A new property RestartListsAtEachSection has been added to control whether the list numbering at each section should be restarted after executing a mail merge.


  • New methods SetCheckedSymbol and SetUncheckedSymbol have been added to set checked and unchecked symbols for your favorite structured document tags.
  • The equations created with EQ fields are now supported upon converting to all HTML-based formats.
  • Using Aspose.Words for .NET via COM Interop has been checked and the documentation has been modified according to the latest version of the VBScript engine.
  • A new public property ContinuousSectionPageNumberingRestart has been added to control the behavior for computing page numbers when a continuous section restarts page numbering.
  • An ability to work with Framesets has been added. This is the first simple API which is going to be extended upon your requests. Just tell us what you need.
  • A new PDF save option ExportLanguageToSpanTag has been added. This option allows users to customize how the /Lang entry should be exported. It can be useful for compatibility with some screen readers.
  • A new public field updating callback has been implemented. This allows you to have your own custom methods called during field update.

Aspose.Words for .NET 21.1, 21.2, 21.3, 21.4

Aspose.Words 21.1 expands loading and saving options and improves document display capabilities.

Aspose.Words 21.2 enhances font properties, improves find and replace options, and expands possibilities when converting documents.

Aspose.Words 21.3 expands rendering and reporting options, and improves interaction with styles and child nodes of the StructuredDocumentTag.

Aspose.Words 21.4 improves rendering and conversion features, and enhances the ability to work with a ranged structured document tag.


Vertical Alignment of Table Cells

A new public option VerticalAlignment to set table style vertical alignment of cells has been added.

Manipulating Themed Properties of Font Objects

A new public API, allowing to manipulate themed properties of Font objects, has been implemented.

Setting Fill Formatting of Text

Font API has been extended with the Fill properties to set fill formatting of text. It gives an ability to change, for example, the foreground color or transparency of text fill.

Convert Any Fill to Solid

A new method Solid has been added to the Fill class for processing solid fills.

Support for Advanced Typography

Support for advanced typography when saving to image formats with GDI+ or SkiaSharp, for example, on all .NET platforms and .NET Standard, has been implemented.


Markdown Document Export

A new public property ImageSavingCallback has been added to control how images are saved upon converting to Markdown format.

HTML Document Import

A new public property IgnoreNoscriptElements has been added to ignore <noscript> HTML elements upon loading HTML.

Clean Up Unused Information from a Document

A new public property UnusedBuiltinStyles has been added to the CleanupOptions class to detect and remove built-in styles that are marked as “unused” to make the document stricter.


New extension methods Select and SelectMany have been added for the LINQ Reporting Engine.

Search and Compare

A new public property SmartParagraphBreakReplacement has been added to the FindReplaceOptions object to indicate whether a paragraph break is allowed to be replaced when there is no next sibling paragraph.


Aspose.Words for .NET 20.9, 20.10, 20.11, 20.12

Aspose.Words 20.9 expands control over Macros, as well as improves the quality of converting from PDF to Word document formats.

Aspose.Words 20.10 introduces a new load format and new options for working with rendering features.

Aspose.Words 20.11 enhanced rendering options and improves document display capabilities.

Aspose.Words 20.12 has expanded the number of supported platforms – now you can work with the newly released .NET 5.0, as well as improved import of HTML documents, rendering options and the reports generation functionality.

The API is enhanced for more flexible and convenient development.


It has been verified that Aspose.Words for .NET Standard works with the newly released .NET 5.0 from Microsoft.

Supported Formats

Support for loading CHM documents has been added. CHM or Microsoft Compiled HTML Help is a proprietary format consisting of a collection of pages, index, and other navigation tools. Starting from version 20.10, it is possible to load CHM documents into Aspose.Words document model and convert them to any supported formats.


Obtaining a Document with Specified Pages

A new method ExtractPages has been added to the Document class. This method returns a new document consisting of nodes located in the current document within a specified page range. The resulting document should look like one in Microsoft Word, as if we were performing “Print specific pages” – all formatting and layout will be preserved.

Export of Specific Pages to Fixed Page Formats

A new public API has been implemented for exporting specific pages to fixed page formats. Previously, you could specify only one continuous range for rendering, but now you can specify a complex set of pages based on different page ranges or individual pages in any order. This provides a flexible way to combine pages into final documents in fixed page formats.

The First Version of SmartArt Cold Rendering

The first version of SmartArt Cold Rendering has been released. Microsoft Word generates and saves the pre-rendered drawing along with SmartArt objects. In most cases, the pre-rendered drawing is rendered well by Aspose.Words and no additional actions required. However, if the document is saved by other applications, the pre-rendered SmartArt drawing may be missing or incorrect. In this case, the SmartArt object itself should be laid-out and rendered. We call this process the SmartArt Cold Rendering, and it is now available in Aspose.Words.

New API for Chart Data Points

A new API for chart data points has been implemented. This is mainly due to some properties or methods that have been added or changed within the ChartDataPointCollection and ChartDataPoint classes. For example, you will find that the code has been changed to automatically create a data point if it does not exist yet.

Basic Support for Legacy Non-Unicode Arabian Encodings

Basic support for legacy non-Unicode Arabian encodings has been implemented. This was done for the legacy Arabic font class dating back to the 1990s that use poorly documented mechanisms and legacy Windows shaping implementations. In general, these are TrueType fonts, however they use undocumented details not defined in the TrueType or OpenType specifications and do not conform to current specifications on how to implement Unicode fonts for the Arabic language.

Embedding Fonts with PostScript Outlines into a Document

An ability to embed fonts with PostScript outlines when embedding TrueType fonts in a document upon saving has been added. This option gives more flexibility in case of using non-standard fonts. Note, that even Microsoft Word does not embed PostScript fonts, but can open documents with embedded fonts of this type.


PDF Document Import

PDF import is now faster and more accurate. Footnotes support has been implemented and integrated to the latest version.

HTML Document Import

HTML import has been modified. Previously, the MswVersion property had no effect when loading documents from HTML and HTML-based formats (for example, MHTML). All documents were loaded as if no MswVersion were specified. This has been changed, and now the HTML reader can load documents differently depending on the MswVersion value.

Report Generation

A condition evaluation extension point has been introduced. This allows users to implement custom evaluation for the IF and COMPARE fields which are very popular upon creating different types of reports.


  • The VbaReferenceCollection class and related types are exposed publicly. Now you have more control over Macros, for example, removing a Template and all its references from the code without using Microsoft Word.
  • New public properties SpellingChecked and GrammarChecked have been added to indicate if a document has been checked for spelling and grammar, respectively.

Aspose.Words for .NET 20.5, 20.6, 20.7, 20.8

Aspose.Words 20.5 introduces performance improvements and enhanced document display capabilities.

Aspose.Words 20.6 expands formatting options, makes saving to Markdown more convenient, and improves SmartArt Cold Rendering.

Aspose.Words 20.7 introduces structured document tags, expands mail merge functionality and document display capabilities.

Aspose.Words 20.8 expands the capabilities of working with images in various supported document formats and improves font substitution rules to ensure a high level of rendering.

The API is improved for more flexible and convenient development.


As you know, .NET 5 is going to be released soon, as the next step forward with .NET Core. It will be useful for you to know that .NET 5 Preview 4 is already available for testing. We have made sure and tested that Aspose.Words works fine with .NET 5 Preview 4.

Performance and Data Compression

A new public property CompressionLevel has been added for OOXML documents. Using this property, you can control the compression level when saving a document. For example, you can select the SuperFast compression level that is used in Microsoft Word. Or leave the Normal compression level used in Aspose.Words by default.

Supported Formats

A new public class MarkdownSaveOptions has been added to work with advanced options when saving a document to Markdown format. In addition to overloaded and inherited properties, the TableContentAlignment property has been added to this class to control the alignment of content in tables when converting a document to Markdown format.


Layout Callback to Interrupt the Layout Building

The long-awaited layout callback has been implemented and made available to the public. The IPageLayoutCallback interface allows your application to interrupt the process of layout building for the entire document and render only the part already built.

Formatting Options

Formatting options have been extended:

  • A new public property EmphasisMark has been added to manage the emphasis mark – an additional character that is rendered above or below the main character glyph. Now you can control its behavior using the EmphasisMark option.
  • A new public property IgnoreHeaderFooter has been added to manage the formatting of headers/footers content. Using this option, you can specify whether to ignore the source formatting of the headers/footers content if the KeepSourceFormatting formatting mode is used.

Advanced Control over Revision Options

The RevisionOptions class has been extended with new properties. Now you have more control over the revision options, such as revision bars position represented by the RevisionBarsPosition property and measurement units represented by the MeasurementUnit property.

Font Substitution Rules

A new font substitution rule has been added through the FontNameSubstitutionRule class. This rule tries to process font name suffixes in the same way as Microsoft Word does.


Watermarks in Documents

A new helper class Watermark has been introduced to work with a watermark inside a document. This class simplifies the way you add or remove a watermark in a document – now you can do it with just one line of code! You can easily create a watermark from text or an image, as well as control its display settings.

Improving SmartArt Rendering

SmartArt Cold Rendering has become even better – the processing of hyperlinks in the SmartArt data model has been implemented and the preliminary processing of the chart drawing has been improved.


  • A new ability to show or hide grammatical and spelling errors has been provided. Using the ShowGrammaticalErrors and ShowSpellingErrors properties, you can easily control the way grammatical and spelling errors are displayed in your document.
  • Two new nodes have been introduced to handle multi-section structured document tags. These structured document tags are now supported upon import/export.
  • A new public property RetainFirstSectionStart has been added to get or set a value that indicates whether the SectionStart of the first document section and its copies for subsequent data source rows are retained during mail merge or updated according to Microsoft Word behavior.
  • Markdown ‘Inline Images’ feature has been implemented to make our Markdown support even better.
  • The SkipPdfImages flag has been added to the PdfLoadOptions class to indicate whether images must be skipped when loading a PDF document.
  • Support for SVG images embedded using data URLs upon HTML import has been implemented.

Aspose.Words for .NET 20.3, 20.4

Aspose.Words 20.3 introduces support of separate DLLs for Xamarin.Android, Xamarin.Mac and Xamarin.iOS, as well as huge performance and memory improvements.

Aspose.Words 20.4 introduces support for .NET 4.6.1, 3D Effects Rendering through the OpenGL feature in two modes – basic or advanced.

The API is enhanced for more flexible and convenient development.


Xamarin Support Changes

Starting with Aspose.Words 20.3, Xamarin support has changed. In earlier versions, we provided separate DLLs for Xamarin.Android, Xamarin.Mac and Xamarin.iOS. Now Xamarin developers can use Aspose.Words for .NET Standard in all mentioned platforms. According to the .NET Standard documentation, Aspose.Words for .NET Standard 2.0 can be used with Xamarin.iOS 10.14 or newer, Xamarin.Mac 3.8 or newer, and with Xamarin.Android 8.0 or newer.

New Platform Support: .NET 4.6.1

Starting from 20.4 version, Aspose.Words has a dedicated release for .NET 4.6.1 framework.

Performance and Memory Improvements

We released Aspose.Words for .NET and, as always, Aspose.Words for Java almost at the same time. And we are pleased to present the huge performance and memory improvements in Aspose.Words for Java 20.3 due to the NodeCollectionEnumerator algorithm optimization, removing the Ref<T> objects creation from nested cycles, and Blank documents loading optimization using arraycopy for small arrays.


3D Effects Rendering Support

The first version of 3D Effects Rendering through the OpenGL feature has been released. You can select one of two rendering modes for 3D shape effects rendering – “Basic mode” or “Advanced mode”:

  • Basic mode – the default lightweight and stable rendering, based on the internal engine, but without advanced effects.
  • Advanced mode – rendering of an extended list of special effects, including advanced 3D effects, such as bevels, lighting, and materials, via OpenGL. We position this feature as experimental since it is under development, and there is a number of limitations for advanced mode.

More Chart Customization

The API for chart data labels and series has expanded. Now you have more control over data labels, series, and their formatting.

New Image Fidelity Options for PDF Format

The InterpolateImages interpolation property indicates that a PDF Reader (for example, Acrobat Reader), should smooth the image to make it look more “attractive”. For different PDF Readers, this property can work in different ways: some readers may choose to not implement this PDF feature, others use any specific implementation of interpolation that they wish. Using the InterpolateImages property is relevant if the resolution of a source image is significantly lower than the resolution of the output device.

Search and Compare

Search and compare options are extended:

  • The functionality of the FindReplaceOptions class becomes more flexible to serve your needs. It is now possible to ignore text inside revisions and fields. You can also enable the use of substitutions in the replacement pattern via the UseSubstitutions property – this makes easy to use part or whole match when replacing.
  • The Granularity option, allowing the customer to specify comparison granularity, has been added. This feature allows you to specify the exact granularity of changes to track when comparing two documents.


  • A new public property UpdateLastPrintedProperty has been added. Using this property, you can control when to update LastPrintedProperty, for example, before printing.
  • The ability to change Asian paragraph spacing and indents through the public API has been added. This is the next step of Chinese language-specific Paragraph formatting improvement.