将 MHTML 转换为 XPS – C#

要利用 XPS 格式完成特定任务，通常需要将 MHTML 转换为 XPS。XPS 文件是基于微软创建的 XML 纸张规范的页面布局文件。

本文将介绍如何使用 Converter 类的 ConvertMHTML() 方法将 MHTML 转换为 XPS，以及如何应用 XpsSaveOptions 和 ICreateStreamProvider 参数。

在线 MHTML 转换器

您可以检查 Aspose.HTML API 功能并实时转换 MHTML。请从本地文件系统加载 MHTML 文件，选择输出格式并运行示例。在示例中，默认设置了保存选项。您将立即收到一个单独文件的结果。

如果您想通过编程将 MHTML 转换为 XPS 格式，请参阅以下 C# 代码示例。

通过两行代码将 MHTML 转换为 XPS

例如，只需两行代码，您就可以在 C# 应用程序中将 MHTML 转换为 XPS！

// 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"));

将 MHTML 转换为 XPS

使用 Converter.ConvertMHTML 方法是将 MHTML 代码转换为各种格式的最常用方法。 使用 Aspose.HTML，您可以通过程序将 MHTML 转换为 XPS 格式，并完全控制各种转换参数。

下面的 C# 代码片段展示了如何使用 Aspose.HTML for .NET 将 MHTML 转换为 XPS。

1. 打开现有的 MHTML 文件。在示例中，我们使用 System.IO.FileStream 类的 OpenRead() 方法打开并从指定路径的文件系统中读取文件。
2. 创建 XpsSaveOptions 类的实例。
3. 使用 Converter 类的 ConvertMHTML() 方法将 MHTML 保存为 XPS 文件。您需要向 ConvertMHTML() 方法传递 MHTML 文件流、XpsSaveOptions 和输出文件路径，以便将 MHTML 转换为 XPS。

// 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);

XpsSaveOptions

Aspose.HTML 允许使用默认或自定义保存选项将 MHTML 转换为 XPS。 XpsSaveOptions用法可让您自定义渲染过程；您可以指定页面大小、页边距、背景颜色、分辨率等。

Property	Description
PageSetup	This property gets a page setup object and uses it for configuration output page-set.
Css	Gets a CssOptions object which is used for configuration of CSS properties processing.
BackgroundColor	This property sets the color that will fill the background of every page. By default, this property is Transparent.
HorizontalResolution	Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolution	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.

要了解有关 XpsSaveOptions 的更多信息，请阅读 微调转换器 一文。

使用 XpsSaveOptions 将 MHTML 转换为 XPS

要使用指定的 XpsSaveOptions 将 MHTML 转换为 XPS，应遵循以下几个步骤：

1. 打开现有的 MHTML 文件。
2. 创建一个新的 XpsSaveOptions 对象并指定保存选项。
3. 使用 ConvertMHTML() 方法将 MHTML 保存为 XPS 文件。您需要向 ConvertMHTML() 方法传递 MHTML 文件流、XpsSaveOptions 和输出文件路径，以便将 MHTML 转换为 XPS。

下面的示例展示了如何使用 XpsSaveOptions 创建带有自定义保存选项的 XPS 文件：

// 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);

在示例中，我们使用 System.IO.FileStream 类的 OpenRead() 方法打开并从指定路径的文件系统中读取源文件。XpsSaveOptions() 构造函数初始化了一个 XpsSaveOptions 类实例，并将其传递给 ConvertMHTML() 方法。ConvertMHTML() 方法接收 stream、options、输出文件路径 savePath 并执行转换操作。XpsSaveOptions 类提供了大量属性，可让您全面控制各种参数，并改进将 MHTML 转换为 XPS 格式的过程。

在上述示例中，我们使用

• BackgroundColor 属性，用于指定背景填充的颜色。默认的 BackgroundColor 是透明色。
• PageSetup属性指定 page size（以像素为单位）。

输出流提供商

如果需要将文件保存在远程存储器(如云、数据库等)中，可以实现 ICreateStreamProvider接口来手动控制文件创建过程。该接口被设计为一个回调对象，用于在文档/页面开始时创建一个流(取决于输出格式)，并在渲染文档/页面后释放早期创建的流。

Aspose.HTML for .NET为渲染操作提供了多种输出格式。其中一些格式只生成一个输出文件(例如 PDF、XPS)，其他格式则生成多个文件(图像格式 JPG、PNG等)。

下面的示例展示了如何在应用程序中实现和使用自己的MemoryStreamProvider：

// 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();
    }
}

// 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);
}

Aspose.HTML 提供免费的在线 MHTML 到 XPS 转换器，可将 MHTML 转换为高质量的 XPS 文件，简单快捷。只需上传、转换文件，几秒钟就能得到结果！