Ausgabeströme – C# MemoryStream

Ausgabeströme – Output Streams – C#

Bei Konvertierungsvorgängen speichern wir das Rendering-Ergebnis normalerweise in der Datei. In einigen Fällen kann es jedoch erforderlich sein, das Ergebnis im Speicher zu speichern oder es an einen entfernten Speicherort zu senden. Sie können dies einfach tun, indem Sie die spezialisierte Schnittstelle ICreateStreamProvider implementieren und sie als Eingabeparameter für den Konverter verwenden. Diese Schnittstelle stellt einen Callback dar, der verwendet wird, wenn ein neuer Ausgabestrom benötigt wird.

Hinweis: Sie kann einige Male aufgerufen werden, wenn mehrere Ausgabeströme erforderlich sind. Das Szenario, in dem dieser Fall möglich ist, ist das Rendern von HTML in den Satz von Bilddateien.

MemoryStreamProvider-Klasse

Die Aspose.HTML C# Bibliothek ermöglicht die Realisierung der Klasse MemoryStreamProvider als eine eigene Implementierung der ICreateStreamProvider Schnittstelle. Die Klasse MemoryStreamProvider stellt C# MemoryStream-Objekte als Ausgabestreams zum Schreiben von Daten zur Verfügung, die als Stream im Speicher abgelegt werden können.

Die Verwendung eines C# MemoryStream hilft, Latenzen zu vermeiden, die üblicherweise mit dem Lesen oder Schreiben von Dateien auf einer Festplatte verbunden sind. Da der Inhalt eines MemoryStreams im Speicher verbleibt, wird außerdem kein physischer Speicherplatz auf der Festplatte beansprucht.

// How to capture output in memory using a custom stream provider

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 (MemoryStream stream in Streams)
            stream.Dispose();
    }
}

Schauen wir uns die Hauptbestandteile der Klasse MemoryStreamProvider an:

1. Eigenschaft Streams. Eine Liste von MemoryStream-Objekten wird während des Renderings des Dokuments erstellt. Diese Objekte speichern die Daten, die in die Ausgabeströme geschrieben werden.
2. Implementierung der GetStream()-Methoden. Die GetStream()-Methoden erstellen neue MemoryStream-Objekte, fügen sie der Streams-Liste hinzu und geben sie als Output-Streams zurück.
3. Implementierung der Methode ReleaseStream(). Die ReleaseStream()-Methode gibt ein mit Daten gefülltes Stream-Objekt frei. In dieser Implementierung ist die Methode leer. Dennoch kann sie angepasst werden, um Operationen wie das Flushen des Streams auf eine Festplatte oder die Freigabe aller mit dem Stream verbundenen Ressourcen durchzuführen.
4. Implementierung der Methode Dispose(). Diese Methode wird aufgerufen, um alle Ressourcen freizugeben, die von der MemoryStreamProvider Klasse gehalten werden. Diese Implementierung entsorgt alle MemoryStream-Objekte in der Streams-Liste mit Hilfe einer “Foreach”-Schleife.

C# MemoryStream in Datei

Der folgende C#-Code zeigt, wie die Klasse MemoryStreamProvider und die Aspose.HTML for .NET-Bibliothek verwendet werden, um ein mehrseitiges HTML-Dokument in JPG zu konvertieren und das Bild in einer Datei zu speichern. Schauen wir uns das Beispiel an, in dem die folgenden Schritte ausgeführt werden:

1. Erstellen Sie eine neue Instanz der Klasse MemoryStreamProvider. Sie wird als Ausgabestrom für den Konvertierungsprozess verwendet.
2. Initialisieren Sie ein HTML-Dokument mit Hilfe der HTMLDocument Klasse.
3. Verwenden Sie den ImageSaveOptions()-Konstruktor, um die Bildspeicheroptionen zu konfigurieren, wie z.B. das ImageFormat – in diesem Fall JPEG.
4. Rufen Sie die Methode ConvertHTML(document, options, provider) auf, um das HTMLDocument-Objekt unter Verwendung von Speicheroptionen und MemoryStreamProvider in ein Bild zu konvertieren.
5. Verwenden Sie die foreach-Schleife, um über jedes MemoryStream-Objekt in der Streams-Eigenschaft des streamProvider-Objekts zu iterieren. Jeder MemoryStream stellt eine Seite des konvertierten HTML-Dokuments dar.
6. Rufen Sie die Methode memory.Seek() für den MemoryStream auf, um die Position an den Anfang zu setzen. Dadurch wird sichergestellt, dass der gesamte Inhalt des Streams in die Ausgabedatei kopiert wird.
7. Verwenden Sie die Methode File.Create() innerhalb der Schleife, um eine Ausgabedatei für die aktuelle Seite zu erstellen.
8. Verwenden Sie die Methode memory.CopyTo(), um den Inhalt des Speicherstroms in das FileStream-Objekt zu kopieren, das die Ausgabedatei darstellt.
9. Nach der Verarbeitung jeder Seite wird der Seitenzähler inkrementiert, um die Seitennummer für die Ausgabedateinamen festzuhalten.

// Convert HTML to JPEG in C# using output memory streams for writing data

// Create an instance of MemoryStreamProvider
using (MemoryStreamProvider streamProvider = new MemoryStreamProvider())
{
    // Prepare HTML code
    string 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 HTMLDocument 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
        int page = 1;
        foreach (MemoryStream 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 bietet kostenlose Online- Konverter zur Konvertierung von HTML-, XHTML-, MHTML-, EPUB-, XML- und Markdown-Dateien in eine Vielzahl von gängigen Formaten. Sie können ganz einfach HTML in PDF, HTML in JPG, SVG in PDF, MHTML in PDF oder MD in HTML konvertieren. Wählen Sie einfach eine Datei aus, wählen Sie das zu konvertierende Format und fertig. Es geht schnell und ist kostenlos!