Aspose.Words 17.12.0

Aspose.Words for .NET is a class library for .NET that enables you to perform a wide range of document processing tasks directly within your .NET applications.

There is a newer version of this package available.
See the version list below for details.
Install-Package Aspose.Words -Version 17.12.0
dotnet add package Aspose.Words --version 17.12.0
<PackageReference Include="Aspose.Words" Version="17.12.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Aspose.Words --version 17.12.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Aspose.Words, 17.12.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Aspose.Words as a Cake Addin
#addin nuget:?package=Aspose.Words&version=17.12.0

// Install Aspose.Words as a Cake Tool
#tool nuget:?package=Aspose.Words&version=17.12.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

Aspose.Words for .NET 17.12 Release Notes

Major News


Starting from 17.12 release Xamarin.Android, Xamarin.iOS and Xamarin.Mac become part of Aspose.Words for .NET. Few breaking changes have been made:

• External reference to SkiaSharp has been added (in previous versions SkiaSharp was merged into Aspose.Words for Xamarin dlls)
• Native graphics objects (Android.Graphics.Bitmap and Android.Graphics.Canvas in Xamarin.Android version and CoreGraphics.CGImage and CoreGraphics.CGContext in Xamarin.iOS and Xamarin.Mac) has been replaced in public API with SkiaSharp.SKBitmap and SkiaSharp.SKCanvas accordingly. This allowed us to fully unify public API of all Aspose.Words for Xamarin versions. Code written for one platform can be reused on another without any changes.

.NET Standard 2.0

Starting from 17.12 release Aspose.Words for .NET includes .NET Standard 2.0 version. It has full functionality of regular .NET version of Aspose.Words with few limitations and public API difference:

• Saving to BMP is not yet supported.
• Signing of PDF document is not yet supported.
• Printing feature is not provided in .NET Standard
• Saving to user browser is not provided, i.e. • Document.Save(HttpResponse,string,ContentDescription,SaveOptions) overload is not available.
• Public API differences are the same as in Xamarin versions, i.e. SkiaSharp.SKBitmap and SkiaSharp.SKCanvas are used as native graphics objects insted of System.Drawing.Bitmap and System.Drawing.Graphics.

Major Features

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

• Implemented Aspose.Words for .NET Standard 2.0.
• Implemented API to set chart axis properties.
• Added feature to get the docPartGallery value of StructuredDocumentTag of type SdtType.DocPartObj.
• Horizontal and vertical flipping attributes are now taken into account when rendering DML textboxes.
• Improved rendering of diacritics for "Courier New" font.
• Multiline MathML expressions rendering fixed.
• EMR_ROUNDRECT records processing while rendering metafiles fixed.
• PDF Rendering of indexed images while converting to CMYK color space fixed.
• Fixed bug causing freezes when converting document with DML Charts to PDF in debug x86 mode.
• OTF(CFF) fonts to PDF/A documents export fixed.
• DML Charts with empty area do not throw exception on rendering now.
• Fixed scaling problem with DML bubble charts on rendering.
• LINQ Reporting Engine supports dynamic setting of chart axes’ titles.
• Improved handling of decimal tab alignment in cells when paragraph has hanging indent.
• Improved text wrapping when line contains single or no characters.
• Improved handling of cell margins and table alignment.
• Improved cell alignment when line has trailing spaces and custom tabs.
• Improved handling of collapsed paragraphs.
• Fixed exception in rare case when line break point cannot be found.
• Fixed exception when document is saved with revision balloons inside of a cell.
Full List of Issues Covering all Changes in this Release

