Convert MHTML to XPS in C#

To convert MHTML to XPS in C#, open the MHTML file as a stream, create XpsSaveOptions, and call Converter.ConvertMHTML() with the stream, options, and output path or stream provider.

MHTML stores a complete web page and its resources in one archive. XPS is a fixed-layout document format useful for Windows-oriented viewing, printing, and internal document workflows when the target pipeline expects XPS output.

Before running the examples, install and configure Aspose.HTML for .NET in your project. The complete C# example project is available in the Aspose.HTML for .NET GitHub repository.

Convert MHTML to XPS with Two Lines of C#

The static Converter class provides the shortest path from an MHTML stream to an XPS file. The example below opens an MHTML file and converts it to XPS with default XpsSaveOptions.

// Convert MHTML to XPS using C#

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Invoke the ConvertMHTML() method to convert the MHTML code to XPS
Converter.ConvertMHTML(stream, new XpsSaveOptions(), Path.Combine(OutputDir, "convert-by-two-lines.xps"));

Convert an MHTML File to XPS in C#

Use this workflow when the MHTML source exists on disk and the XPS should be saved to a file path.

The workflow is:

1. Open the MHTML file with File.OpenRead() or another readable stream.
2. Create an XpsSaveOptions instance.
3. Call Converter.ConvertMHTML(stream, options, savePath).
4. Save the generated XPS file to the target output path.

// Convert MHTML to XPS in C#

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Prepare a path for converted file saving 
string savePath = Path.Combine(OutputDir, "sample-output.xps");

// Create an instance of XpsSaveOptions
XpsSaveOptions options = new XpsSaveOptions();

// Call the ConvertMHTML() method to convert MHTML to XPS
Converter.ConvertMHTML(stream, options, savePath);

Customize MHTML to XPS with XpsSaveOptions

Use XpsSaveOptions when the generated XPS file needs custom rendering settings.

To customize MHTML to XPS conversion:

1. Open the MHTML source stream.
2. Create XpsSaveOptions.
3. Configure only the settings required by the output, such as PageSetup, BackgroundColor, CSS processing, or resolution.
4. Pass the stream, options, and output path to Converter.ConvertMHTML().

Option	Use it to control
PageSetup	Page size, margins, and page layout settings.
Css	CSS processing behavior through CssOptions.
BackgroundColor	The color used to fill the page background. The default value is transparent.
HorizontalResolution and VerticalResolution	Output resolution values used by the rendering process. The default value is 300 dpi for each property.

// Convert MHTML to XPS in C# with custom settings

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Prepare a path for converted file saving 
string savePath = Path.Combine(OutputDir, "sample-options.xps");

// Create an instance of XpsSaveOptions. Set up the page-size and change the background color to AliceBlue 
XpsSaveOptions options = new XpsSaveOptions();
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(Length.FromInches(8.3f), Length.FromInches(5.8f)));
options.BackgroundColor = System.Drawing.Color.AliceBlue;

// Call the ConvertMHTML() method to convert MHTML to XPS
Converter.ConvertMHTML(stream, options, savePath);

When to Use MHTML to XPS Conversion

Use XPS output when a C# application needs a fixed-layout document for Windows-oriented viewing, printing, or internal document pipelines. If the result must be widely shared outside an XPS-aware environment, MHTML to PDF is usually the more practical choice.

Related XPS Workflows

• How to Resize Document During Conversion from HTML?
• Set Font Folder to Render HTML
• Fine-Tuning Converters
• Rendering Options

Save MHTML to XPS with an Output Stream Provider

Use ICreateStreamProvider when the conversion output should be written through streams instead of only to a file path. This is useful for memory-based workflows, remote storage, databases, and services that decide where the rendered output is stored.

// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (MemoryStream stream in Streams)
            stream.Dispose();
    }
}

The following example converts MHTML to XPS with MemoryStreamProvider.

// Convert MHTML to XPS in C# using memory stream

// Create an instance of MemoryStreamProvider
using MemoryStreamProvider streamProvider = new MemoryStreamProvider();

// Open an existing MHTML file for reading
using FileStream stream = File.OpenRead(DataDir + "sample.mht");

// Prepare a path for converted file saving
string savePath = Path.Combine(OutputDir, "stream-provider.xps");

// Convert MHTML to XPS by using the MemoryStreamProvider class
Converter.ConvertMHTML(stream, new XpsSaveOptions(), streamProvider);

// Get access to the memory stream that contains the result data
MemoryStream memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(savePath))
{
    memory.CopyTo(fs);
}

Related MHTML Conversion Guides

• Convert MHTML to PDF – render an MHTML archive as a PDF document.
• Convert MHTML to DOCX – save an MHTML archive as a Word document.
• Convert MHTML to Image – render MHTML as JPG, PNG, BMP, GIF, or TIFF.

Other Platforms

• MHTML Converter in Java
• MHTML Converter in Python via .NET

Try Online MHTML to XPS Conversion

Use the online MHTML to XPS Converter for quick manual conversion. Use Aspose.HTML for .NET when MHTML to XPS conversion must run inside a C# application, service, or document pipeline.