Convert SVG to XPS in C#

To convert SVG to XPS in C#, load the SVG document or prepare SVG content, create XpsSaveOptions, and call Converter.ConvertSVG() with the source, options, and output path or stream provider.

XPS is a fixed-layout document format used in Windows-oriented viewing, printing, and document pipelines. SVG to XPS conversion is useful when vector graphics must be rendered into an XPS document with controlled page setup, background color, and resolution.

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 SVG to XPS with One Line of C#

The static Converter class provides a compact way to render SVG content to XPS. The example below converts a local SVG file to XPS with default XpsSaveOptions.

// Convert SVG to XPS using C#

// Invoke the ConvertSVG() method to convert SVG to XPS
Converter.ConvertSVG(Path.Combine(DataDir, "shapes.svg"), new XpsSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.xps"));

Convert SVG to XPS in C#

Use this workflow when SVG content is created in code and then saved as an XPS file.

The workflow is:

1. Prepare the SVG content and base URI.
2. Create an XpsSaveOptions instance.
3. Call Converter.ConvertSVG(content, baseUri, options, outputPath).
4. Save the generated XPS file to the target output path.

// Convert SVG to XPS in C#

// Prepare SVG code
string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
              "<circle cx ='100' cy ='100' r ='60' fill='none' stroke='red' stroke-width='10' />" +
              "</svg>";

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

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

// Convert SVG to XPS
Converter.ConvertSVG(code, ".", options, savePath);

Customize SVG to XPS with XpsSaveOptions

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

To customize SVG to XPS conversion:

1. Load the SVG file as an SVGDocument.
2. Create XpsSaveOptions.
3. Configure only the settings required by the output, such as PageSetup, BackgroundColor, CSS processing, or resolution.
4. Pass the document, options, and output path to Converter.ConvertSVG().

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 SVG to XPS in C# with custom page settings

// Prepare a path to a source SVG file
string documentPath = Path.Combine(DataDir, "aspose.svg");

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

// Initialize an SVG document from the file
using SVGDocument document = new SVGDocument(documentPath);

// Initialize XpsSaveOptions. Set up the page-size 500x500 pixels, margins, resolutions and change the background color to AliceBlue
XpsSaveOptions options = new XpsSaveOptions()
{
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue
};
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(500, 500), new Margin(30, 10, 10, 10));

// Convert SVG to XPS
Converter.ConvertSVG(document, options, savePath);

The image below illustrates the XPS rendering result with custom page size and background settings.

When to Use SVG 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, SVG 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 SVG 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 SVG to XPS with MemoryStreamProvider.

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

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

// Prepare SVG code
string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
              "<circle cx='50' cy='50' r='40' stroke='black' stroke-width='3' fill='red' />" +
              "</svg>";

// Convert SVG to XPS using the MemoryStreamProvider
Converter.ConvertSVG(code, ".", 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 SVG Conversion Guides

• Convert SVG to PDF – render SVG as a PDF document.
• Convert SVG to DOCX – save SVG content as a Word document.
• Convert SVG to PNG – render SVG as lossless raster output.
• Convert SVG to JPG – render SVG as compact JPEG output.

Other Platforms

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

Try Online SVG to XPS Conversion

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