Aspose.Words 23.1.0

.NET 6.0 .NET Standard 2.0 .NET Framework 3.5

There is a newer version of this package available.
See the version list below for details.

dotnet add package Aspose.Words --version 23.1.0

NuGet\Install-Package Aspose.Words -Version 23.1.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Aspose.Words" Version="23.1.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Aspose.Words" Version="23.1.0" />
                    

                            Directory.Packages.props

<PackageReference Include="Aspose.Words" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Aspose.Words --version 23.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Aspose.Words, 23.1.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#addin nuget:?package=Aspose.Words&version=23.1.0
                    

                            Install Aspose.Words as a Cake Addin

#tool nuget:?package=Aspose.Words&version=23.1.0
                    

                            Install Aspose.Words as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Word Document Processing .NET API

Nuget

Aspose.Words for .NET is a class library that can be used by C#, F#, VB.NET developers for a variety of document-processing tasks, including document generation, modification, converting, and rendering. Our library is self-sufficient and doesn't depend on any third-party software, such as Microsoft Word, OpenOffice, and similar office suites.

This package can be used to develop applications for a vast range of operating systems (Windows, Linux, macOS, iOS, Android) and platforms such as Windows Azure, Xamarin.Android, Xamarin.iOS, Xamarin.Mac. You can build both 32-bit and 64-bit software, including ASP.NET, WCF, and WinForms. Also, you can use our library via COM Interop from ASP, PHP, Perl, and Python programming languages.

Please note: our library implies the use of .NET programming languages, compatible with CLI infrastructure. If you require a corresponding native library for C++, you can download it from here. The Python version you can download from here.

Functionality

Provides comprehensive document import and export with 35+ supported file formats. This allows developers to convert documents from one file format to another. For example, you can convert PDF to Word and Word to PDF documents with professional quality.
Provides full access to all Word and OpenOffice document elements, including formatting properties and styling.
Provides high-fidelity rendering of Word documents to PDF, JPG, PNG and other imaging formats.
Provides the ability to print OpenOffice and Word documents programmatically."
Supports powerful Report Generation with Mail Merge functionality, which allows creating documents dynamically using templates and data sources.
Contains a flexible LINQ Reporting Engine, designed to fetch data from databases, XML, JSON, OData, external documents.
Provides a rich set of utility functions, you can use to split a document into parts, join documents together, compare documents, and much more.

To become familiar with the most popular Aspose.Words functionality, please have a look at our free online applications.

Supported Formats

Read and Write Formats

Microsoft Word: DOC, DOT, DOCX, DOTX, DOTM, FlatOpc, FlatOpcMacroEnabled, FlatOpcTemplate, FlatOpcTemplateMacroEnabled, RTF, Microsoft Word 2003 WordprocessingML, XML
OpenDocument: ODT, OTT
Web: HTML, MHTML
Markdown: MD
Fixed Layout: PDF
Text: TXT
eBook: AZW3

Read-Only Formats

Microsoft Word: DocPreWord60
eBook: MOBI, CHM

Write-Only Formats

Fixed Layout: XPS, OpenXps
PostScript: PS
Printer: PCL
eBook: EPUB
Markup: XamlFixed, HtmlFixed, XamlFlow, XamlFlowPack
Image: SVG, TIFF, PNG, BMP, JPEG, GIF
Metafile: EMF

Getting Started

So, you probably want to jump up and start coding your document processing application on C#, F# or Visual Basic right away? Let us show you how to do it in a few easy steps.

Run Install-Package Aspose.Words from the Package Manager Console in Visual Studio to fetch the NuGet package. If you want to upgrade to the latest package version, please run Update-Package Aspose.Words.

You can run the following code snippets in C# to see how our library works. Also feel free to check out the GitHub Repository for other common use cases.

Create a DOCX using C#

Aspose.Words for .NET allows you to create a blank Word document and add content to the file.

// Create a Word document.
Document doc = new Document();

// Use a DocumentBuilder instance to add content to the file.
DocumentBuilder builder = new DocumentBuilder(doc);

// Write a new paragraph to the document.
builder.Writeln("This is an example of a Word document created in C#");

// Save it as a DOCX file. The output format is automatically determined by the filename extension.
doc.Save(dir + "OutputWordDocument.docx");

Create a PDF in C#

Aspose.Words for .NET allows you to create a new PDF file and fill it with data.

// Create a PDF document.
Document pdf = new Document();

// Use a DocumentBuilder instance to add content to the file.
DocumentBuilder builder = new DocumentBuilder(pdf);

// Write a new paragraph to the document.
builder.Writeln("This is an example of a PDF document created using C#");

// Save it as a PDF file.
pdf.Save(dir + "OutputDocument.pdf");

Convert a Word document to HTML with C#

You can convert Microsoft Word to PDF, XPS, Markdown, HTML, JPEG, TIFF, and other file formats. The following snippet demonstrates the conversion from DOCX to HTML:

// Load a Word file from the local drive.
Document doc = new Document(dir + "InputWordDocument.docx");

