使用 .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 文件的步骤
- 在不指定数据源的情况下实例化
HTMLDocument,以创建新文档。 - 设置文档级数据,例如通过
Title设置页面标题。 - 使用
CreateElement()创建所需节点,然后设置其文本、属性和特性。 - 使用
AppendChild()将元素添加到Body或其他父节点。 - 使用
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 文件及其相关资源的部署位置有效。