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

news2025/6/2 19:29:05

在.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;）。