Конвертировать MHTML в XPS | С#
Преобразование MHTML в XPS часто требуется для использования преимуществ формата XPS для конкретных задач. Файл XPS представляет собой файлы макета страницы, основанные на спецификациях XML Paper, созданных Microsoft.
В этой статье вы найдете информацию о том, как преобразовать MHTML в XPS с помощью методов ConvertMHTML() класса Converter и как применить XpsSaveOptions и ICreateStreamProvider.
Онлайн MHTML Конвертер
Вы можете проверить функциональность Aspose.HTML API и конвертировать MHTML в режиме реального времени. Загрузите файл MHTML из локальной файловой системы, выберите выходной формат и запустите пример. В примере параметры сохранения установлены по умолчанию. Вы сразу получите результат в виде отдельного файла.
Если вы хотите программно преобразовать формат MHTML в XPS, рассмотрим следующие примеры кода C#.
MHTML в XPS двумя строками кода!
Статические методы класса Converter в основном используются как самый простой способ преобразования кода MHTML в различные форматы. Например, вы можете преобразовать MHTML в XPS в своем приложении C# буквально с помощью двух строк кода!
1using System.IO;
2using Aspose.Html.Converters;
3using Aspose.Html.Saving;
4...
5 // Open an existing MHTML file for reading
6 using var stream = File.OpenRead(DataDir + "sample.mht");
7
8 // Invoke the ConvertMHTML() method to convert the MHTML code to XPS
9 Converter.ConvertMHTML(stream, new XpsSaveOptions(), Path.Combine(OutputDir, "convert-by-two-lines.xps"));
Конвертировать MHTML в XPS
Использование методов Converter.ConvertMHTML() является наиболее распространенным способом преобразования кода MHTML в различные форматы. С помощью Aspose.HTML вы можете программно конвертировать MHTML в формат XPS с полным контролем над широким диапазоном параметров конвертации.
В следующем фрагменте кода C# показано, как преобразовать MHTML в XPS с помощью Aspose.HTML для .NET:
- Откройте существующий файл MHTML.
- Создайте экземпляр класса XpsSaveOptions.
- Используйте метод ConvertMHTML() класса Converter для сохранения MHTML в виде XPS-файла. Вам необходимо передать файловый поток MHTML, XpsSaveOptions и путь к выходному файлу методу ConvertMHTML() для преобразования MHTML в XPS.
В примере мы используем метод OpenRead() класса System.IO.FileStream для открытия и чтения файлов из файловой системы по указанному пути.
1using System.IO;
2using Aspose.Html.Converters;
3using Aspose.Html.Saving;
4...
5 // Open an existing MHTML file for reading
6 using var stream = File.OpenRead(DataDir + "sample.mht");
7
8 // Prepare a path for converted file saving
9 string savePath = Path.Combine(OutputDir, "sample-output.xps");
10
11 // Create an instance of XpsSaveOptions
12 var options = new XpsSaveOptions();
13
14 // Call the ConvertMHTML() method to convert MHTML to XPS
15 Converter.ConvertMHTML(stream, options, savePath);
Вы можете скачать полные примеры и файлы данных с GitHub.
Параметры сохранения
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, прочитайте статьи раздела Конвертеры тонкой настройки.
Конвертировать MHTML в XPS с использованием XpsSaveOptions
Чтобы преобразовать MHTML в XPS с указанием XpsSaveOptions, необходимо выполнить несколько шагов:
- Откройте существующий файл MHTML.
- Создайте новый объект XpsSaveOptions и укажите параметры сохранения.
- Используйте метод ConvertMHTML(), чтобы сохранить MHTML в виде файла XPS. Вам необходимо передать файловый поток MHTML, XpsSaveOptions и путь к выходному файлу в метод ConvertMHTML() для преобразования MHTML в XPS.
В следующем примере показано, как использовать XpsSaveOptions и создать XPS-файл с настраиваемыми параметрами сохранения:
1using System.IO;
2using Aspose.Html;
3using Aspose.Html.Converters;
4using Aspose.Html.Saving;
5using System.Drawing;
6using Aspose.Html.Drawing;
7...
8 // Open an existing MHTML file for reading
9 using var stream = File.OpenRead(DataDir + "sample.mht");
10
11 // Prepare a path for converted file saving
12 string savePath = Path.Combine(OutputDir, "sample-options.xps");
13
14 // Create an instance of XpsSaveOptions. Set up the page-size and change the background color to AliceBlue
15 var options = new XpsSaveOptions();
16 options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(Length.FromInches(8.3f), Length.FromInches(5.8f)));
17 options.BackgroundColor = System.Drawing.Color.AliceBlue;
18
19 // Call the ConvertMHTML() method to convert MHTML to XPS
20 Converter.ConvertMHTML(stream, options, savePath);
В примере мы используем метод OpenRead() класса System.IO.FileStream для открытия и чтения исходных файлов из файловой системы по указанному пути. Конструктор
XpsSaveOptions() инициализирует экземпляр класса XpsSaveOptions, который передается методу ConvertMHTML(). Метод ConvertMHTML() принимает stream
, options
, путь к выходному файлу savePath
и выполняет операцию преобразования. Класс XpsSaveOptions предоставляет множество свойств, которые дают вам полный контроль над широким спектром параметров и улучшают процесс преобразования MHTML в формат XPS.
В приведенном выше примере мы используем:
- Свойство
BackgroundColor
, указывающее цвет, которым будет заливаться фон. По умолчанию BackgroundColor имеет значение Transparent; - Свойство
PageSetup
, указывающее page size в пикселях.
Output Stream Providers
Если требуется сохранять файлы в удаленном хранилище (например, в облаке, базе данных и т. д.), вы можете реализовать ICreateStreamProvider для ручного управления процессом создания файла. Этот интерфейс разработан как объект обратного вызова для создания потока в начале документа/страницы (в зависимости от выходного формата) и освобождения ранее созданного потока после рендеринга документа/страницы.
Aspose.HTML для .NET предоставляет различные типы выходных форматов для операций рендеринга. Некоторые из этих форматов создают один выходной файл (например, PDF, XPS), другие создают несколько файлов (форматы изображений JPG, PNG и т. д.).
В приведенном ниже примере показано, как реализовать и использовать собственный MemoryStreamProvider в приложении:
1using System.IO;
2using System.Collections.Generic;
3...
4 class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
5 {
6 // List of MemoryStream objects created during the document rendering
7 public List<MemoryStream> Streams { get; } = new List<MemoryStream>();
8
9 public Stream GetStream(string name, string extension)
10 {
11 // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats.
12 MemoryStream result = new MemoryStream();
13 Streams.Add(result);
14 return result;
15 }
16
17 public Stream GetStream(string name, string extension, int page)
18 {
19 // 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.)
20 MemoryStream result = new MemoryStream();
21 Streams.Add(result);
22 return result;
23 }
24
25 public void ReleaseStream(Stream stream)
26 {
27 // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
28 }
29
30 public void Dispose()
31 {
32 // Releasing resources
33 foreach (var stream in Streams)
34 stream.Dispose();
35 }
36 }
1using System.IO;
2using Aspose.Html;
3using System.Linq;
4using Aspose.Html.Converters;
5using Aspose.Html.Saving;
6...
7 // Create an instance of MemoryStreamProvider
8 using var streamProvider = new MemoryStreamProvider();
9
10 // Open an existing MHTML file for reading
11 using var stream = File.OpenRead(DataDir + "sample.mht");
12
13 // Prepare a path for converted file saving
14 string savePath = Path.Combine(OutputDir, "stream-provider.xps");
15
16 // Convert MHTML to XPS by using the MemoryStreamProvider class
17 Converter.ConvertMHTML(stream, new XpsSaveOptions(), streamProvider);
18
19 // Get access to the memory stream that contains the result data
20 var memory = streamProvider.Streams.First();
21 memory.Seek(0, SeekOrigin.Begin);
22
23 // Flush the result data to the output file
24 using (FileStream fs = File.Create(savePath))
25 {
26 memory.CopyTo(fs);
27 }
Aspose.HTML предлагает бесплатный онлайн конвертер MHTML в XPS, который конвертирует файлы MHTML в XPS качественно, легко и быстро. Просто загрузите, конвертируйте файлы и получите результат за несколько секунд!