Aspose.Words for .NET 18.3 Release Notes

Major Features

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

  • LINQ Reporting Engine supports dynamic coloring of chart series and individual series points
  • Add support of CssClassNamesPrefix in HtmlSaveOptions
  • A number of obsolete properties were removed from PdfSaveOptions class. Please refer to public API changes section for details
  • PdfSaveOptions.EscapeUri property was added to allow the usage of custom URI strings without the automatic escape while rendering into PDF
  • The automatic font color calculation now takes the fill of the background shape into account while rendering
  • Added fallback rendering for Unicode range [U+1F300; U+1F5FF] - Miscellaneous Symbols and Pictographs; This range includes such symbols as Emoji and alike
  • Implemented processing of empty EMR_EXTTEXTOUTW records in metafiles rendering
  • Improved rendering of DML Chart plot area with a manual layout. The additional offset is calculated for the rotated labels of horizontal axis
  • Fixed a bug where the gradient brush with transformation would mess up the texture upon rendering. Texture scaling improved
  • Fixed a problem of axis scaling when rendering DML Charts with Arial Narrow font
  • Fixed a bug causing freezes when converting to PDF a document with DML Charts with a huge number of data points
  • Fixed a symbol positioning bug when rendering MathML equations
  • A reflection effect is now applied correctly for 3D rotated WordArt objects

Full List of Issues Covering all Changes in this Release

KeySummaryCategory
WORDSNET-16476Image is not rendered correctly in output PDFBug
WORDSNET-16474MS Word error message when opening ODTBug
WORDSNET-16458Reading bookmarks from a Table.Range object deleted the bookmarksBug
WORDSNET-16432Numbered list in rich text format not saving properlyBug
WORDSNET-16427Incorrect rendering of OfficeMath equations in PDFBug
WORDSNET-16424Word to pdf conversion looses font colorBug
WORDSNET-16420Wrong OfficeMath to Image ConversionBug
WORDSNET-16417Unable to set Run Text after StartTrackRevisions method callBug
WORDSNET-16416Document.Save hangs while saving DOCX to HTMLBug
WORDSNET-16403Emoji symbols are rendered as quotation marks in output PNGBug
WORDSNET-16400Range.Replace does not replace all text in documentBug
WORDSNET-16385The rule Allow Hanging Punctuation should be ignoredBug
WORDSNET-16382Multi-threading is broken, silently messes up line spacingBug
WORDSNET-16374Table row is rendered on previous page in output PDFBug
WORDSNET-16372Incorrect field values when saving documentBug
WORDSNET-16359Background image opacity is not changed for a shape in docx fileBug
WORDSNET-16348DOCX to HTML5 conversion issue with list labelsBug
WORDSNET-16347Heading styling misaligned in Table of contentsBug
WORDSNET-16341Chart is not rendered correctly in output PDF/ImageBug
WORDSNET-16323RTF to PDF conversion issue with Hebrew text renderingBug
WORDSNET-16304Contents are lost after conversion from DOCX to PDFBug
WORDSNET-16301SVG is inserted as black image in output DOCXBug
WORDSNET-16294DOCX to PDF issue with Image Highlights ShadingsBug
WORDSNET-16286Location and size of picture changes after re-saving DOCBug
WORDSNET-16276TOC text style is changed to hyperlink style when saving to PDFBug
WORDSNET-16275Some generated ODT golds cannot be opened in MS WordBug
WORDSNET-16239Image dimensions when inserted inside GroupShape are blown in DOCXBug
WORDSNET-15519Table’s row is rendered on previous page in PDFBug
WORDSNET-15473attachment is missing in MHtml conversionBug
WORDSNET-15422Range of Y-Axis of chart is changed in output PNGBug
WORDSNET-15420Position of chart’s legend is changed in output PNGBug
WORDSNET-15419Range of X-Axis of chart is changed in output PNGBug
WORDSNET-15229Position of chart’s legend is changed in output PNGBug
WORDSNET-14862Provide code to embed AutoCAD file in Word the way MS Word doesBug
WORDSNET-14725Range.Replace does not replace the text when it is inside content controlBug
WORDSNET-14691Range.Replace does not replace the text when it is inside textboxBug
WORDSNET-11284Row heights are not preserved in generated PDFBug
WORDSNET-10016Font formatting is not preserved during open/save RTFBug
WORDSNET-9972Image (GIF) 90 Degrees in Word Document is not displaying in 90 Degrees on PDF ConvertionBug
WORDSNET-8824A floating table does not render in fixed page formatsBug
WORDSNET-8322JPG images are getting lost during renderingBug
WORDSNET-7266TextBox Shape is positioned incorrectly in PDFBug
WORDSNET-16156The width of space is increased after re-saving RTFEnhancement
WORDSNET-16473Aspose.Words.FileCorruptedException occurs when loading a DOCMException
WORDSNET-16455An exception is thrown while rendering the document with gradient shape.Exception
WORDSNET-16442MailMerge.GetRegionsHierarchy() fails when encountering a FieldMergeBarcode fieldException
WORDSNET-16441System.ArgumentException occurs during converting DOC to PDFException
WORDSNET-16407System.ArgumentOutOfRangeException occurs when saving DOCX to HTMLException
WORDSNET-16398Exception when saving to PDF/AException
WORDSNET-16397Document.Save throws System.InvalidOperationException after moving the cursor to the document’s endException
WORDSNET-16351An exception raises while saving to HTML outputException
WORDSNET-16339After Mail Merge Document.Save throws System.ArgumentOutOfRangeException in evaluation modeException
WORDSNET-16150System.ArgumentException occurs when saving DOCX to HTMLException
WORDSNET-11057System.NullReferenceException is thrown while converting Doc to XPSException
WORDSNET-8566Aspose.Words.FileCorruptedException is thrown while loading password protected docxException
WORDSNET-16352Add feature to load Custom XML Parts into RTF and remove themFeature
WORDSNET-16335Add support of CssClassNamesPrefix in HtmlSaveOptionsFeature
WORDSNET-16121Encoded Hyperlink issue during Word to PDF conversion by Aspose.WordsFeature
WORDSNET-15007Add feature to set the color of chart’s series using Linq ReportingFeature
WORDSNET-9373Fonts folder is not included in DOCX when converting from a DOCFeature
WORDSNET-6581The continue numbering do not work when insert one document to another.Feature
WORDSNET-16426Performance issue while converting 20 documents in one batchPerformance
WORDSNET-13748PageCount times out for a HTMLPerformance
WORDSNET-11487Html to Pdf conversion takes much timePerformance
WORDSNET-16428Unable to save MHT document as HTMLRegression
WORDSNET-16399Empty table rows collapse after HTML round-tripRegression
WORDSNET-15886Aspose.Words for .NET 17.9 generated DOC appending issue in MS WordRegression