Key Summary Category
WORDSNET-10287 Check on summer 2015 // Doc to tiff conversion issue with text rendering issue Bug
WORDSNET-10496 Merged cells are lost after when UpdateTableLayout method is called Bug
WORDSNET-10648 /rounding/ Blank page is created after conversion from Docx to Pdf Bug
WORDSNET-10673 TestCmykImageDefectJ21 is rendered to PDF incorrectly when ShowAllFormattingMarks are set to true Bug
WORDSNET-12173 /text wrap/ Text moves after converting Word to PDF Bug
WORDSNET-14035 /delete revisions balloons/ Failed to render revisions balloons when the last table row is deleted Bug
WORDSNET-14194 Aspose Word hang when processing HTML Bug
WORDSNET-14811 RTF to PDF, Issues with margins/indents Bug
WORDSNET-15113 Image Rendering Issue Bug
WORDSNET-15382 Document.UpdateFields does not stop (endless loop) Bug
WORDSNET-15578 Chart get blurry when convert word to html Bug
WORDSNET-15610 Borders specified for "colgroup" element are not applied to cell Bug
WORDSNET-15796 RTF: Background image is lost for textboxes inlined with text Bug
WORDSNET-15895 /Courier New + diacritics with non-zero advance/ Russian text accent rendering issue in resultant PDF Bug
WORDSNET-15896 /Courier New + diacritics with non-zero advance/ Herbew text accent rendering issue in resultant PDF Bug
WORDSNET-15909 Page number shifted to right in DOCX to PDF conversion Bug
WORDSNET-15954 XmlMapping.SetMapping throws System.InvalidOperationException Bug
WORDSNET-15979 DOCX to DOCX conversion issue with font of pie chart title Bug
WORDSNET-15986 Footnote formatting is changed after joining RTF documents Bug
WORDSNET-15994 /revisions/ List rendering issue in PDF document Bug
WORDSNET-16025 DOCX to PDF rendering truncate the footer shape Bug
WORDSNET-16026 Tables are not properly aligned in pdf output Bug
WORDSNET-16028 Empty Area Chart. Exception is thrown when converting to PDF . Bug
WORDSNET-16030 Cell's top border is lost after using Borders.Top Bug
WORDSNET-16043 ImageSaveOptions.PageIndex is ignored when IPageSavingCallback is implements Bug
WORDSNET-16046 System.ArgumentNullException when converting specific file Bug
WORDSNET-16053 Symbol Field Color in Footer is lost in PDF conversion Bug
WORDSNET-16061 Save as PDF Compliance PDF/A incorrectly includes OpenType Font Bug
WORDSNET-16067 Incorrect inserting ole object as "htmlfile" Bug
WORDSNET-16075 An exception raises when loading HTML document. Bug
WORDSNET-16079 Position of cell's text is changed in output PDF Bug
WORDSNET-16081 Text is rendered on next page in output PDF Bug
WORDSNET-16082 Extra empty space is rendered in table's cell Bug
WORDSNET-16085 Word shows "Unknown" filename in Rename Package dialog. Bug
WORDSNET-16090 Document.Save hangs while saving DOCX to PDF Bug
WORDSNET-16095 RTF is corrupted after re-saving it Bug
WORDSNET-16096 PNG image is not rendered in output PDF when PdfImageColorSpaceExportMode.SimpleCmyk is used Bug
WORDSNET-16097 DOCX to PDF conversion issue with image rendering Bug
WORDSNET-16118 Adding additional margin to the table cell when producing PDF output. Bug
WORDSNET-16128 Math equation displaced in rendered PDF document Bug
WORDSNET-16147 DOCX is corrupted after re-saving it Bug
WORDSNET-6091 The line numbers have the incorrect size while saving in PDF format. Bug
WORDSNET-6975 Doc to PDF conversion issue with Shape's contents Bug
WORDSNET-9681 Paragraphs render on the previous page in Pdf Bug
WORDSNET-9682 Text direction in SmartArt layout box for arrows is not preserved in Pdf Bug
WORDSNET-10031 Extra empty space appear after conversion from Docx to Pdf Enhancement
WORDSNET-10348 Document.UpdateFields does not update the AUTOTEXT Enhancement
WORDSNET-12932 Content shifts down to the pages in PDF Enhancement
WORDSNET-13334 Empty page is created after section break in output Pdf Enhancement
WORDSNET-14485 Identify elements close to page boarder. Enhancement
WORDSNET-15148 Transparent images are lost in output Pdf Enhancement
WORDSNET-15384 Text is shifted down to the page in output PDF Enhancement
WORDSNET-15479 Wrong empty formula appears in document after accepting revisions Enhancement
WORDSNET-15491 Shape's position is changed in output PDF Enhancement
WORDSNET-15599 DOCX to PDF, table on page moved down Enhancement
WORDSNET-15690 Contents are pushed down to the page in output PDF Enhancement
WORDSNET-15691 Table's position is changed after conversion from Docx to Pdf Enhancement
WORDSNET-15818 Simplified font is used instead of Traditional in Chinese (Taiwan) document Enhancement
WORDSNET-16066 Rtf's text font is changed Enhancement
WORDSNET-16080 Position of numbers in cell is changed after conversion from DOCX to PDF Enhancement
WORDSNET-16088 Expose switches in MailMerge Field Enhancement
WORDSNET-16149 Add exception when TableEnd field is missing Enhancement
WORDSNET-16164 Add support for svgBlip drawing extension. Enhancement
WORDSNET-15785 /delete revisions balloons/ Exception occurs on saving document with showing revision balloons if it has revision in table Exception
WORDSNET-15870 Document.Save throws System.NullReferenceException while re-saving RTF Exception
WORDSNET-15923 DocumentBuilder.InsertChart throws System.NullReferenceException Exception
WORDSNET-15968 System.NullReferenceException is thrown while saving DOCX to PDF Exception
WORDSNET-16045 Infinite loop detected error during DOCX to TIFF image rendering Exception
WORDSNET-16071 Aspose.Words.FileCorruptedException is thrown while loading DOC Exception
WORDSNET-16084 An exception raises while comparing documents. Exception
WORDSNET-16124 API throws FileCorruptedException upon loading RTF file Exception
WORDSNET-16134 System.NullReferenceException is thrown while saving DOCX to PDF Exception
WORDSNET-16157 System.NullReferenceException occurs when exporting RTF to PDF Exception
WORDSNET-13512 Add feature to Format X/Y/Z Axis of chart. Feature
WORDSNET-14022 Add feature to format axis numbers of chart Feature
WORDSNET-14247 Add feature to format axis (minimum and maximum bounds) Feature
WORDSNET-15164 Add feature to set Axis Title of Chart using LINQ Reporting Feature
WORDSNET-15520 Adding the chart axis label formatting. Feature
WORDSNET-15791 Add feature to set/get "Specify interval unit" of axis label Feature
WORDSNET-15925 Add feature to Format Axis Number Feature
WORDSNET-15972 Add feature to get the docPartGallery value of StructuredDocumentTag of type SdtType.DocPartObj Feature
WORDSNET-13612 Implement Aspose.Words for .NET Core Feature
WORDSNETSTD-1 Add feature to support Aspose.Words for .NET Core 2.0 Feature
WORDSNET-16127 Different behavior of Section New Page Break in 16.7 and 17.11 Regression

