使用 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 图像的基本步骤
- 使用
HTMLDocument构造函数加载源文件、URL、字符串或流,并在需要解析相对资源时提供正确的基址。 - 使用
QuerySelector()查找一个图像,或使用QuerySelectorAll()获取多个匹配项。 - 根据所需任务创建、更新、删除或检查选定的图像元素。
- 当需要复制、下载、嵌入、优化或删除文件时,单独处理引用的图像资源。
- 调用
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 编辑、转换或可访问性测试功能。