Browse our Products

Aspose.Words for .NET 25.3 Release Notes

Major Features

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

Full List of Issues Covering all Changes in this Release

Expand to view the full list of issues.
KeySummaryCategory
WORDSNET-7016Implement non-inscribed objects supportNew Feature
WORDSNET-27864Add possibility to check Grammar using Anthropic AINew Feature
WORDSNET-27454Consider supporting PDF A3 complianceNew Feature
WORDSNET-27601Add possibility to implement Grammar Checker using AINew Feature
WORDSNET-27828Import paragraph structure as MS Word doesEnhancement
WORDSNET-27778Add support for ‘mso-style-name’ values that match HTML color namesEnhancement
WORDSNET-27746Write ‘w15:restartNumberingAfterBreak=“0”’ on list definitionsEnhancement
WORDSNET-27743DOCX to DOCX: Saving document changes fontBug
WORDSNET-27802RTF to PDF: Extra blank page in the outputBug
WORDSNET-27919FileLoadException is thrown upon loading PDFBug
WORDSNET-27800Merging DOCX after page extraction does not preserve list numberingBug
WORDSNET-27837Import formatting of the “HTML Variable” style from “var” selectors in MsoHtmlBug
WORDSNET-27759Extra empty TOC item appears after updating fieldsBug
WORDSNET-27836Hyperlink styles are imported incorrectly from MsoHtmlBug
WORDSNET-27614Treemap chart is converted to image after calling UpdatePageLayoutBug
WORDSNET-27810Could not create the bitmap with the specified parameters exception is thrown upon renderingBug
WORDSNET-24302Wrapping in OfficeMath is incorrect after renderingBug
WORDSNET-27766Font is changed after executing mail mergeBug
WORDSNET-27686NullReferenceException is thrown upon rendering documentBug
WORDSNET-26611Image is lost after rendering documentBug
WORDSNET-27808Issues after updating to new SkiaSharp 3.x.xBug
WORDSNET-27807Exception after updating to new version of SkiaSharp 3.x.xBug
WORDSNET-27866PDF revision comments are displayed in English in windows Chinese localeBug
WORDSNET-27940Update font fallback table for Thai languageBug
WORDSNET-27869Headings are not recognized upon PDF to DOCX conversionBug
WORDSNET-27719Cropped images are improperly converted from PDFBug
WORDSNET-27911RTL text alignment is incorrect after converting to HTMLBug
WORDSNET-27876ArgumentException is thrown upon calling UpdateActualReferenceMarksBug
WORDSNET-27885Table layout is changed after open/save DOCXBug
WORDSNET-27523Comment is added when PdfSaveOptions.EmbedAttachments is enabledBug
WORDSNET-20442Text offset when Word to PDF convertingBug
WORDSNET-27910Bookmark is lost after comparing documentsBug
WORDSNET-27287Shape position is incorrect after rendering.Bug
WORDSNET-27862Incorrect rotation center and origin calculation for 3D extrusion effectBug
WORDSNET-27886There are no code comments for AW and Wordize in Net6 and higher.Bug
WORDSNET-27901Metafile is rendered improperly in .NET Standard.Bug
WORDSNET-27888InvalidOperationException is thrown upon converting DOCX to DOCBug
WORDSNET-27403Curved connectors position is slightly incorrect after rendering.Bug
WORDSNET-27877Incorrect DML group elements layoutBug
WORDSNET-27816NullReferenceException is thrown upon removing nodes from SDTBug
WORDSNET-27839Clipping the points of smoothed series with an extremely large valueBug
WORDSNET-27842Numbering is changed after merging documents with Document.MergeDocumentsBug
WORDSNET-22347Text inside oMath element is wrapped incorrectlyBug
WORDSNET-27863Hebrew text is read improperly from HTML.Bug
WORDSNET-27871“Cannot translate from ‘Span’ in ‘Textbox’ to ‘Column’” during conversion to PDFBug
WORDSNET-27860Metafile is not rendered in .NET StandardBug
WORDSNET-27761Metered License Timeout settingsBug
WORDSNET-27830Broken links in HTML test filesBug
WORDSNET-27165Text color changed after open/save RTF fileBug
WORDSNET-27826Exception when saving document with StructuredDocumentTag and CustomXmlPart mappingBug
WORDSNET-27811Styles are imported incorrectly from MsoHtmlBug
WORDSNET-27798Changes in obfuscation settings requiredBug
WORDSNET-27829ArgumentException is thrown upon comparing documentBug
WORDSNET-27840Import formatting from “listing”, “pre”, and “xmp” selectors into the “HTML Preformatted” built-in styleBug
WORDSNET-27672Incorrect table convertion to MDBug
WORDSNET-27715Added space after 8pt to each paragraph after AppendDocumendBug
WORDSNET-27867Font in shape is changed after inserting document with ImportFormatMode.KeepSourceFormattingBug
WORDSNET-27926Letters contains lost or modified diacritic marksBug
WORDSNET-21351LockContents not Working for RichText when inserting HTMLBug
WORDSNET-27819Redactions are not properly applied to PDF produced by Aspose.WordsBug
WORDSNET-27834Table regularity check filed for PDF produced by Aspose.WordsBug
WORDSNET-27883Merger plugin tests failBug
WORDSNET-27892Add support of loading CHM to plugin licensesBug
WORDSNET-27767PDF-to-DOCX: Cropped image layout not preserved during conversionBug
WORDSNET-23585The images in documents are sometimes replaced by the red cross imageBug
WORDSNET-27735Unable to load DOCX file: FormatException: String ‘0’ was not recognized as a valid BooleanBug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 25.3. 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.