NuGet packages (20)

Showing the top 5 NuGet packages that depend on Aspose.Words:

Package Downloads
The Enterprise Web Library (EWL), and its tailored infrastructure platform, are a complete and open solution for developing and operating web-based enterprise software.
iCom integrates a variety of specific operation classes, such as: Cookie, Items, Cache, Form, DbContext, DbDynamic, DbConn, SqlQuery, FileUtil, FileUpload, Crypto, BarCode, StringUtil, TypeConvert, SortList, DateUtil, RegexUtil, Environal, ReflectUtil, HttpClient, ImageUtil, XmlUtil, ZipPackage, WordUtil, ExcelUtil, PdfUtil, PinyinConvert, PdfToImageConverter, JsonConfig, XmlConfig, ObjectCopy, TagHelper, SkipUrlMiddleware and so on. // HttpContext Called in the ConfigureServices method services.AddContextAccessor(); // Called in the Configure method app.UseHttpContext(); // EfCore Called in the ConfigureServices method // Application Assembly var assembly = Assembly.GetExecutingAssembly(); // Register Database Models services.AddDbContext(assembly); // Auto Update Database services.AddMigrate(); // Register All Services services.AddService(assembly);
A supportive package for Aspose.Words
Aspose.Words.Shaping.HarfBuzz is a .NET wrapper around HarfBuzz shaping engine for use in Aspose.Words. Free support for Aspose.Words for .NET is provided on our support forum: and on StackOverflow:
Aspose.Total for .NET is the most complete package of all .NET file format APIs offered by Aspose. It empowers developers to create, edit, render, print and convert between a wide range of popular document formats within any .NET, C#, ASP.NET and VB.NET applications.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Aspose.Words:

Repository Stars
Aspose.Words for .NET examples, plugins and showcases

Version History