// Save it to HTML format.
doc.Save(dir + "OutputHtmlDocument.html");

Import a PDF and save as a DOCX via C#

In addition, you can import a PDF file into your .NET application and export it as a DOCX format file without the need to install Microsoft Word:

// Load a PDF file from the local drive.
Document pdf = new Document(dir + "InputDocument.pdf");

// Save it to DOCX format.
pdf.Save(dir + "OutputWordDocument.docx");

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 was computed.
.NET Framework	net35-client is compatible. net40 is compatible. net40-client is compatible. net403 was computed. net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 is compatible. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 3.5 Client
- No dependencies.
.NETFramework 4.0
- No dependencies.
.NETFramework 4.0 Client
- No dependencies.
.NETFramework 4.6.1
- No dependencies.
.NETStandard 2.0
- Microsoft.Win32.Registry (>= 4.7.0)
- SkiaSharp (>= 2.80.1)
- System.Reflection.Emit (>= 4.3.0)
- System.Reflection.Emit.ILGeneration (>= 4.3.0)
- System.Text.Encoding.CodePages (>= 4.5.0)
net6.0
- Microsoft.Win32.Registry (>= 4.7.0)
- SkiaSharp (>= 2.80.1)
- System.Reflection.Emit (>= 4.3.0)
- System.Reflection.Emit.ILGeneration (>= 4.3.0)
- System.Text.Encoding.CodePages (>= 4.5.0)

NuGet packages (60)

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

Package	Downloads
Ewl The Enterprise Web Library (EWL), together with its tailored infrastructure platform, is a highly opinionated foundation for web-based enterprise software.	560.9K
GroupDocs.Classification GroupDocs.Classification for .NET is an easy to use library that allows performing sentiment analysis (classification), document classification, and raw text categorization. Features: * Classifies both raw text and documents with IAB-2, Documents, Sentiment, or Sentiment3 taxonomies. * Sentiment Analysis (Classification) supports Positive/Negative or Positive/Neutral/Negative taxonomies for English, Chinese, German, or Spanish languages. * Returns the probability of each class. Supported document formats: * Microsoft Word documents - DOC, DOT, DOCX, DOCM, DOTX, DOTM, TXT, RTF; * Open Document formats - ODP, ODS, ODT, OTT; * Portable Document Formats - PDF; For more details on the GroupDocs.Classification for .NET API, please visit GroupDocs website at: https://www.groupdocs.com/products/classification/net	466.6K
Aspose.Words.Shaping.HarfBuzz 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: https://forum.aspose.com/ and on StackOverflow: https://stackoverflow.com/questions/tagged/aspose.words	283.6K
Aspose.Total 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.	266.1K
fion.modelerp.core ModelErp	259.7K

GitHub repositories (3)

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

Repository	Stars
aspose-words/Aspose.Words-for-.NET Aspose.Words for .NET examples, plugins and showcases	516
xhnbzdl/feishu-doc-export 飞书文档导出服务	462
aspose-pdf/Aspose.PDF-for-.NET Aspose.PDF for .NET examples, plugins and showcase projects	146

