当前位置：首页 > article >正文

C# 将HTML文档、HTML字符串转换为图片

article 2025/8/23 20:50:44

在.NET开发中，将HTML内容转换为图片的需求广泛存在于报告生成、邮件内容存档、网页快照等场景。Free Spire.Doc for .NET作为一款免费的专业文档处理库，无需Microsoft Word依赖，即可轻松实现这一功能。本文将深入解析HTML文档和字符串转图片两种场景的转换方案！

文章目录

- Free Spire.Doc 简介
- 场景1：通过C#将HTML文件转换为PNG图片（完整示例）
- 场景2：通过C#将HTML字符串转换为JPG图片（动态内容处理）
- 将HTML转换为其他图片格式
- 结论

Free Spire.Doc 简介

核心优势：
• ✅ 100%免费：社区版可免费用于个人和商业用途（有页数限制）
• 🚀 零依赖：无需安装Microsoft Office
• 📁 高质量输出：支持PNG/JPEG/BMP等主流格式
• ⚙️ 简单API，几行代码即可完成转换

安装：
通过NuGet安装Free Spire.Doc

Install-Package FreeSpire.Doc

场景1：通过C#将HTML文件转换为PNG图片（完整示例）

以下是将本地 HTML 文档转换为 PNG 图片的完整代码示例：

using Spire.Doc;
using Spire.Doc.Documents;
using System.Drawing;
using System.Drawing.Imaging;namespace ConvertHtmlFileToPng
{class Program{static void Main(string[] args){// 将HTML文件加载到Document对象中Document document = new Document();document.LoadFromFile("示例.html", FileFormat.Html, XHTMLValidationType.None);// 将HTML文件转换为图片Image[] images = document.SaveToImages(ImageType.Bitmap);// 将图片保存为PNG格式for (int index = 0; index < images.Length; index++){images[index].Save("图片\\图_{0}.png", ImageFormat.Png);}// 释放资源document.Dispose();}}
}

代码解析:

加载文档：使用 LoadFromFile 方法加载 HTML 文件，指定格式为 FileFormat.Html；
转换处理：通过 SaveToImages() 方法将HTML文件转换为图片，转换结果以 Image[] 数组形式返回，适合处理多页文档；
图片处理：使用 ImageFormat 指定输出格式；
资源管理：最后调用了 Dispose() 方法释放文档对象资源。

效果图：
HTML文件转图片

场景2：通过C#将HTML字符串转换为JPG图片（动态内容处理）

如果需要将动态生成的 HTML 字符串（如从数据库或 API 获取的内容）转换为图片，可使用以下代码：

using Spire.Doc;
using Spire.Doc.Documents;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;namespace ConvertHtmlStringToPng
{class Program{static void Main(string[] args){// 创建HTML字符串（示例）string htmlString = @"<html><head><style>body { font-family: Arial, sans-serif; margin: 20px; }.title { color: #333; font-size: 24px; font-weight: bold; }.content { color: #666; margin-top: 10px; }</style></head><body><div class=""title"">HTML字符串转换示例</div><div class=""content"">这是一段通过Free Spire.Doc转换为图片的HTML内容。</div></body></html>";// 创建Word文档Document document = new Document();// 将Html字符串添加到Word中Paragraph paragraph = document.AddSection().AddParagraph();paragraph.AppendHTML(htmlString);// 将Html字符转换为图片（此处假设HTML内容为单页，如需分页可参考上文逻辑）Image images = document.SaveToImages(0, ImageType.Bitmap);images.Save("HTML字符串转图片.jpg", ImageFormat.Jpeg);// 释放资源document.Dispose();}}
}

简单示例图：
HTML字符串转图片

注意事项：

HTML 格式规范：确保 HTML 字符串包含完整的 <html>、<head>、<body>等标签，否则可能导致样式解析失败；
样式支持：Free Spire.Doc 支持大部分 CSS 样式，但复杂动画或 JavaScript 效果可能无法完全渲染（因其不依赖浏览器引擎）；
中文显示：若 HTML 包含中文，需确保运行环境已安装相应字体（或在 CSS 中指定通用字体如 font-family: ""Microsoft YaHei"", sans-serif;）。