Aspose.HTML 22.5.0

Improved XPath Query Processing via HTML .NET API

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

This .NET HTML API assists developers to write, read, modify, navigate and convert (X)HTML documents from within .NET applications.

Aspose.HTML for .NET API works as a headless browser that allows you to create or open existing HTML documents from various sources in order to perform manipulation operations such as remove and replace HTML nodes, save HTML documents, extract CSS from HTML, configure a document sandbox and more. You may navigate HTML documents by using various methods, such as, element traversal, document traversal, XPath queries, and CSS selector queries as well as manipulate HTML DOM via JavaScript, convert HTML file to images or fixed-layout formats, and convert (X)HTML and EPUB files to other file formats.

It helps you create, modify, extract, copy, delete and replace HTML document content, extract CSS from HTML, configure a document sandbox; load, read, and manage SVG files; render MHTML and EPUB documents to supported output file formats, and perform asynchronous operations.

This library supports parsing of HTML5, CSS3, SVG and HTML Canvas to construct a Document Object Model (DOM) based on the WHATWG DOM Standard. Insert, remove, and edit the nodes. You can navigate HTML documents by using various methods, such as element traversal, document traversal, XPath queries, and CSS selector queries as well as manipulate HTML DOM via JavaScript.

Aspose.HTML for .NET offers comprehensive format conversion support using which your applications can convert from HTML, SVG, EPUB, MHTML, and Markdown to various supported formats. You can also populate an HTML template from XML or JSON data sources. Aspose.HTML can easily work with large and complex HTML-documents.

The classes and properties of Aspose.HTML for .NET API have similar names as that of W3C HTML specification.

HTML Processing API Features

• Convert HTML to many popular formats including PDF, XPS and images.
• Load & convert SVG & EPUB to XPS, PDF and images.
• Navigate through document either by NodeIterator or TreeWalker.
• Control the timeout of the rendering process.
• MutationObserver to watch over DOM modifications.
• Populate HTML document with external data (XML & JSON).
• Support of single (PDF, XPS) or multiple (image formats) output file streams.
• Extract CSS styling information.
• Configuring Sandbox for the environment independent of the execution machine.

What's new in v22.5.0

XPath Query Processing

Improved the processing of the XPath Query. The following C# code sample demonstrates a Web Scrapping, XPath Query usage via API:

// For complete examples and data files, please go to https://github.com/aspose-html/Aspose.HTML-for-.NET
// Prepare HTML code
var code = @"
    <div class='happy'>
        <div>
            <span>Hello!</span>
        </div>
    </div>
    <p class='happy'>
        <span>World</span>
    </p>
";

// Initialize a document based on the prepared code
using (var document = new Aspose.Html.HTMLDocument(code, "."))
{
    // Here we evaluate the XPath expression where we select all child SPAN elements from elements whose 'class' attribute equals to 'happy':
    var result = document.Evaluate("//*[@class='happy']//span",
        document,
        null,
        Aspose.Html.Dom.XPath.XPathResultType.Any,
        null);

    // Iterate over the resulted nodes
    for (Aspose.Html.Dom.Node node; (node = result.IterateNext()) != null;)
    {
        System.Console.WriteLine(node.TextContent);
        // output: Hello
        // output: World!
    }
}

Improved handling of Combining Diacritical Marks

Improved the handling of Combining Diacritical Marks Unicode block containing the combining characters for symbols.

Improved CSS Style Parsing

The parsing performance of CSS Styles has been improved.

Improved HTML to PDF Conversion

The HTML to PDF document converter process has been optimized. The representation of Arabic Characters when converting HTML to PDF has also been improved. The following C# code sample demonstrates how HTML can be converted into PDF using API, while configuring various PDF related options (such as, PDF page size and PDF page background color):

// For complete examples and data files, please go to https://github.com/aspose-html/Aspose.HTML-for-.NET
// Prepare an HTML code and save it to the file
var code = @"<span>Hello</span> <span>World!!</span>";
System.IO.File.WriteAllText("document.html", code);

// Set A5 as a page-size and change the background color to green
var options = new Aspose.Html.Saving.PdfSaveOptions()
{
    PageSetup =
    {
        AnyPage = new Aspose.Html.Drawing.Page()
        {
            Size = new Aspose.Html.Drawing.Size(Aspose.Html.Drawing.Length.FromInches(8.3f), Aspose.Html.Drawing.Length.FromInches(5.8f))
        }
    },
    BackgroundColor = System.Drawing.Color.Green,
};
// Convert HTML document to PDF
Aspose.Html.Converters.Converter.ConvertHTML("document.html", options, "output.pdf");

Better Support of Showing SVG in PDF

Previously SVG was not showing up in PDF. This issue has been resolved. The following C# API code sample demonstrates SVG to PDF conversion:

using System.IO;
using Aspose.Html.Converters;
using Aspose.Html.Saving;
...
     // Invoke the ConvertSVG method for SVG to PDF conversion          
     Converter.ConvertSVG(Path.Combine(DataDir, "shapes.svg"), new PdfSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.pdf"));

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

Read & Write Web Formats

Web: HTML, XHTML, MHTML
Other: SVG, MD (Markdown)

Save HTML As

Fixed Layout: PDF, XPS
Images: TIFF, JPEG, PNG, BMP, GIF

Read Formats

EPUB

Platform Independence

Aspose.HTML for .NET is written completely in C# and can be used to build any type of 32-bit or 64-bit .NET application including ASP.NET, WCF, WinForms & .NET Core. Development platforms include all flavors of Windows, Linux, and Mac OS X x64 (10.12+).

Getting Started

Are you ready to give Aspose.HTML for .NET a try? Simply execute Install-Package Aspose.Html from Package Manager Console in Visual Studio to fetch the NuGet package. If you already have Aspose.HTML for .NET and want to upgrade the version, please execute Update-Package Aspose.Html to get the latest version.

Convert HTML to GIT-based Markdown (MD) Format

// For complete examples and data files, please go to https://github.com/aspose-html/Aspose.HTML-for-.NET

// Prepare an HTML code and save it to the file.
var code = "<h1>Header 1</h1>" +
           "<h2>Header 2</h2>" +
           "<p>Hello World!!</p>";
System.IO.File.WriteAllText("document.html", code);

// Call ConvertHTML method to convert HTML to Markdown.
Aspose.Html.Converters.Converter.ConvertHTML("document.html", Aspose.Html.Saving.MarkdownSaveOptions.Git, "output.md");

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