Browse our Products

Aspose.Words for .NET 25.5 Release Notes

Major Features

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

  • Chart Styling: Added the ability to set chart style.
  • Markdown Export: Added the possibility to control how empty paragraphs are exported into Markdown.

Full List of Issues Covering all Changes in this Release

Expand to view the full list of issues.
KeySummaryCategory
WORDSNET-28134Consider providing an option to insert line break after every 76 characters in the base64 image representationNew Feature
WORDSNET-27647Add an ability to set chart styleNew Feature
WORDSNET-28124Consider marking text box content with textbox tagNew Feature
WORDSNET-28109Support of rendering Waterfall ChartExNew Feature
WORDSNET-28034Support MSO properties during import paragraphsNew Feature
WORDSNET-28200Remove Microsoft.Win32.Registry dependency for .NET 6 and latterEnhancement
WORDSNET-28061Default setting for ChartExEnhancement
WORDSNET-24870Support MSO properties during import textEnhancement
WORDSNET-28063Allow using images as an input in LowCode classesEnhancement
WORDSNET-9979Provide PdfSaveOptions.EnableHTTPCompression in APIBug
WORDSNET-2231Consider adding PdfOption.Linearization propertyBug
WORDSNET-22099Allow to Create PDF File with “Fast Web View” Set to YesBug
WORDSNET-21066Linearization Property in PdfSaveOptions ClassBug
WORDSNET-27606Page numbers in INDEX are incorrect if call update field onceBug
WORDSNET-27595Page numbers in INDEX field are incorrectBug
WORDSNET-27936REF field value is not shown after updating fieldsBug
WORDSNET-28089Aspose.Words doesn’t write w:clear on page break w:br elements in DOCX documentsBug
WORDSNET-28007MS Word doesn’t write w:equa Width attribute for w:cols elementBug
WORDSNET-28084The output SVG document contains double id attribute in g elementBug
WORDSNET-27485Improve text block detection upon importing PDFBug
WORDSNET-28043DOC to MD: Redundant empty lines in the outputBug
WORDSNET-28198Background in WMF is rendered improperlyBug
WORDSNET-28181Redundant font cloningBug
WORDSNET-28099Number of revision returned by Aspose.Words does not match MS WordBug
WORDSNET-28098Revision number returned by Aspose.Words does not match MS Word outputBug
WORDSNET-28097Number of revision is incorrectBug
WORDSNET-28096Revision returned by Aspose.Words not match WordBug
WORDSNET-28094Aspose.Words returns number of revision which does not match MS WordBug
WORDSNET-28093Looks like revision count does not match the count provided by MS WordBug
WORDSNET-27847Wrong layout when converting particular RTF to PDFBug
WORDSNET-28047ArgumentOutOfRangeException when using regex replacing inside RunBug
WORDSNET-28180OcrException in the ‘Aspose.Words.Pdf2Word.dll’Bug
WORDSNET-28177Text wrapping around floaters is incorrect when text contains NoBreakHyphenBug
WORDSNET-28157Line break differs between DOCX and PDFBug
WORDSNET-28191StackOverflowException is thrown upon loading PDF documentBug
WORDSNET-28104References are missing in TOC page reference when export to MarkdownBug
WORDSNET-27878Multi-level category labels are rendered improperlyBug
WORDSNET-28062NullReferenceException when converting 2nd page of input DOCS to fixed-HTMLBug
WORDSNET-27818LINQ Reporting Engine - Performance issue on a large documentBug
WORDSNET-28006Implement better support for br HTML elementBug
WORDSNET-27997Implement import of page breaksBug
WORDSNET-28050Trailing br elements are imported incorrectly from MsoHtmlBug
WORDSNET-28005Implement import of breaks into correct paragraphBug
WORDSNET-28045Break elements are imported incorrectly from MsoHtmlBug
WORDSNET-27747Add support for loading of native lists with more than 9 levelsBug
WORDSNET-28207Text position is incorrect after renderingBug
WORDSNET-28056List numbering differs from MS Word’s resultBug
WORDSNET-28107Importing of the lists differs from MS Word’s resultBug
WORDSNET-28106Aspose.Words imports lists not like MS Word doesBug
WORDSNET-28105List item importing looks different then from MS Word’s resultBug
WORDSNET-28076List importing differs from MS Word’s resultBug
WORDSNET-28055List item formatting differs from MS Word’s resultBug
WORDSNET-28176When rendering a cloned APS tree, glyphs with the same font are not mergedBug
WORDSNET-28174Add support for the “mso-outline-level” property of MsoHtml documentsBug
WORDSNET-28165Apply ‘w:hint=“default”’ when loading ‘font-family’ into a character style formatting from MsoHtmlBug
WORDSNET-28167Add support for the “mso-no-proof” property when loading MsoHtmlBug
WORDSNET-28139Add support for the “supportLineBreakNewLine” HTML contitional expression feature when loading MsoHtmlBug
WORDSNET-28137Font formatting is not applied to BR elements with the “page-break-before:always” style loaded from MsoHtmlBug
WORDSNET-28151Aliases of built-in styles are imported incorrectly from MsoHtmlBug
WORDSNET-28150Linked built-in styles are imported incorrectly from MsoHtmlBug
WORDSNET-26498Justification is incorrect after renderingBug
WORDSNET-28127RTL text position is incorrect after renderingBug
WORDSNET-28065Number of revision returned by Aspose.Words does not match MS WordBug
WORDSNET-24803Wrapping in OfficeMath is incorrect after renderingBug
WORDSNET-28117Compare result does not match MS Word outputBug
WORDSNET-28112Bookmark is lost after comparing documentsBug
WORDSNET-28054Excessive rotations are caused by rendering textboxes inside table cells with rotated contentBug
WORDSNET-28078br element with “clear” attribute is not imported as a text wrapping line break from MsoHtmlBug
WORDSNET-27968Field code is rendered in the outputBug
WORDSNET-16892Processing floater table before stretcher line in 2013 modeBug
WORDSNET-19388Page with Picture missing after Aspose.Words convert to PDFBug
WORDSNET-27913Image is lost in outputBug
WORDSNET-27026Suppress extra line spacing the way WordPerfect 5.x does - incorrect line heights on conversion to PDFBug
WORDSNET-28113Content is invisible after renderingBug
WORDSNET-28087Hide properties for ImageWatermarkOptions and TextWatermarkOptions for WatermarkerContextBug
WORDSNET-27990DOCX to PDF: Charts description is not rendered correctlyBug
WORDSNET-28088Missed comments for Processor.To(List, SaveOptions)Bug
WORDSNET-28064FileCorruptedException is thrown upon loading DOCX documentBug
WORDSNET-28067Content in SVG is lostBug
WORDSNET-28184InvalidOperationException is thrown when json value contains decimal dotBug
WORDSNET-28030HTML to PDF row height increasedBug
WORDSNET-25990NullReferenceException is thrown upon calling UpdateFieldsBug
WORDSNET-27781Improve loading of style formatting when ‘mso-style-name’ references a built-in styleBug
WORDSNET-25988NullReferenceException is thrown upon updating field in the documentBug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 25.5. 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 ability to set chart style

