API de processamento HTML em C# – Aspose.HTML for .NET

Analise HTML, edite o DOM, converta documentos web e gere arquivos de saída em aplicações .NET.

Analisar, editar e converter HTML em C#

Aspose.HTML for .NET é uma biblioteca de classes para processar conteúdo HTML em aplicações C#. A classe HTMLDocument carrega HTML de um arquivo, URL, string ou stream e fornece acesso ao documento por meio de um DOM baseado em padrões. As aplicações podem localizar e editar elementos, trabalhar com CSS, SVG e HTML Canvas e usar a classe Converter para gerar arquivos PDF, XPS, DOCX e imagens rasterizadas. A API também oferece suporte a XHTML, MHTML, EPUB e Markdown.

Escolha uma tarefa para trabalhar com HTML

Escolha a tarefa adequada à sua aplicação. Cada guia explica as classes de API relevantes, fornece um exemplo C# específico e apresenta links para documentação detalhada e páginas de API Reference.

Criar e carregar documentos HTML
Crie documentos com marcação ou nós DOM e carregue HTML de um arquivo, URL, string ou stream.

Localizar e extrair elementos HTML
Encontre conteúdo com seletores CSS ou consultas XPath e leia os nós DOM correspondentes em C#.

Editar documentos web
Modifique elementos, atributos, texto, estilos e recursos vinculados em fluxos com HTML, MHTML e Markdown.

Converter HTML em formatos de saída
Converta HTML e XHTML em PDF, XPS, DOCX, TIFF, PNG, JPEG e outros formatos compatíveis.

Converter EPUB, MHTML, Markdown e SVG
Use métodos de conversão e opções de salvamento específicos para cada formato web ou de publicação.

Combinar documentos web
Combine várias fontes HTML, MHTML, EPUB ou Markdown em um único documento na ordem necessária.

Gerar código HTML
Crie marcação para formulários, mídia, tabelas, links, elementos interativos e texto semântico em exemplos online.

newVerificar a acessibilidade web
Verifique regras WCAG, contraste de cores e textos alternativos de imagens e exporte os resultados da validação.

Gerenciar imagens no HTML
Adicione, remova, redimensione ou extraia imagens sem alterar a estrutura e o restante do conteúdo do documento.

Criar e editar tabelas HTML
Crie tabelas com a API DOM, extraia linhas e células ou atualize o conteúdo de tabelas existentes em C#.

Preencher modelos HTML
Combine um modelo HTML com dados XML ou JSON para gerar documentos a partir de layouts reutilizáveis.

Desenhar com HTML Canvas 2D
Desenhe formas, texto, caminhos e imagens com a API Canvas 2D e renderize o resultado com o documento.

Converter unidades de comprimento CSS
Use a API `Unit` para converter pixels CSS, centímetros e milímetros em cálculos C#.

newUsar desenho multiplataforma no Linux
Adicione o pacote Aspose.HTML.Drawing quando uma aplicação Linux precisar de recursos de desenho sem System.Drawing.Common.

Instalar Aspose.HTML for .NET

Adicione o pacote NuGet Aspose.HTML a um projeto .NET. O pacote fornece os namespaces de HTML DOM, CSS, renderização, conversão e processamento de documentos usados nos exemplos e guias deste site.

Instalar Aspose.HTML com a CLI do .NET



dotnet add package Aspose.HTML

Como localizar elementos HTML em C#

Carregue um arquivo HTML com HTMLDocument , use QuerySelectorAll() para localizar os elementos correspondentes e leia cada resultado pelo DOM. O exemplo usa tipos explícitos do Aspose.HTML for .NET e pode ser executado em uma aplicação de console após a instalação do pacote NuGet.

Localizar elementos HTML em 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") retorna uma NodeList com todos os elementos <a> correspondentes na ordem do documento. Use QuerySelector() quando precisar apenas do primeiro elemento encontrado ou use consultas XPath para expressões XPath.

Formatos web e tipos de saída compatíveis

Tipo de entrada ou documento	Operações disponíveis
HTML e XHTML	Analisar, criar, editar, navegar, combinar, converter e renderizar
MHTML e MHT	Carregar, converter, renderizar e combinar arquivos, além de criar arquivos atualizados
EPUB	Carregar publicações, combinar conteúdo e renderizar em formatos de layout fixo ou imagem
Markdown	Analisar, criar, editar, converter em HTML e renderizar por meio de um documento HTML
SVG	Carregar, inspecionar, editar e converter conteúdo vetorial

Dependendo do formato de origem, os fluxos de conversão podem gerar arquivos PDF, XPS, DOCX, TIFF, PNG, JPEG, BMP e GIF. Consulte Converting Between Formats para escolher o método correto da classe Converter e a classe de opções de salvamento adequada.

Classes da API HTML e recursos para desenvolvedores

HTMLDocument representa um documento HTML carregado ou recém-criado e fornece acesso ao DOM.
QuerySelector() e QuerySelectorAll() localizam elementos com seletores CSS.
Converter fornece métodos estáticos para converter HTML, XHTML, MHTML, EPUB, Markdown e SVG.
PdfSaveOptions , DocSaveOptions, ImageSaveOptions e XpsSaveOptions configuram a saída de cada formato.

Comece por Getting Started , consulte a Aspose.HTML for .NET API Reference completa ou teste os exemplos executáveis no repositório do Aspose.HTML for .NET no GitHub .

Perguntas frequentes

1. O que posso fazer com um documento HTML em C# depois de carregá-lo?

Depois de carregar o HTML em um HTMLDocument, você pode inspecionar o DOM, localizar elementos com seletores CSS ou XPath, alterar conteúdo e atributos, adicionar ou remover nós e salvar ou converter o documento atualizado.

2. Posso modificar o HTML antes de convertê-lo em PDF ou imagem?

Sim. Carregue a origem em um HTMLDocument, modifique o DOM, o CSS ou o conteúdo vinculado e passe o documento atualizado para o método de conversão necessário. O arquivo PDF, XPS, DOCX ou de imagem gerado refletirá essas alterações.

3. Como as URLs relativas de CSS, imagens e fontes são resolvidas ao carregar HTML?

As URLs relativas dos recursos são resolvidas em relação ao endereço do documento ou à URL base informada ao carregar o HTML. Uma URL base correta é especialmente importante quando a marcação vem de uma string ou stream e referencia recursos externos.

4. Qual método de API devo usar para converter HTML, MHTML, EPUB, Markdown ou SVG?

Use o método da classe Converter correspondente ao formato de origem, como ConvertHTML(), ConvertMHTML(), ConvertEPUB(), ConvertMarkdown() ou ConvertSVG(). A classe de opções de salvamento determina o formato de saída e as configurações da conversão.