Version Downloads Last updated
21.5.0 4,586 5/4/2021
21.4.0 17,272 4/1/2021
21.3.0 17,708 3/5/2021
21.2.0 31,647 2/3/2021
21.1.0 50,912 12/29/2020
20.12.0 55,182 12/4/2020
20.11.0 32,242 11/9/2020
20.10.0 44,789 10/6/2020
20.9.0 85,813 9/3/2020
20.8.0 71,519 8/4/2020
20.7.0 65,737 7/3/2020
20.6.0 92,323 6/3/2020
20.5.0 50,091 5/4/2020
20.4.0 72,361 4/3/2020
20.3.0 79,652 3/3/2020
20.2.0 68,818 2/4/2020
20.1.0 180,443 12/30/2019
19.12.0 61,126 12/5/2019
19.11.0 127,924 11/5/2019
19.10.0 72,400 10/4/2019
19.9.0 95,038 9/4/2019
19.8.0 69,715 8/9/2019
19.7.0 86,339 7/3/2019
19.6.0 61,261 6/3/2019
19.5.0 76,259 5/7/2019
19.4.0 108,926 4/2/2019
19.3.0 59,435 3/4/2019
19.2.0 128,031 2/1/2019
19.1.0 72,985 12/26/2018
18.12.0 34,000 12/4/2018
18.11.0 84,257 11/2/2018
18.10.0 70,727 10/3/2018
18.9.0 56,211 9/3/2018
18.8.0 47,499 8/1/2018
18.7.0 54,515 7/4/2018
18.6.0 92,067 6/1/2018
18.5.0 40,165 5/2/2018
18.4.0 38,849 4/2/2018
18.3.0 26,064 3/2/2018
18.2.0 32,066 2/1/2018
18.1.0 54,928 12/26/2017
17.12.0 41,993 12/6/2017
17.11.0 20,299 11/15/2017
17.10.0 41,982 10/9/2017
17.9.0 24,937 9/5/2017
17.8.0 94,791 8/6/2017
17.7.0 33,426 7/6/2017
17.6.0 32,813 6/6/2017
17.5.0 17,411 5/15/2017
17.4.0 39,615 4/4/2017
17.3.0 48,869 3/6/2017
17.2.0 45,213 2/6/2017
17.1.0 16,241 1/16/2017
16.12.0 29,632 12/11/2016
16.11.0 49,247 11/3/2016
16.10.0 34,633 10/12/2016
16.8.0 34,868 9/10/2016
16.7.0 36,552 8/9/2016
16.6.0 15,129 7/13/2016
16.5.0 20,682 6/23/2016
16.4.0 68,758 5/12/2016
16.3.0 15,106 4/11/2016
16.2.0 19,054 3/16/2016
16.1.0 69,016 2/3/2016
15.12.0 29,071 12/26/2015
15.11.0 19,025 12/5/2015
15.10.0 24,752 11/5/2015
15.9.0 21,330 10/12/2015
15.8.1 27,608 9/5/2015
15.7.0 116,769 8/7/2015
15.6.0 37,440 7/4/2015
15.5.0 9,562 6/7/2015
15.4.0 29,270 5/10/2015
15.3.0 10,753 4/2/2015
15.2.0 31,838 3/6/2015
15.1.0 15,948 2/8/2015
14.12.0 18,457 1/10/2015
14.11.0 6,474 12/8/2014
14.10.0 18,547 11/8/2014
14.9.0 7,903 10/17/2014
14.8.0 12,241 9/10/2014
14.7.0 11,628 8/7/2014
14.6.0 8,744 7/7/2014
14.5.0 28,950 6/3/2014
14.4.0 5,991 5/4/2014
14.3.0 5,852 4/7/2014
14.2.0 9,269 3/14/2014
14.1.0 37,410 2/10/2014
13.12.0 29,191 1/12/2014
13.11.0 28,806 12/10/2013
13.10.0 2,701 11/12/2013
13.9.0 30,672 10/9/2013
13.8.0 5,815 9/4/2013
13.7.0 19,295 8/4/2013
13.6.0 30,990 7/3/2013
13.5.0 6,358 6/4/2013
13.4.0 18,838 5/7/2013
13.3.0 10,994 4/3/2013
13.2.0 3,619 3/4/2013
13.1.0 12,413 2/3/2013
11.11.0 15,198 12/31/2012
11.10.0 13,359 12/4/2012
11.9.0 20,821 11/3/2012
11.8.0 11,495 10/7/2012
11.7.0 4,893 9/3/2012
11.6.0 5,387 8/2/2012
11.5.0 1,736 7/3/2012
11.4.0 8,303 6/4/2012
11.3.0 2,656 5/2/2012
11.2.0 1,542 4/10/2012
11.1.0 2,912 3/3/2012 1,426 2/16/2012
11.0.0 2,119 2/1/2012
10.8.0 8,251 1/24/2012
Show less