Version	Downloads	Last updated
25.4.0	22,481	4/7/2025
25.3.0	60,855	3/6/2025
25.2.0	124,780	2/5/2025
25.1.0	147,237	1/6/2025
24.12.0	147,983	12/6/2024
24.11.1	145,497	11/14/2024
24.11.0	61,677	11/11/2024
24.10.0	242,228	10/8/2024
24.9.0	183,988	9/9/2024
24.8.0	295,369	8/7/2024
24.7.0	251,792	7/8/2024
24.6.0	252,189	6/6/2024
24.5.0	244,930	5/3/2024
24.4.0	235,460	4/3/2024
24.3.0	216,402	3/5/2024
24.2.0	316,723	2/5/2024
24.1.0	323,596	12/29/2023
23.12.0	344,643	12/4/2023
23.11.0	305,986	11/6/2023
23.10.0	491,245	10/6/2023
23.9.0	352,155	9/5/2023
23.8.0	317,719	8/6/2023
23.7.0	236,327	7/9/2023
23.6.0	339,269	6/6/2023
23.5.0	356,271	5/5/2023
23.4.0	305,218	4/4/2023
23.3.0	724,419	3/6/2023
23.2.0	314,378	2/2/2023
23.1.0	344,771	1/6/2023
22.12.0	538,542	12/1/2022
22.11.0	493,017	11/3/2022
22.10.0	526,038	10/6/2022
22.9.0	435,185	9/5/2022
22.8.0	450,170	8/2/2022
22.7.0	269,130	7/4/2022
22.6.0	302,668	6/3/2022
22.5.0	399,961	5/3/2022
22.4.0	241,056	4/1/2022
22.3.0	482,391	2/28/2022
22.2.0	291,105	2/2/2022
22.1.0	290,363	12/29/2021
21.12.0	292,271	12/8/2021
21.11.0	286,219	11/5/2021
21.10.0	331,293	10/7/2021
21.9.0	306,211	9/2/2021
21.8.0	429,324	8/3/2021
21.7.0	394,887	7/2/2021
21.6.0	327,679	6/3/2021
21.5.0	363,611	5/4/2021
21.4.0	208,072	4/1/2021
21.3.0	320,183	3/5/2021
21.2.0	305,839	2/3/2021
21.1.0	278,371	12/29/2020
20.12.0	415,022	12/4/2020
20.11.0	262,952	11/9/2020
20.10.0	205,937	10/6/2020
20.9.0	300,877	9/3/2020
20.8.0	232,094	8/4/2020
20.7.0	308,272	7/3/2020
20.6.0	366,669	6/3/2020
20.5.0	302,075	5/4/2020
20.4.0	225,779	4/3/2020
20.3.0	278,147	3/3/2020
20.2.0	304,411	2/4/2020
20.1.0	416,602	12/30/2019
19.12.0	219,132	12/5/2019
19.11.0	391,560	11/5/2019
19.10.0	232,545	10/4/2019
19.9.0	412,559	9/4/2019
19.8.0	157,561	8/9/2019
19.7.0	249,356	7/3/2019
19.6.0	193,372	6/3/2019
19.5.0	330,036	5/7/2019
19.4.0	322,126	4/2/2019
19.3.0	142,890	3/4/2019
19.2.0	289,444	2/1/2019
19.1.0	154,072	12/26/2018
18.12.0	315,110	12/4/2018
18.11.0	183,413	11/2/2018
18.10.0	186,158	10/3/2018
18.9.0	186,189	9/3/2018
18.8.0	99,202	8/1/2018
18.7.0	183,898	7/4/2018
18.6.0	294,056	6/1/2018
18.5.0	205,218	5/2/2018
18.4.0	106,931	4/2/2018
18.3.0	82,251	3/2/2018
18.2.0	73,122	2/1/2018
18.1.0	167,862	12/26/2017
17.12.0	149,815	12/6/2017
17.11.0	55,773	11/15/2017
17.10.0	71,564	10/9/2017
17.9.0	47,082	9/5/2017
17.8.0	166,000	8/6/2017
17.7.0	95,927	7/6/2017
17.6.0	48,608	6/6/2017
17.5.0	41,374	5/15/2017
17.4.0	55,299	4/4/2017
17.3.0	78,839	3/6/2017
17.2.0	117,706	2/6/2017
17.1.0	39,101	1/16/2017
16.12.0	79,931	12/11/2016
16.11.0	99,941	11/3/2016
16.10.0	73,462	10/12/2016
16.8.0	105,952	9/10/2016
16.7.0	76,710	8/9/2016
16.6.0	21,122	7/13/2016
16.5.0	45,177	6/23/2016
16.4.0	116,744	5/12/2016
16.3.0	36,776	4/11/2016
16.2.0	44,838	3/16/2016
16.1.0	178,321	2/3/2016
15.12.0	80,640	12/26/2015
15.11.0	27,098	12/5/2015
15.10.0	70,153	11/5/2015
15.9.0	58,733	10/12/2015
15.8.1	67,258	9/5/2015
15.7.0	206,809	8/7/2015
15.6.0	100,966	7/4/2015
15.5.0	29,264	6/7/2015
15.4.0	102,607	5/10/2015
15.3.0	19,518	4/2/2015
15.2.0	68,461	3/6/2015
15.1.0	30,574	2/8/2015
14.12.0	63,693	1/10/2015
14.11.0	48,315	12/8/2014
14.10.0	38,000	11/8/2014
14.9.0	15,833	10/17/2014
14.8.0	37,573	9/10/2014
14.7.0	20,675	8/7/2014
14.6.0	22,123	7/7/2014
14.5.0	81,803	6/3/2014
14.4.0	20,915	5/4/2014
14.3.0	9,150	4/7/2014
14.2.0	27,046	3/14/2014
14.1.0	67,746	2/10/2014
13.12.0	66,224	1/12/2014
13.11.0	35,532	12/10/2013
13.10.0	5,039	11/12/2013
13.9.0	125,321	10/9/2013
13.8.0	29,430	9/4/2013
13.7.0	50,326	8/4/2013
13.6.0	92,529	7/3/2013
13.5.0	11,772	6/4/2013
13.4.0	87,913	5/7/2013
13.3.0	36,721	4/3/2013
13.2.0	17,417	3/4/2013
13.1.0	38,577	2/3/2013
11.11.0	23,138	12/31/2012
11.10.0	47,765	12/4/2012
11.9.0	57,276	11/3/2012
11.8.0	78,443	10/7/2012
11.7.0	15,625	9/3/2012
11.6.0	8,948	8/2/2012
11.5.0	4,940	7/3/2012
11.4.0	25,908	6/4/2012
11.3.0	6,912	5/2/2012
11.2.0	19,069	4/10/2012
11.1.0	5,510	3/3/2012
11.0.0.1	9,136	2/16/2012
11.0.0	5,944	2/1/2012
10.8.0	50,531	1/24/2012

https://docs.aspose.com/words/net/aspose-words-for-net-23-1-release-notes