Как работает объединение MHTML на C#

Aspose.HTML for .NET обрабатывает несколько потоков архивов MHTML или MHT с помощью одного MhtmlRenderer и записывает содержимое в общее устройство вывода. Передайте потоки методу MhtmlRenderer.Render() в нужной последовательности, чтобы создать один файл PDF, XPS, DOCX или TIFF. Этот сценарий объединяет отрендеренное содержимое архивов, но не создает новый редактируемый архив MHTML.


Объединение MHTML на C# и интерактивный пример

Используйте интерактивный пример, чтобы задать порядок архивов и получить соответствующий сценарий на C#. Добавьте файлы MHTML или MHT в нужной последовательности и выберите PDF, XPS, DOCX или TIFF. При изменении выбора панель кода обновляет имена файлов, рендерер, устройство вывода и расширение результата. Настроенное объединение также можно запустить онлайн для проверки результата.

Сценарий объединения MHTML

По умолчанию выбран формат PDF. Рендерер остается MhtmlRenderer, а устройство вывода меняется в соответствии с выбранным форматом.

  1. Откройте каждый исходный файл .mhtml или .mht с помощью File.OpenRead() либо предоставьте другую доступную для чтения реализацию Stream.
  2. Расположите потоки в том порядке, в котором отрендеренное содержимое должно появиться в результате.
  3. Создайте экземпляр MhtmlRenderer .
  4. Создайте устройство вывода, например PdfDevice для PDF.
  5. Передайте устройство и все потоки архивов методу MhtmlRenderer.Render() .

Выбор формата результата для MHTML

  • PDF – создание документа с фиксированным макетом для распространения или печати.
  • XPS – рендеринг веб-архивов в документ XPS.
  • DOCX – создание документа для Microsoft Word или другого совместимого редактора.
  • TIFF – сохранение объединенных отрендеренных страниц как растрового изображения.

Сгенерированный C# выбирает PdfDevice, XpsDevice, DocDevice или ImageDevice для указанного результата. Параметры страниц, изображений и документов описаны в руководстве Устройства рендеринга в C# .


Особенности объединения MHTML

  • Порядок источников определяет порядок результата. Архивы обрабатываются в той же последовательности, в которой их потоки переданы методу MhtmlRenderer.Render().
  • Все входные потоки должны оставаться открытыми. Не освобождайте поток, пока рендерер не завершит запись объединенного результата.
  • Результат не является новым архивом MHTML. MIME-части интерпретируются и рендерятся, а не объединяются в другой редактируемый веб-архив.
  • Параметры макета относятся к устройству вывода. Размер страницы, поля, разрешение и другие свойства результата настраиваются через соответствующий класс параметров рендеринга.

Установка Aspose.HTML for .NET

Установите Aspose.HTML for .NET из NuGet с помощью .NET CLI:

dotnet add package Aspose.HTML

Также можно использовать интерфейс диспетчера пакетов NuGet или выполнить Install-Package Aspose.HTML в консоли диспетчера пакетов. Подробные инструкции приведены в руководстве по установке . Чтобы протестировать API без ограничений ознакомительной версии, запросите временную лицензию .


Вопросы об объединении MHTML

1. Различается ли обработка исходных файлов MHTML и MHT?

MHTML и MHT – распространенные расширения одного формата веб-архива MIME HTML. MhtmlRenderer обрабатывает потоки обоих типов по одному сценарию при условии, что MIME-структура и связанные части архива корректны.

2. Можно ли ограничить время рендеринга MHTML?

Да. Используйте перегрузку MhtmlRenderer.Render(), принимающую TimeSpan или CancellationToken. Ограничение полезно для архивов со сложными страницами, скриптами или ресурсами, которые могут задерживать завершение операции.

3. Попадут ли встроенные изображения, стили и шрифты в результат?

Рендерер использует корректные MIME-части, на которые ссылается архивная страница. Отсутствующие части, неверные расположения содержимого или недоступные внешние ресурсы могут привести к потере стилей, изображений или шрифтов.

4. Можно ли передать HTML-документы и потоки MHTML одному вызову рендерера?

Нет. MhtmlRenderer принимает потоки MHTML, а HtmlRenderer – объекты HTMLDocument. Используйте рендерер, соответствующий набору источников, либо заранее приведите файлы к общему представлению в отдельно спроектированном процессе.

5. Можно ли записать объединенный PDF в поток?

Да. Создайте PdfDevice с доступным для записи объектом Stream, затем передайте устройство и входные потоки MHTML методу MhtmlRenderer.Render(). Если приложение должно прочитать или передать результат, не закрывайте выходной поток до завершения рендеринга.

Другие способы объединения файлов

Выберите другой исходный формат или вернитесь к обзору сценариев объединения.