Output Streams – C# MemoryStream – Aspose.HTML for .NET

Output Streams – C#

В операциях преобразования мы обычно сохраняем результат рендеринга в файл. Однако в некоторых случаях вам может потребоваться сохранить результат в памяти или отправить его в удаленное хранилище. Вы можете легко сделать это, реализовав специализированный интерфейс ICreateStreamProvider и используя его в качестве входного параметра для преобразователя. Этот интерфейс представляет собой обратный вызов, который используется, когда требуется новый поток вывода.

Примечание. Его можно вызывать несколько раз, когда требуется несколько выходных потоков. Сценарий, когда этот случай возможен, – это рендеринг HTML в набор файлов изображений.

Класс MemoryStreamProvider

Библиотека C# Aspose.HTML позволяет реализовать класс MemoryStreamProvider как пользовательскую реализацию интерфейса ICreateStreamProvider. Класс MemoryStreamProvider предоставляет объекты C# MemoryStream в качестве выходных потоков для записи данных, которые могут храниться в памяти в виде потока.

Использование C# MemoryStream помогает избежать задержек, обычно связанных с чтением или записью файлов на диск. Кроме того, поскольку содержимое MemoryStream остается в памяти, физическое пространство на диске не используется. Приведенный ниже код C# является примером приложения, которое использует ICreateStreamProvider для сохранения результата рендеринга в памяти и сброса его в файл позже:

class MemoryStreamProvider : 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 (var stream in Streams)
            stream.Dispose();
    }
}

Давайте рассмотрим основные части класса MemoryStreamProvider:

1. Свойство Streams. Список объектов MemoryStream создается во время рендеринга документа. Эти объекты будут хранить данные, которые записываются в выходные потоки.
2. Реализация методов GetStream(). Методы GetStream() создают новые объекты MemoryStream, добавляют их в список Streams и возвращают их как выходные потоки.
3. Реализация метода ReleaseStream(). Метод ReleaseStream() освобождает объект Stream, заполненный данными. В этой реализации метод пустой. Тем не менее, вы можете настроить его для выполнения таких операций, как сброс потока на жесткий диск или освобождение любых ресурсов, связанных с потоком.
4. Реализация метода Dispose(). Этот метод вызывается для освобождения любых ресурсов, удерживаемых классом MemoryStreamProvider. Эта реализация удаляет все объекты MemoryStream в списке Streams, используя цикл foreach.

C# MemoryStream to File

В следующем коде C# показано, как использовать класс MemoryStreamProvider и библиотеку Aspose.HTML for .NET для преобразования HTML в JPG и сохранения изображения в файл. Давайте рассмотрим пример, где выполняются следующие шаги:

1. Создайте новый экземпляр класса MemoryStreamProvider. Он будет использоваться в качестве выходного потока для процесса преобразования.
2. Инициализируйте HTML-документ с помощью класса HTMLDocument.
3. Используйте конструктор ImageSaveOptions(), чтобы настроить параметры сохранения изображения, такие как ImageFormat – JPEG (в данном случае).
4. Вызовите метод ConvertHTML(document, options, provider), чтобы преобразовать объект HTMLDocument в изображение с использованием параметров сохранения и MemoryStreamProvider.
5. Используйте цикл foreach для перебора каждого объекта MemoryStream в свойстве Streams объекта streamProvider. Каждый MemoryStream представляет собой страницу преобразованного HTML-документа.
6. Вызовите метод memory.Seek() в потоке памяти, чтобы установить позицию в начало. Это делается для того, чтобы на следующем шаге все содержимое потока было скопировано в файловый поток.
7. Используйте метод File.Create() внутри цикла, чтобы создать выходной файл для текущей страницы.
8. Используйте метод memory.CopyTo(), чтобы скопировать содержимое потока памяти в объект FileStream, представляющий выходной файл.
9. После обработки каждой страницы счетчик страниц увеличивается, чтобы отслеживать номер страницы для имен выходных файлов.

// Create an instance of MemoryStreamProvider
using (var streamProvider = new MemoryStreamProvider())
{                
    // Prepare HTML code
    var code = @"<style>
                div { page-break-after: always; }
                </style>
                <div style='border: 1px solid red; width: 300px'>First Page</div>
                <div style='border: 1px solid red; width: 300px'>Second Page</div>
                <div style='border: 1px solid red; width: 300px'>Third Page</div>
             ";
    // Initialize an HTML document from the HTML code
    using var document = new HTMLDocument(code, ".");
    {
        // Convert HTML to Image by using the MemoryStreamProvider
        Converter.ConvertHTML(document, new ImageSaveOptions(ImageFormat.Jpeg), streamProvider);                    

        // Get access to the memory stream that contains the result data
        var page = 1;
        foreach (var memory in streamProvider.Streams)
        {
            memory.Seek(0, SeekOrigin.Begin);

            // Flush the result data to the output file
            using (FileStream fs = File.Create(Path.Combine(OutputDir, "page_" + page + ".jpg")))
            {
                memory.CopyTo(fs);
            }
            page++;
        }
    }
}

Aspose.HTML предлагает бесплатные онлайн Конвертеры для преобразования файлов HTML, XHTML, MHTML, EPUB, XML и Markdown в различные популярные форматы. Вы можете легко конвертировать HTML в PDF, HTML в JPG, SVG в PDF, MHTML в PDF или MD to HTML. Просто выберите файл, выберите формат для преобразования, и готово! Это быстро и совершенно бесплатно!