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

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

文章目录

- [Free Spire.Doc 简介](#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 图片的完整代码示例：

csharp 复制代码

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() 方法释放文档对象资源。

效果图：

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

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

csharp 复制代码

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

将HTML转换为其他图片格式

若需将 HTML 转换为 JPG、BMP、GIF 等其他图片格式，只需修改 Image.Save 方法中的 ImageFormat 参数即可。

参考: https://learn.microsoft.com/en-us/dotnet/api/system.drawing.imaging.imageformat

结论

Free Spire.Doc for .NET 为.NET 开发者提供了简单高效的 HTML 转图片的解决方案，无论是本地 HTML 文档还是动态生成的 HTML 字符串，均可通过简单代码完成转换。其免费版满足基础需求，如需去除页数限制，体验更多高级功能，则申请一个月试用授权完整体验商业版。