Aspose.Words 22.9.0

Reduce PDF Size by Caching Shapes .NET API

Product Page | Docs | Demos | API Reference | Examples | Blog | Search | Free Support | Temporary License

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.

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 to create 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.

What's new in v22.9.0

Cache Header / Footer Shapes to Reduce PDF Size

This API release has the ability to cache the header and footer shapes and reduce the output PDF file size.

Create Group Structured Document Tags at Row Level

With this API version now you have the option to create the structured document tags (SDT) as a child of a Table node among table rows.

The following C# code is a sample of creating group structured document tags at row level via API:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a table.
Table table = builder.StartTable();

// Create a Group structured document tag at the Row level.
StructuredDocumentTag groupSdt = new StructuredDocumentTag(doc, SdtType.Group, MarkupLevel.Row);
table.AppendChild(groupSdt);
groupSdt.IsShowingPlaceholderText = false;
groupSdt.RemoveAllChildren();

// Create a child row of the structured document tag.
Row row = new Row(doc);
groupSdt.AppendChild(row);

// Append a cell.
Cell cell = new Cell(doc);
row.AppendChild(cell);

builder.EndTable();

// Insert cell contents.
cell.EnsureMinimum();
builder.MoveTo(cell.LastParagraph);
builder.Write("Some text 1");

// Insert text after the table.
builder.MoveTo(table.NextSibling);
builder.Write("Some text 2");

doc.Save(dir + "Out.docx");

Auto Numbering Detection on TXT Load

The TxtLoadOptions class has been extended by an AutoNumberingDetection public property. This allows you to set the autonumbering detection mode upon loading of the TXT document.

The following C# code demonstrates disabling automatic numbering detection on TXT loading:

// Disable automatic numbering detection.
TxtLoadOptions options = new TxtLoadOptions { AutoNumberingDetection = false };
Document doc = new Document("input.txt", options);

int listItemsCount = 0;
foreach (Paragraph paragraph in doc.GetChildNodes(NodeType.Paragraph, true))
{
    if (paragraph.IsListItem)
        listItemsCount++;
}

Console.WriteLine(
    "The expected number of list items in document with 'AutoNumberingDetection' option disabled is 0." +
    " And the actual is: {0}.", listItemsCount);

// The code produces the following output:
// The expected number of list items in document with 'AutoNumberingDetection' option disabled is 0. And the actual is: 0.

For a complete list of features, enhancements, and bug fixes in this release please visit, Aspose.Words for .NET 22.9 Release Notes.

Supported Formats

Read and Write Formats

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

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 Page | Docs | Demos | API Reference | Examples | Blog | Search | Free Support | Temporary License