Criar arquivos HTML em C#

Criar um documento HTML com uma API .NET

Aspose.HTML for .NET cria um novo HTMLDocument com uma árvore de documento HTML que a aplicação pode preencher por meio da API DOM. Crie elementos, defina texto e atributos, adicione-os ao documento e chame Save() para gravar o arquivo HTML concluído.

Criar e salvar um arquivo HTML em C#

O exemplo a seguir cria um documento, define seu título, adiciona um cabeçalho, um parágrafo e um link ao elemento <body> e salva o resultado como created.html.

using Aspose.Html;

using HTMLDocument document = new HTMLDocument();

document.Title = "Product overview";

// Create the visible page elements
HTMLHeadingElement heading =
    (HTMLHeadingElement)document.CreateElement("h1");
heading.TextContent = "Product overview";

HTMLParagraphElement paragraph =
    (HTMLParagraphElement)document.CreateElement("p");
paragraph.TextContent = "Explore the product documentation and examples.";

HTMLAnchorElement link =
    (HTMLAnchorElement)document.CreateElement("a");
link.Href = "https://docs.aspose.com/html/net/";
link.TextContent = "Read the documentation";

// Add the elements in document order
document.Body.AppendChild(heading);
document.Body.AppendChild(paragraph);
document.Body.AppendChild(link);

// Save the completed HTML document
document.Save("created.html");

Etapas para criar um arquivo HTML em C#

1. Instancie HTMLDocument sem uma origem para criar um novo documento.
2. Defina dados do documento, como o título da página por meio de Title.
3. Crie os nós necessários com CreateElement() e defina texto, propriedades e atributos.
4. Anexe os elementos a Body ou a outro nó pai com AppendChild() .
5. Grave o documento concluído com Save() .

Recursos para criar documentos HTML

• Começar com uma árvore de documento. Um novo HTMLDocument fornece a estrutura, incluindo Head e Body, para que o código adicione conteúdo ao local correto.
• Criar elementos HTML tipados. CreateElement() produz nós DOM que podem ser convertidos em classes como HTMLHeadingElement, HTMLParagraphElement e HTMLAnchorElement quando propriedades específicas forem úteis.
• Adicionar texto ou marcação de forma controlada. Use TextContent para texto simples. Use métodos DOM ou InnerHTML apenas quando a aplicação fornecer marcação intencionalmente e valide marcação de fontes não confiáveis.
• Definir atributos e relações. Configure links, classes, IDs, endereços de recursos, metadados e outros dados antes de anexar cada nó à árvore.
• Salvar ou continuar o processamento. Salve o documento como HTML, modifique-o com consultas DOM ou encaminhe-o a um fluxo de conversão quando precisar de PDF, DOCX, XPS ou imagem.

Documentação e referência da API para criar HTML

Leia Criar ou carregar documentos HTML para obter exemplos de documento vazio, construção a partir de marcação e escolha de uma URL base. O guia Editar documento HTML explica como criar, inserir, substituir e remover nós DOM. Se a aplicação já tiver um arquivo, URL, string ou stream como origem, use o fluxo Carregar HTML em C# .

Instalar o Aspose.HTML for .NET

Instale o Aspose.HTML for .NET pelo NuGet usando a CLI do .NET:

dotnet add package Aspose.HTML

Você também pode usar a interface do Gerenciador de Pacotes NuGet ou executar Install-Package Aspose.HTML no Console do Gerenciador de Pacotes. Consulte o guia de instalação para configurar a biblioteca ou solicite uma licença temporária para avaliar a API sem limitações.

Perguntas frequentes sobre a criação de documentos HTML

1. Posso converter um novo HTMLDocument sem salvá-lo primeiro?

Sim. Passe o documento em memória para a sobrecarga apropriada de Converter.ConvertHTML() com as opções de salvamento necessárias e um caminho ou stream de saída. Não é preciso salvar um arquivo HTML intermediário.

2. Um novo HTMLDocument inclui os elementos <html>, <head> e <body>?

Sim. O construtor sem parâmetros cria a estrutura HTML básica. Adicione metadados e recursos do documento a Head e o conteúdo visível da página a Body.

3. O método CreateElement() adiciona automaticamente o novo elemento ao documento?

Não. CreateElement() cria um nó separado. Chame AppendChild(), InsertBefore() ou outro método de inserção DOM para posicioná-lo em Head, Body ou em um elemento existente.

4. Devo criar um novo documento quando a marcação HTML completa já está em uma string?

Use um construtor de HTMLDocument que aceite a marcação e uma URL base. A URL base resolve links e recursos relativos, enquanto o construtor analisa a marcação fornecida e cria o DOM.

5. O HTML gerado pode fazer referência a CSS, imagens, scripts e fontes?

Sim. Crie os elementos HTML correspondentes e defina as URLs ou os atributos dos recursos. Verifique se as referências relativas são válidas no local onde o arquivo HTML e os recursos relacionados serão implantados.