C# 使用 WebBrowser 实现 HTML 转图片功能

Posted 2021-04-04 码农很忙

在 .NET 平台上，我们有多种方式可以将一段 html 文本转换为一张图片：HTML Renderer、SelectPdf 、Aspose.Html 等。

在 WinForm 程序中，每一个 System.Windows.Forms.Control 的派生类型均包含一个名为 DrawToBitmap 的方法，该方法可以将控件绘制到一张图片上。WebBrowser 具备显示 HTML 的功能，又因为其从 Control 类型派生，所以包含 DrawToBitmap 方法。我们只需将要在 WebBrowser 上加载要展示的 HTML 并在其 DocumentCompleted 事件中绘制图片即可：

public static async Task<Image> HtmlToImage(String html, int width = 1024, int height = 768){
 var taskCompletionSource = new TaskCompletionSource<Image>();
 var thread = new Thread(() =>
 {
 using var browser = new WebBrowser
 {
 Width = width,
 Height = height,
 ScrollBarsEnabled = false
 };
 browser.DocumentCompleted += (s, e) =>
 {
 var b = s as WebBrowser;
 if (b == null)
 {
 return;
 }
 var bmp = new Bitmap(b.Width, b.Height);
 b.DrawToBitmap(bmp, new Rectangle(0, 0, b.Width, b.Height));
 taskCompletionSource.SetResult(bmp);
 Application.ExitThread();
 };
 browser.DocumentText = html;
 Application.Run();
 });
 thread.SetApartmentState(ApartmentState.STA);
 thread.Start();
 return await taskCompletionSource.Task;}

以上代码参考了：Stack Overflow ，笔者将其改造为异步方法并增加了必要的释放功能。在 LINQPad 中测试效果如下：

该方式的优点：

1. 简单易用。

2. 支持最新的 .NET Core 环境。

3. 无需引用第三方类库，没有版权和安全性风险，安全且免费。

4. 支持从互联网上加载内容。

该方式的缺点：

1. 虽然支持 .NET Core ，但以上代码不能跨平台使用。

2. WebBrowser 控件基于 IE 浏览器并受宿主操作系统影响，要求被呈现的网页具备较高的兼容性。

使用 IE8+ 版本进行渲染

笔者在实际工作中使用到了部分 CSS3 属性，默认情况下 WebBrowser 使用低版本的 IE 浏览器渲染网页，这会导致部分网页效果不生效，比如隔行变色效果。除了修改注册表，我们仍可以通过在网页中加入 meta 标签的方式告知 WebBrowser 使用高版本的 IE 浏览器进行渲染，仅需将以下代码复制至 HTML 的 head 标签内即可：

<meta http-equiv="X-UA-Compatible" content="IE=edge"/>