Convert HTML to XPS in C#

To convert HTML to XPS in C#, use Converter.ConvertHTML() with an HTML source, XpsSaveOptions, and an output path or stream provider. Aspose.HTML for .NET can convert HTML from a file, string, stream, or URL, and XpsSaveOptions lets you control XPS rendering settings such as page setup, CSS handling, background color, and resolution.

This guide shows the core HTML to XPS workflows for C# applications: a one-line conversion, a file-based conversion, custom XPS save options, and output stream handling with ICreateStreamProvider. 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.

XPS is a fixed-layout document format used for consistent viewing, printing, and sharing. HTML to XPS conversion is useful when a C# application needs a stable page representation from HTML content while still controlling page size, margins, colors, and stream output.

Convert HTML to XPS with One Line of C#

For simple input, the static Converter class provides a short path from HTML content to an XPS file. The example below passes HTML code, a base URI, default XpsSaveOptions, and the output file path to ConvertHTML().

// Convert HTML to XPS using C#

// Invoke the ConvertHTML() method to convert the HTML code to XPS
Converter.ConvertHTML(@"<h1>Convert HTML to XPS!</h1>", ".", new XpsSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.xps"));

Use this pattern when your HTML is already available as a string and default XPS settings are enough. For file input, custom options, or stream output, use the workflows below.

Convert an HTML File to XPS in C#

A typical file-based conversion uses an HTMLDocument instance, an XpsSaveOptions object, and Converter.ConvertHTML(). You can load HTML from a local file, HTML code, stream, or URL. For more loading patterns, see Creating an HTML Document.

The workflow is:

1. Load the HTML file with an HTMLDocument constructor.
2. Create an XpsSaveOptions instance.
3. Call Converter.ConvertHTML(document, options, savePath) to write the XPS file.

The following C# code converts an HTML document to XPS.

// Convert HTML to XPS in C#

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "canvas.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "canvas-output.xps");

// Initialize an HTML document from the file
using HTMLDocument document = new HTMLDocument(documentPath);

// Initialize XpsSaveOptions 
XpsSaveOptions options = new XpsSaveOptions();

// Convert HTML to XPS
Converter.ConvertHTML(document, options, savePath);

When to Use HTML to XPS Conversion

Use XPS output when a C# application needs a fixed-layout document for Windows-oriented viewing, printing, or internal document pipelines. XPS is useful when page fidelity matters but the workflow expects XPS rather than PDF. If the output must be widely shared outside an XPS-aware environment, HTML to PDF is often the more practical choice.

For XPS output, create XpsSaveOptions and pass it to Converter.ConvertHTML() together with the HTML source and output path. You can tune page setup, CSS processing, background color, rendering resolution, and stream-based output through the options object.

Customize HTML to XPS with XpsSaveOptions

Use XpsSaveOptions when the output XPS needs custom rendering settings. The options object is passed to ConvertHTML() and controls how the HTML document is rendered to XPS.

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.

The following example creates an XPS file with custom page size and background color.

// Convert HTML to XPS with custom settings using C#

string documentPath = Path.Combine(OutputDir, "save-options.html");
string savePath = Path.Combine(OutputDir, "save-options-output.xps");

// Prepare HTML code and save it to a file
string code = "<h1>  XpsSaveOptions Class</h1>\r\n" +
              "<p>Using XpsSaveOptions Class, you can programmatically apply a wide range of conversion parameters such as BackgroundColor, PageSetup, etc.</p>\r\n";

File.WriteAllText(documentPath, code);

// Initialize an HTML Document from the html file
using HTMLDocument document = new HTMLDocument(documentPath);

// Set up the page-size, margins and change the background color to AntiqueWhite
XpsSaveOptions options = new XpsSaveOptions()
{
    BackgroundColor = System.Drawing.Color.AntiqueWhite
};
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(Length.FromInches(4.9f), Length.FromInches(3.5f)), new Margin(30, 20, 10, 10));

// Convert HTML to XPS
Converter.ConvertHTML(document, options, savePath);

In this example:

• BackgroundColor changes the XPS page background.
• PageSetup.AnyPage defines the page size and margins used for the output pages.

Related XPS Workflows

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

Save HTML 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, or services that need to decide where the rendered output is stored.

Some output formats produce one file, such as PDF, XPS, and DOCX. Image formats such as JPG or PNG can produce multiple output streams when the rendered document has multiple pages.

The MemoryStreamProvider class below implements ICreateStreamProvider and keeps the generated streams in memory.

// 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 HTML to XPS with MemoryStreamProvider, reads the generated memory stream, and saves it to an XPS file.

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

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

// Initialize an HTML document
using HTMLDocument document = new HTMLDocument(@"<h1>Convert HTML to XPS File Format!</h1>", ".");

// Convert HTML to XPS using MemoryStreamProvider
Converter.ConvertHTML(document, 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(Path.Combine(OutputDir, "stream-provider.xps")))
{
    memory.CopyTo(fs);
}

Related HTML Conversion Guides

• Convert HTML to PDF – create PDF output with PdfSaveOptions.
• Convert HTML to DOCX – save HTML as a Word document with DocSaveOptions.
• Convert HTML to PNG – render HTML to PNG images.
• Convert HTML to JPG – render HTML to JPEG images.
• Convert HTML to MHTML – package HTML and resources into a single web archive.
• Convert HTML to Markdown – transform HTML content into Markdown.

Other Platforms

• Convert HTML to XPS in Java

Try Online HTML to XPS Conversion

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