使用 .NET API 创建 HTML 文档

Aspose.HTML for .NET 创建新的 HTMLDocument ,其中包含可由应用程序通过 DOM API 构建的 HTML 文档树。创建元素、设置文本和属性、将元素添加到文档,然后调用 Save() 写入完成的 HTML 文件。


在 C# 中创建并保存 HTML 文件

以下示例创建文档并设置标题,将标题元素、段落和链接添加到 <body>,然后将结果保存为 created.html。

创建 HTML 文档的 C# 代码

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");

在 C# 中创建 HTML 文件的步骤

  1. 在不指定数据源的情况下实例化 HTMLDocument ,以创建新文档。
  2. 设置文档级数据,例如通过 Title 设置页面标题。
  3. 使用 CreateElement() 创建所需节点,然后设置其文本、属性和特性。
  4. 使用 AppendChild() 将元素添加到 Body 或其他父节点。
  5. 使用 Save() 写入完成的文档。

HTML 文档创建功能

  • 从文档树开始。 新的 HTMLDocument 提供包括 Head 和 Body 在内的文档结构,以便代码将内容添加到正确的位置。
  • 创建强类型 HTML 元素。 CreateElement() 生成 DOM 节点。当需要元素特定属性时,可将节点转换为 HTMLHeadingElement、HTMLParagraphElement 和 HTMLAnchorElement 等类。
  • 有目的地添加文本或标记。 纯文本应使用 TextContent。只有当应用程序明确提供标记时才使用 DOM 方法或 InnerHTML,并验证来自不可信数据源的标记。
  • 设置属性和关系。 将每个节点添加到文档树之前,请配置链接、类、ID、资源地址、元数据和其他元素数据。
  • 保存或继续处理。 将文档保存为 HTML,使用 DOM 查询继续修改,或者在需要 PDF、DOCX、XPS 或图像时将其传给转换工作流程。

HTML 创建文档和 API 参考

阅读 创建或加载 HTML 文档 ,了解创建空文档、从标记构建文档以及选择基准 URL 的示例。 编辑 HTML 文档 指南介绍如何创建、插入、替换和删除 DOM 节点。如果应用程序已有文件、URL、字符串或流作为数据源,请改用 在 C# 中加载 HTML 工作流程。


安装 Aspose.HTML for .NET

使用 .NET CLI 从 NuGet 安装 Aspose.HTML for .NET :

dotnet add package Aspose.HTML

您也可以使用 NuGet 包管理器界面,或在包管理器控制台中运行 Install-Package Aspose.HTML。有关配置详情,请参阅 安装指南 ;如需不受评估版限制地测试 API,请申请 临时许可证 。


HTML 文档创建常见问题

1. 可以转换新创建的 HTMLDocument 而不先保存吗?

可以。将内存中的文档连同所需保存选项以及输出路径或流传给适用的 Converter.ConvertHTML() 重载。无需保存中间 HTML 文件。

2. 新的 HTMLDocument 是否包含 <html>、<head> 和 <body> 元素?

是。无参数构造函数会创建基本 HTML 文档结构。将元数据和文档级资源添加到 Head,并将可见的页面内容添加到 Body。

3. 方法 CreateElement() 是否会自动将新元素添加到文档?

否。CreateElement() 创建一个尚未连接的节点。调用 AppendChild()、InsertBefore() 或其他 DOM 插入方法,将该节点放入 Head、Body 或现有元素中。

4. 如果完整的 HTML 标记已经在字符串中,是否还应创建新文档?

使用接受标记和基准 URL 的 HTMLDocument 构造函数。基准 URL 用于解析相对链接和资源,构造函数则将提供的标记解析为 DOM。

5. 生成的 HTML 能否引用 CSS、图片、脚本和字体?

可以。创建相应的 HTML 元素并设置资源 URL 或属性。请确保相对引用对于 HTML 文件及其相关资源的部署位置有效。

相关 HTML 文档工作流程

继续加载、编辑、选择或转换 HTML 内容。