Related issue: WORDSNET-27647

The ChartStyle enumeration type has been implemented to be able to set chart style:

/// <summary>
/// Specifies predefined styles of a chart.
/// </summary>
public enum ChartStyle
{
    /// <summary>
    /// Represents the default chart style.
    /// </summary>
    Normal,

    /// <summary>
    /// A style with muted colors.
    /// </summary>
    Muted,

    /// <summary>
    /// A style with more saturated colors.
    /// </summary>
    Saturated,

    /// <summary>
    /// A style with shaded data points.
    /// </summary>
    Shaded,

    /// <summary>
    /// A style with flat data points without gradient.
    /// </summary>
    Flat,

    /// <summary>
    /// A style with data points having a shadow.
    /// </summary>
    Shadowed,

    /// <summary>
    /// A style with gradient fill of data points.
    /// </summary>
    Gradient,

    /// <summary>
    /// A style with an original appearance of a chart.
    /// </summary>
    Original,

    /// <summary>
    /// A style with transparent data points.
    /// </summary>
    Transparent1,

    /// <summary>
    /// A style with transparent data points.
    /// </summary>
    Transparent2,

    /// <summary>
    /// A style with data points having no fill, but only an outline.
    /// </summary>
    Outline,

    /// <summary>
    /// A style with black chart background, in which data points have no fill, but only an outline.
    /// </summary>
    OutlineBlack,

    /// <summary>
    /// A style with black chart background.
    /// </summary>
    Black,

    /// <summary>
    /// A style with gray gradient chart background.
    /// </summary>
    Grey,

    /// <summary>
    /// A style with blue chart background.
    /// </summary>
    Blue,

    /// <summary>
    /// A style, in which the plot area is shaded.
    /// </summary>
    ShadedPlot
}

You can specify a chart style when inserting a new chart into a document using the following new methods of the DocumentBuilder class:

public class DocumentBuilder
{
    ...
    /// <summary>
    /// Inserts an chart object into the document and scales it to the specified size.
    /// </summary>
    /// <param name="chartStyle">The style of the inserted chart.</param>
    public Shape InsertChart(ChartType chartType, double width, double height, ChartStyle chartStyle);

    /// <summary>
    /// Inserts an chart object into the document and scales it to the specified size.
    /// </summary>
    /// <param name="chartStyle">The style of the inserted chart.</param>
    public Shape InsertChart(
        ChartType chartType,
        RelativeHorizontalPosition horzPos,
        double left,
        RelativeVerticalPosition vertPos,
        double top,
        double width,
        double height,
        WrapType wrapType,
        ChartStyle chartStyle);
}

The new property has been added to the Chart class to be able to set style of an existing chart:

public class Chart
{
    ...
    /// <summary>
    /// Gets or sets the style of the chart.
    /// </summary>
    public ChartStyle Style { get; set; }
}

This use case explains how to set a specific chart style:

Added possibility to control how empty paragraphs are exported into Markdown

Related issue: WORDSNET-28043

Implemented new public option in Aspose.Words.Saving.MarkdownSaveOptions class:

/// <summary>
/// Specifies how to export empty paragraphs to Markdown.
/// Default value is <see cref="MarkdownEmptyParagraphExportMode.EmptyLine"/>.
/// </summary>
public MarkdownEmptyParagraphExportMode EmptyParagraphExportMode { get; set; }

And added new enumeration into Aspose.Words.Saving namespace:

/// <summary>
/// Specifies how Aspose.Words exports empty paragraphs to Markdown.
/// </summary>
public enum MarkdownEmptyParagraphExportMode

This use case explains how to remove empty paragraphs from the Markdown output: