Analizar, editar y convertir HTML en C#

Aspose.HTML for .NET es una biblioteca de clases para procesar contenido HTML en aplicaciones C#. La clase HTMLDocument carga HTML desde un archivo, una URL, una cadena o un flujo y permite acceder al documento mediante un DOM basado en estándares. Las aplicaciones pueden buscar y editar elementos, trabajar con CSS, SVG y HTML Canvas, y utilizar la clase Converter para generar archivos PDF, XPS, DOCX e imágenes rasterizadas. La API también admite XHTML, MHTML, EPUB y Markdown.

Elija una tarea para trabajar con HTML

Elija la tarea que corresponda a su aplicación. Cada guía explica las clases de API relevantes, proporciona un ejemplo específico en C# y enlaza a documentación detallada y páginas de referencia de la API.





Instalar Aspose.HTML for .NET

Agregue el paquete NuGet Aspose.HTML a un proyecto .NET. El paquete proporciona los espacios de nombres para HTML DOM, CSS, renderizado, conversión y procesamiento de documentos utilizados en los ejemplos y guías de este sitio.

Instalar Aspose.HTML con la CLI de .NET



dotnet add package Aspose.HTML


Cómo encontrar elementos HTML en C#

Cargue un archivo HTML con HTMLDocument , utilice QuerySelectorAll() para buscar los elementos coincidentes y lea cada resultado mediante el DOM. El ejemplo utiliza tipos explícitos de Aspose.HTML y puede ejecutarse en una aplicación de consola después de instalar el paquete NuGet.

Buscar elementos HTML en C#



using Aspose.Html;
using Aspose.Html.Collections;
using Aspose.Html.Dom;

// Load the HTML document
using HTMLDocument document = new HTMLDocument("input.html");

// Select every link in the document
NodeList links = document.QuerySelectorAll("a");

foreach (Element link in links)
{
    Console.WriteLine($"{link.TextContent}: {link.GetAttribute("href")}");
}


QuerySelectorAll("a") devuelve una NodeList con todos los elementos <a> coincidentes en el orden del documento. Utilice QuerySelector() cuando solo necesite el primer elemento coincidente o consultas XPath para expresiones XPath.

Formatos web y tipos de salida compatibles

Tipo de entrada o documentoOperaciones disponibles
HTML y XHTMLAnalizar, crear, editar, navegar, combinar, convertir y renderizar
MHTML y MHTCargar archivos, convertir, renderizar, combinar y crear archivos actualizados
EPUBCargar publicaciones, combinar contenido y renderizar en formatos de diseño fijo o imagen
MarkdownAnalizar, crear, editar, convertir a HTML y renderizar mediante un documento HTML
SVGCargar, inspeccionar, editar y convertir contenido vectorial

Según el formato de origen, los flujos de conversión pueden generar archivos PDF, XPS, DOCX, TIFF, PNG, JPEG, BMP y GIF. Consulte la documentación sobre conversión de formatos para elegir el método correcto de la clase Converter y la clase adecuada de opciones de guardado.

Clases de la API HTML y recursos para desarrolladores

  • HTMLDocument representa un documento HTML cargado o recién creado y permite acceder al DOM.
  • QuerySelector() y QuerySelectorAll() localizan elementos mediante selectores CSS.
  • Converter proporciona métodos estáticos para convertir HTML, XHTML, MHTML, EPUB, Markdown y SVG.
  • PdfSaveOptions , DocSaveOptions, ImageSaveOptions y XpsSaveOptions configuran la salida para cada formato.

Comience con la documentación de instalación y configuración , consulte la referencia completa de la API Aspose.HTML for .NET o pruebe ejemplos ejecutables en el repositorio de Aspose.HTML for .NET en GitHub .

Preguntas frecuentes

1. ¿Qué puedo hacer con un documento HTML en C# después de cargarlo?

Después de cargar HTML en un HTMLDocument, puede inspeccionar el DOM, buscar elementos con selectores CSS o XPath, modificar contenido y atributos, agregar o eliminar nodos y guardar o convertir el documento actualizado.

2. ¿Puedo modificar HTML antes de convertirlo a PDF o a una imagen?

Sí. Cargue el origen en un HTMLDocument, modifique el DOM, el CSS o el contenido vinculado y pase el documento actualizado al método de conversión requerido. El archivo PDF, XPS, DOCX o de imagen generado reflejará esos cambios.

3. ¿Cómo se resuelven las URL relativas de CSS, imágenes y fuentes al cargar HTML?

Las URL relativas de los recursos se resuelven con respecto a la dirección del documento o a la URL base indicada al cargar el HTML. Una URL base correcta es especialmente importante cuando el marcado procede de una cadena o un flujo y hace referencia a recursos externos.

4. ¿Qué método de API debo usar para convertir HTML, MHTML, EPUB, Markdown o SVG?

Utilice el método de la clase Converter correspondiente al formato de origen, como ConvertHTML(), ConvertMHTML(), ConvertEPUB(), ConvertMarkdown() o ConvertSVG(). La clase de opciones de guardado determina el formato de salida y la configuración de conversión.



  

Support and Learning Resources

  
  

Aspose.HTML proporciona API de procesamiento HTML para otras plataformas de desarrollo populares.