Improved export of attachments to PDF

Related requests: WORDSNET-27454, WORDSNET-27523

New PdfSaveOptions.AttachmentsEmbeddingMode property added instead of PdfSaveOptions.EmbedAttachments.

Attachments are supported when exporting to PDF/A (specific versions) and PDF/UA. Added new values to PdfCompliance enum for PDF/A versions which supports attachments. Also attachments are now supported with encryption.

public class PdfSaveOptions {
...
    [Obsolete("Obsolete, please use AttachmentsEmbeddingMode instead.")]         
    public bool EmbedAttachments { get; set; }

    /// <summary>
    /// Gets or sets a value determining how attachments are embedded to the PDF document.
    /// </summary>
    /// <remarks>
    /// <para>Default value is <see cref="PdfAttachmentsEmbeddingMode.None"/> and attachments are not embedded.</para>
    /// <para>
    /// PDF/A-1, PDF/A-2 and regular PDF/A-4 (not PDF/A-4f) standards do not allow embedded files.
    /// <see cref="PdfAttachmentsEmbeddingMode.None"/> value will be used automatically.
    /// </para>
    /// </remarks>
    public PdfAttachmentsEmbeddingMode AttachmentsEmbeddingMode {get; set; }
...
}

/// <summary>
/// Specifies how attachments are embedded to PDF document.
/// </summary>
public enum PdfAttachmentsEmbeddingMode
{
    /// <summary>
    /// Attachments are not embedded.
    /// </summary>
    None,
    /// <summary>
    /// Attachments are embedded as annotations with location on page.
    /// </summary>
    Annotations,
    /// <summary>
    /// Attachments are embedded as the document embedded files without annotations.
    /// </summary>
    DocumentEmbeddedFiles
}

public enum PdfCompliance
{
...
    /// <summary>
    /// The output file will comply with the PDF/A-3a (ISO 19005-3) standard.
    /// This level includes all the requirements of PDF/A-3u and additionally requires
    /// that document structure be included (also known as being "tagged"),
    /// with the objective of ensuring that document content can be searched and repurposed.
    /// </summary>
    /// <remarks>
    /// Note that exporting the document structure significantly increases the memory consumption, especially
    /// for the large documents.
    /// </remarks>
    PdfA3a,
    /// <summary>
    /// The output file will comply with the PDF/A-3u (ISO 19005-3) standard.
    /// PDF/A-3u (as well as PDF/A-2u) has the objective of preserving document static visual appearance over time, independent of the tools
    /// and systems used for creating, storing or rendering the files. Additionally, any text contained in the document
    /// can be reliably extracted as a series of Unicode codepoints. In addition to PDF/A-2u, PDF/A-3u allows embedding
    /// attachments to the PDF document.
    /// </summary>
    PdfA3u,
    /// <summary>
    /// The output file will comply with the PDF/A-4f (ISO 19005-4:2020) standard.
    /// This level includes all the requirements of PDF/A-4 and additionally allows embedding
    /// attachments to the PDF document.
    /// </summary>
    PdfA4f
}

This use case explains how to customize how attachments are embedded in PDFs with PdfSaveOptions:

Added new public option UpdateAmbiguousTextFont

Related issue: WORDSNET-27743

A new public option UpdateAmbiguousTextFont has been added to SaveOptions class:

/// <summary>
/// Determines whether the font attributes will be changed according to the character code being used.
/// </summary>
public bool UpdateAmbiguousTextFont { get; set; }

This use case shows how to control font selection for ambiguous characters in Word documents using UpdateAmbiguousTextFont: