API para unir archivos HTML, MHTML, EPUB y Markdown
Combina varios archivos de origen en C# y renderiza su contenido en un único documento de salida.
Unir archivos HTML, MHTML, EPUB y Markdown en C#
Aspose.HTML for .NET
combina varios archivos de origen del mismo tipo en un único documento renderizado. Para HTML, pase objetos
HTMLDocument
a
HtmlRenderer
. Para archivos MHTML o MHT, pase flujos a
MhtmlRenderer
; para publicaciones EPUB, use
EpubRenderer
. Los archivos Markdown se convierten primero en objetos HTMLDocument mediante
Converter.ConvertMarkdown()
y después se procesan con HtmlRenderer. En cada flujo de trabajo, el orden de los archivos de origen determina el orden del contenido, mientras que el dispositivo de salida determina el formato final.
Elegir un flujo de trabajo para unir archivos
| Archivos de origen | Representación en C# | Renderizador | Guía detallada |
|---|---|---|---|
| HTML | HTMLDocument | HtmlRenderer | Unir archivos HTML |
| MHTML o MHT | Stream | MhtmlRenderer | Unir archivos MHTML |
| EPUB | Stream | EpubRenderer | Unir archivos EPUB |
| Markdown o MD | HTMLDocument devuelto por Converter.ConvertMarkdown() | HtmlRenderer | Unir archivos Markdown |
Unir HTML en C# con un ejemplo interactivo
El ejemplo de esta página muestra el flujo de trabajo para HTML. Añada archivos HTML locales o direcciones URL en el orden necesario y seleccione PDF, XPS, DOCX, TIFF o MHTML. Para las salidas basadas en renderizadores, el panel C# actualiza las declaraciones de los documentos, el dispositivo de salida y la extensión según la selección actual. Ejecute en línea la unión configurada para comprobar el resultado o copie el código generado en un proyecto .NET. Consulte la guía para unir archivos HTML para conocer el tratamiento de recursos y las limitaciones específicas de 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);
Elegir un dispositivo de salida
- Use
PdfDevicepara crear un PDF destinado a distribución, archivo o impresión. - Use
XpsDevicepara escribir los archivos de origen renderizados en un documento XPS. - Use
DocDevicepara crear un documento DOCX compatible con Microsoft Word y otros editores. - Use
ImageDeviceconImageRenderingOptionspara generar TIFF u otro formato ráster compatible.
Cada dispositivo dispone de una clase de opciones de renderizado para configurar el tamaño de página, los márgenes, la resolución y otros parámetros específicos del formato final. Consulte Dispositivos de renderizado en C# para conocer los dispositivos y constructores disponibles.
La herramienta interactiva para unir HTML también permite crear un archivo web MHTML.
Instalar Aspose.HTML for .NET
Instale Aspose.HTML for .NET desde NuGet con la CLI de .NET:
dotnet add package Aspose.HTML
También puede usar la interfaz del Administrador de paquetes NuGet o ejecutar Install-Package Aspose.HTML en la consola del Administrador de paquetes. Consulte la
guía de instalación
para configurar la biblioteca o solicite una
licencia temporal
para evaluar la API sin limitaciones.
Preguntas frecuentes sobre la API para unir archivos
1. ¿Un mismo renderizador admite todos los formatos de origen?
No. Use HtmlRenderer con objetos HTMLDocument, MhtmlRenderer con flujos MHTML o MHT y EpubRenderer con flujos EPUB. Markdown se convierte primero en un HTMLDocument mediante Converter.ConvertMarkdown() y después se procesa con HtmlRenderer.
2. ¿La unión crea un archivo editable en el formato de origen?
No. El renderizador envía varios archivos de origen a un dispositivo y crea una salida PDF, XPS, DOCX o ráster. No combina árboles DOM de HTML, estructuras MIME de MHTML, paquetes EPUB ni texto Markdown en un nuevo archivo de origen.
3. ¿Puedo pasar distintos formatos de origen a una misma llamada del renderizador?
No. Un renderizador espera una única representación de origen, como objetos HTMLDocument o flujos de archivos. Use el flujo de trabajo adecuado para el conjunto de archivos o normalice previamente las entradas mediante un proceso independiente.
4. ¿Qué determina el orden del contenido en el resultado unido?
El orden de los archivos pasados a Render() determina su posición en la salida. Reordene los documentos o flujos antes de la llamada cuando el PDF, XPS, DOCX o TIFF final necesite una secuencia diferente.
5. ¿Puedo escribir la salida unida en un flujo?
Sí. Los dispositivos de salida como PdfDevice aceptan destinos basados en flujos, mientras que ICreateStreamProvider permite controlar la creación y liberación de los flujos de salida. Mantenga el destino disponible hasta que finalice el renderizado.
Más funciones de Aspose.HTML for .NET
Explore herramientas y guías de API para conversión, edición, generación de código y accesibilidad web.