Public API and Backward Incompatible Changes

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

Supported Dynamic Coloring of Chart Series and Individual Series Points for LINQ Reporting Engine

Related issue: WORDSNET-15007

The “Using Charts to Represent Sequential Data” section and its subsections in the engine’s documentation were updated to describe the change.

PdfSaveOptions.EscapeUri Property Added

Related issue: WORDSNET-16121

The following property has been added to the PdfSaveOptions class:

/// <summary>
/// A flag specifying whether URI should be escaped before writing.
/// </summary>
/// <remarks>
/// Note that if this option is set to <c>false</c> hyperlinks are written "as is",
/// so valid (escaped) URI should be provided in document's model.
/// <para>The default value is <c>true</c>.</para>
/// </remarks>
public bool EscapeUri
{get;set;}

Set this property to false if you are sure that hyperlinks in document’s model are already escaped:

Document doc = new Document ("in.docx");
PdfSaveOptions options = new PdfSaveOptions ();
options.EscapeUri = false;
doc.Save("out.pdf", options);

Added Support of CssClassNamesPrefix in HtmlSaveOptions

Related issue: WORDSNET-16335

The following property has been added to the HtmlSaveOptions class:

API

/// <summary>
/// Specifies a prefix which is added to all CSS class names.
/// Default value is an empty string and generated CSS class names have no common prefix.
/// </summary>
/// <remarks>
/// <para>If this value is not empty, all CSS classes generated by Aspose.Words will start with the specified prefix.
/// This might be useful, for example, if you add custom CSS to generated documents and want to prevent class
/// name conflicts.</para>
/// <para>If the value is not <c>null</c> or empty, it must be a valid CSS identifier.</para>
/// </remarks>
/// <exception cref="ArgumentException">The value is not empty and is not a valid CSS identifier.</exception>
public string CssClassNamePrefix
{
    get { return mCssClassNamesPrefix; }
    set
    {
        if (StringUtil.HasChars(value) && !CssEscape.IsValidIdentifier(value))
            throw new ArgumentException("The class name prefix must be a valid CSS identifier.");
        mCssClassNamesPrefix = value;
    }
}

UC

HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.CssClassNamePrefix = "pfx_";
doc.Save(fileName, saveOptions);

Obsolete method FormFieldCollection.Remove was removed

Obsolete method FormFieldCollection.Remove was removed. Please use the FormField.RemoveField method instead.

Obsolete properties were removed from MailMerge class

Obsolete property MailMerge.RemoveEmptyParagraphs was removed. Please use the MailMerge.CleanupOptions property instead.

Obsolete property MailMerge.RemoveEmptyRegions was removed. Please use the MailMerge.CleanupOptions property instead.

Obsolete property MailMerge.RtlCleanupMode was removed.

Obsolete properties were removed from PdfSaveOptions

Following obsolete properties were removed from the PdfSaveOptions class:

Removed propertyProperty to use instead
PdfSaveOptions.HeadingsOutlineLevelsPdfSaveOptions.OutlineOptions.HeadingsOutlineLevels
PdfSaveOptions.ExpandedOutlineLevelsPdfSaveOptions.OutlineOptions.ExpandedOutlineLevels
PdfSaveOptions.BookmarksOutlineLevelPdfSaveOptions.OutlineOptions.DefaultBookmarksOutlineLevel
PdfSaveOptions.EmbedStandardWindowsFontsPdfSaveOptions.FontEmbeddingMode
PdfSaveOptions.ExportCustomPropertiesAsMetadataPdfSaveOptions.CustomPropertiesExport
PdfSaveOptions.MetafileRenderingModePdfSaveOptions.MetafileRenderingOptions.RenderingMode
PdfSaveOptions.DownsampleImagesPdfSaveOptions.DownsampleOptions.DownsampleImages
PdfSaveOptions.DownsampleResolutionPdfSaveOptions.DownsampleOptions.Resolution
Also removed obsolete PdfDigitalSignatureDetails constructor and PdfDigitalSignatureDetails.Certificate property which works System.Security.Cryptography.X509Certificates.X509Certificate2. CertificateHolder should be used instead.

Obsolete value GeneralFormat.Auieo was removed

Obsolete value GeneralFormat.Auieo was removed. Please use the GeneralFormat.Aiueo value instead.