使用 C# 管理 HTML 图像

通过 HTML DOM 和资源 API 添加、更新、删除、调整大小或提取图像。

适用于 .NET 的 HTML 图像管理 API

Aspose.HTML for .NET 提供 DOM 和资源 API,用于处理 HTML 文档引用的图像。C# 应用程序可以创建或更新 HTMLImageElement ,使用 CSS 选择器查找图像元素,将其从 DOM 中删除,解析引用资源的位置,并保存修改后的 HTML。


选择 HTML 图像处理任务

  • 向 HTML 添加图像 。 创建 <img> 元素,设置图像源、替代文本、尺寸和可选的现代属性,然后将其插入所需的 DOM 位置。
  • 从 HTML 提取图像 。 查找图像引用,根据文档基址解析相对 URL,并保存支持的本地、远程或嵌入资源。
  • 从 HTML 删除图像 。 从 DOM 中删除选定的 <img> 元素,并区分删除标记与删除实际图像文件或 CSS 背景资源。
  • 调整 HTML 图像大小 。 设置显示图像的固有尺寸和响应式 CSS,而不对引用的源文件进行重采样。

使用 C# 更新现有 HTML 图像

此示例加载 HTML 文件,按 ID 选择现有图像,更改引用资源和替代文本,设置固有尺寸,然后保存更新后的文档。图像文件必须在分配给 Src 的路径中保持可用。

更新图像元素的 C# 代码

using Aspose.Html;

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

// Select and update the existing image element
HTMLImageElement image =  document.QuerySelector("#product-image") as HTMLImageElement;

if (image != null)
{
    image.Src = "images/updated-product.webp";
    image.Alt = "Updated product shown from the front";
    image.SetAttribute("width", "960");
    image.SetAttribute("height", "640");
}

// Save the modified HTML document
document.Save("output.html");

管理 HTML 图像的基本步骤

  1. 使用 HTMLDocument 构造函数加载源文件、URL、字符串或流,并在需要解析相对资源时提供正确的基址。
  2. 使用 QuerySelector() 查找一个图像,或使用 QuerySelectorAll() 获取多个匹配项。
  3. 根据所需任务创建、更新、删除或检查选定的图像元素。
  4. 当需要复制、下载、嵌入、优化或删除文件时,单独处理引用的图像资源。
  5. 调用 Save() 写入标记更改;如果需要将 HTML 呈现为 PDF 或图像格式,请继续执行转换任务。

HTML 图像元素、来源与资源

  • 图像属性。 读取或更新 src、alt、width、height、loading、decoding、srcset、sizes 以及目标标记支持的其他属性。
  • DOM 位置。 将图像添加到文档正文或选定容器,移动到其他父元素,替换图像,或从文档树中删除。
  • 资源位置。 在考虑文档基址的情况下处理相对路径、绝对 HTTP 或 HTTPS URL、文件 URL 和嵌入式数据 URI。
  • 元素选择。 使用 ID、类、属性选择器、结构选择器、XPath 或 DOM 遍历来定位一个图像或图像集合。
  • 显示尺寸。 将固有 width 和 height 值与 CSS 结合,实现固定或响应式布局。
  • 非 img 图像。 CSS 背景图像、SVG 内容、<picture> 源、网站图标和图像输入使用不同的元素或样式规则,需要单独的选择逻辑。
  • 输出 API。 如果需要将完整的呈现页面保存为 PNG、JPEG、TIFF 或其他支持的格式,请将准备好的文档传递给转换任务。



HTML 图像文档和 API 参考

有关 <img> 元素、嵌入数据和 CSS 背景图像的示例,请参阅 How to Add Image to HTML 。 Working with HTML Documents 介绍文档加载、编辑、保存和资源处理。有关图像属性和继承的 DOM 方法,请参阅 HTMLImageElement 参考。



安装 Aspose.HTML for .NET

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

dotnet add package Aspose.HTML

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



HTML 图像管理常见问题

1. Aspose.HTML 可以编辑 PNG 或 JPEG 文件中的像素吗?

不可以。图像管理操作会更新 HTML 元素、属性、样式和引用资源。重采样、裁剪、压缩和像素级编辑需要单独的图像处理步骤。


2. 处理 HTML 时如何解析图像的相对路径?

相对 src 值根据文档基址解析,该基址通常来自加载的文件或 URL 的位置。通过字符串或流创建 HTML 时,如果应用程序需要正确解析相对资源路径,请提供基准 URL。


3. 从 HTML 提取图像与将 HTML 转换为图像相同吗?

不同。提取操作保存元素或样式引用的资源,例如 <img> 元素使用的 JPEG。 HTML 到图像转换 会将完整页面布局呈现为新的光栅图像。

探索更多 Aspose.HTML for .NET 功能

继续使用图像元素生成、HTML 编辑、转换或可访问性测试功能。