API zum Zusammenführen von HTML, MHTML, EPUB und Markdown
Mehrere Quelldateien in C# kombinieren und in einem Ausgabedokument rendern.
HTML-, MHTML-, EPUB- und Markdown-Dateien in C# zusammenführen
Aspose.HTML for .NET
führt mehrere Quelldateien desselben Typs in einem gerenderten Dokument zusammen. Übergeben Sie für HTML
HTMLDocument
-Objekte an
HtmlRenderer
. MHTML- oder MHT-Archive werden als Streams an
MhtmlRenderer
übergeben, EPUB-Publikationen an
EpubRenderer
. Markdown-Dateien werden zunächst mit
Converter.ConvertMarkdown()
in HTMLDocument-Objekte konvertiert und anschließend von HtmlRenderer verarbeitet. In jedem Workflow bestimmt die Reihenfolge der Quelldateien die Reihenfolge des Inhalts, während das Ausgabegerät das Zielformat festlegt.
Workflow zum Zusammenführen auswählen
| Quelldateien | Darstellung in C# | Renderer | Ausführliche Anleitung |
|---|---|---|---|
| HTML | HTMLDocument | HtmlRenderer | HTML zusammenführen |
| MHTML oder MHT | Stream | MhtmlRenderer | MHTML zusammenführen |
| EPUB | Stream | EpubRenderer | EPUB zusammenführen |
| Markdown oder MD | Von Converter.ConvertMarkdown() zurückgegebenes HTMLDocument | HtmlRenderer | Markdown zusammenführen |
HTML in C# zusammenführen und interaktives Beispiel
Das Beispiel auf dieser Übersichtsseite zeigt den HTML-Workflow. Fügen Sie lokale HTML-Dateien oder URLs in der gewünschten Reihenfolge hinzu und wählen Sie PDF, XPS, DOCX, TIFF oder MHTML. Bei rendererbasierten Ausgaben aktualisiert das C#-Panel die Dokumentdeklarationen, das Ausgabegerät und die Dateierweiterung entsprechend der aktuellen Auswahl. Führen Sie den konfigurierten Vorgang online aus, um das Ergebnis zu prüfen, oder kopieren Sie den generierten Code in ein .NET-Projekt. Hinweise zur HTML-spezifischen Ressourcenverarbeitung und zu Einschränkungen finden Sie in der Anleitung zum Zusammenführen von HTML .
using Aspose.Html;
using Aspose.Html.Rendering;
using Aspose.Html.Rendering.Pdf;
// Load the HTML documents in the required merge order.
using HTMLDocument document1 = new HTMLDocument("first.html");
using HTMLDocument document2 = new HTMLDocument("second.html");
// Create the renderer and the PDF output device.
using HtmlRenderer renderer = new HtmlRenderer();
using PdfDevice device = new PdfDevice("merged.pdf");
// Render the sources into one PDF file.
renderer.Render(device, document1, document2);
Ausgabegerät auswählen
- Verwenden Sie
PdfDevice, um eine PDF-Datei für Verteilung, Archivierung oder Druck zu erstellen. - Verwenden Sie
XpsDevice, um die gerenderten Quellen in ein XPS-Dokument zu schreiben. - Verwenden Sie
DocDevice, um ein DOCX-Dokument für Microsoft Word oder einen anderen kompatiblen Editor zu erstellen. - Verwenden Sie
ImageDevicemitImageRenderingOptions, um TIFF oder ein anderes unterstütztes Rasterformat zu erzeugen.
Zu jedem Gerät gehört eine Klasse mit Rendering-Optionen für Seitengröße, Ränder, Auflösung und weitere zielspezifische Einstellungen. Unterstützte Geräte und Konstruktoren finden Sie unter Rendering Devices in C# .
Der interaktive HTML-Merger unterstützt außerdem die Ausgabe als MHTML-Webarchiv.
Aspose.HTML for .NET installieren
Installieren Sie Aspose.HTML for .NET aus NuGet mit der .NET CLI:
dotnet add package Aspose.HTML
Alternativ können Sie die Benutzeroberfläche des NuGet-Paket-Managers verwenden oder Install-Package Aspose.HTML in der Paket-Manager-Konsole ausführen. Einzelheiten zur Einrichtung finden Sie in der
Installationsanleitung
. Mit einer
temporären Lizenz
können Sie die API ohne Einschränkungen der Evaluierung testen.
Häufige Fragen zur Merger-API
1. Unterstützt ein Renderer alle Quellformate?
Nein. Verwenden Sie HtmlRenderer für HTMLDocument-Quellen, MhtmlRenderer für MHTML- oder MHT-Streams und EpubRenderer für EPUB-Streams. Markdown wird zunächst mit Converter.ConvertMarkdown() in ein HTMLDocument konvertiert und anschließend mit HtmlRenderer verarbeitet.
2. Erstellt das Zusammenführen eine editierbare Datei im Quellformat?
Nein. Der Renderer sendet mehrere Quellen an ein Ausgabegerät und erstellt eine gerenderte PDF-, XPS-, DOCX- oder Rasterausgabe. HTML-DOM-Bäume, MHTML-MIME-Strukturen, EPUB-Pakete und Markdown-Text werden nicht zu einer neuen Quelldatei verbunden.
3. Können unterschiedliche Quellformate an einen Renderer-Aufruf übergeben werden?
Nein. Ein Renderer erwartet eine einheitliche Quelldarstellung, etwa HTMLDocument-Objekte oder Archiv-Streams. Verwenden Sie den zum Quellsatz passenden Workflow oder normalisieren Sie gemischte Eingaben zuvor in einem separat definierten Prozess.
4. Wodurch wird die Reihenfolge der Inhalte im Ergebnis bestimmt?
Die Reihenfolge der an Render() übergebenen Quellen bestimmt deren Reihenfolge in der Ausgabe. Ordnen Sie die Dokumente oder Streams vor dem Aufruf neu an, wenn PDF, XPS, DOCX oder TIFF eine andere Abfolge erhalten soll.
5. Kann die zusammengeführte Ausgabe in einen Stream geschrieben werden?
Ja. Ausgabegeräte wie PdfDevice akzeptieren streambasierte Ziele. ICreateStreamProvider unterstützt Workflows, in denen die Anwendung die Erstellung und Freigabe von Ausgabestreams steuern muss. Halten Sie das Ziel bis zum Abschluss des Renderings geöffnet.
Weitere Funktionen von Aspose.HTML for .NET
Entdecken Sie Tools und API-Anleitungen für Konvertierung, Bearbeitung, Codegenerierung und Barrierefreiheit.